博客园自动产生二级目录失败的原因和解决方法

经常写博客的都知道，写长文章时提供清晰的目录可以让读者高效率地阅读

这里我遇到了目录二级目录无法生成的情况，或者说只能生成部分二级目录

我在百度上搜索不到相关的解决方案，博客园站内搜索也找不到，所以特此记录下，提醒自己与园友

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>&nbsp;</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标签

var h3_list = $(h2_list[i]).nextAll("h3");

nextAll()是查找div 之后的所有类名，并为他们添加类名

就是说只能找同级目录下的h3，兄弟结点的子节点是找不到的

3.解决方案

在博客园编辑页面中，点击HTML,，再将多余的div删除掉，不要忘了结尾的</div>也要删掉，目录就可以正常生成

最好的解决方法就是多些原创少点复制，就没这些问题了