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

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

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

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

1 问题

一级标题2和一级标题3下面少生成了目录。我设置的一级标题是”h2″,二级标题是”h3″,因为我觉得h1太大

https://img2018.cnblogs.com/blog/1201453/201812/1201453-20181228094111321-1403645166.png

比如,我有h3标题的”2.5 显示器”,却没有最终生成

https://img2018.cnblogs.com/blog/1201453/201812/1201453-20181228094219249-1550707820.png

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开始处打上断点

https://img2018.cnblogs.com/blog/1201453/201812/1201453-20181228094617852-438013424.png

我们重点查看h2_list和h3_list是否正常,可以看到三个一级标题,没有问题

https://img2018.cnblogs.com/blog/1201453/201812/1201453-20181228094751336-754557182.png

 

 可以看到h3_list只生成了4个

https://img2018.cnblogs.com/blog/1201453/201812/1201453-20181228095018148-1655485250.png

 

 最后一个是”2.4 硬盘”

https://img2018.cnblogs.com/blog/1201453/201812/1201453-20181228095045481-1189654706.png

2.4和2.5都没有生成

2.2 查看源码格式

https://img2018.cnblogs.com/blog/1201453/201812/1201453-20181228100804530-1801126015.png

 

我把https://www.cnblogs.com/Java-Starter/p/10165698.html复制到VSCode中,用alt+shift+f对源码进行格式化

终于找到了原因,正常生成二级标签的h3都是同级,而”2.5 显示器”存在于h3兄弟结点div的子节点中

https://img2018.cnblogs.com/blog/1201453/201812/1201453-20181228095543417-1024005828.png

仔细观察”2.5 显示器”缩进了一格

https://img2018.cnblogs.com/blog/1201453/201812/1201453-20181228095822598-1121752260.png

2.3 原因总结

我在写原创文章的时候,没有遇到过目录生成失败,这篇出问题的博文,我有一些内容从知乎等第三方网站复制进来,html结构受到了破坏,然而博客园不能自动检测到

页脚代码是没有问题的,因为格式的错误,导致页脚代码找不到同级目录的h3标签

var h3_list = $(h2_list[i]).nextAll(“h3”);
nextAll()是查找div 之后的所有类名,并为他们添加类名
就是说只能找同级目录下的h3,兄弟结点的子节点是找不到的

3.解决方案

在博客园编辑页面中,点击HTML,https://img2018.cnblogs.com/blog/1201453/201812/1201453-20181228100345944-444897601.png,再将多余的div删除掉,不要忘了结尾的</div>也要删掉,目录就可以正常生成

https://img2018.cnblogs.com/blog/1201453/201812/1201453-20181228101122916-1340532769.png

https://img2018.cnblogs.com/blog/1201453/201812/1201453-20181228103936670-708819604.png

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

没有标签
首页      开发      cnblogs      博客园自动产生二级目录失败的原因和解决方法

yuruoyuxi

博客园自动产生二级目录失败的原因和解决方法
经常写博客的都知道,写长文章时提供清晰的目录可以让读者高效率地阅读 这里我遇到了目录二级目录无法生成的情况,或者说只能生成部分二级目录 我在百度上搜索不到相关的解决方案,博客…
扫描二维码继续阅读
2018-12-25
Categories