博客园自动产生二级目录失败的原因和解决方法
经常写博客的都知道,写长文章时提供清晰的目录可以让读者高效率地阅读
这里我遇到了目录二级目录无法生成的情况,或者说只能生成部分二级目录
我在百度上搜索不到相关的解决方案,博客园站内搜索也找不到,所以特此记录下,提醒自己与园友
1 问题
一级标题2和一级标题3下面少生成了目录。我设置的一级标题是"h2",二级标题是"h3",因为我觉得h1太大
比如,我有h3标题的"2.5 显示器",却没有最终生成
2 原因
我用的页脚html,即博客园流传最广的页脚代码,我不大相信其会有问题
<script language="javascript" type="text/javascript"> // 生成目录索引列表 // ref: http://www.cnblogs.com/wangqiguo/p/4355032.html // modified by: zzq function GenerateContentList() { var mainContent = $('#cnblogs_post_body'); var h2_list = $('#cnblogs_post_body h2');//如果你的章节标题不是h2,只需要将这里的h2换掉即可 if(mainContent.length < 1) return; if(h2_list.length>0) { var content = '<a name="_labelTop"></a>'; content += '<div id="navCategory">'; content += '<p style="font-size:18px"><b>目录</b></p>'; content += '<ul>'; for(var i=0; i<h2_list.length; i++) { var go_to_top = '<div style="text-align: right"><a href="#_labelTop">回到顶部</a><a name="_label' + i + '"></a></div>'; $(h2_list[i]).before(go_to_top); var h3_list = $(h2_list[i]).nextAll("h3"); var li3_content = ''; for(var j=0; j<h3_list.length; j++) { var tmp = $(h3_list[j]).prevAll('h2').first(); if(!tmp.is(h2_list[i])) break; var li3_anchor = '<a name="_label' + i + '_' + j + '"></a>'; $(h3_list[j]).before(li3_anchor); li3_content += '<li><a href="#_label' + i + '_' + j + '">' + $(h3_list[j]).text() + '</a></li>'; } var li2_content = ''; if(li3_content.length > 0) li2_content = '<li><a href="#_label' + i + '">' + $(h2_list[i]).text() + '</a><ul>' + li3_content + '</ul></li>'; else li2_content = '<li><a href="#_label' + i + '">' + $(h2_list[i]).text() + '</a></li>'; content += li2_content; } content += '</ul>'; content += '</div><p> </p>'; content += '<p style="font-size:18px"><b>正文</b></p>'; if($('#cnblogs_post_body').length != 0 ) { $($('#cnblogs_post_body')[0]).prepend(content); } } var qqinfo = '<p style="color:navy;font-size:12px">讨论QQ群:135202158</p>'; $(mainContent[0]).prepend(qqinfo); } GenerateContentList(); </script>
2.1 断点调试
上来先打断点。在页脚html开始处打上断点
我们重点查看h2_list和h3_list是否正常,可以看到三个一级标题,没有问题
可以看到h3_list只生成了4个
最后一个是"2.4 硬盘"
2.4和2.5都没有生成
2.2 查看源码格式
我把https://www.cnblogs.com/Java-Starter/p/10165698.html复制到VSCode中,用alt+shift+f对源码进行格式化
终于找到了原因,正常生成二级标签的h3都是同级,而"2.5 显示器"存在于h3兄弟结点div的子节点中
仔细观察"2.5 显示器"缩进了一格
2.3 原因总结
我在写原创文章的时候,没有遇到过目录生成失败,这篇出问题的博文,我有一些内容从知乎等第三方网站复制进来,html结构受到了破坏,然而博客园不能自动检测到
页脚代码是没有问题的,因为格式的错误,导致页脚代码找不到同级目录的h3标签
3.解决方案
在博客园编辑页面中,点击HTML,,再将多余的div删除掉,不要忘了结尾的</div>也要删掉,目录就可以正常生成
最好的解决方法就是多些原创少点复制,就没这些问题了