dokuwiki样式修改--将文章目录转移到侧边栏

本文介绍了如何修改DokuWiki的原生主题和Bootstrap3主题，将自动生成的文章目录移动到右侧边栏，并实现目录的固定浮动效果。主要涉及对main.php、Template.php和sidebar.php文件的修改，包括删除文章区域的目录，将目录添加到右侧边栏以及在CSS中添加affix类以实现浮动效果。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

dokuwiki自动生成的文章目录，在文章区域内，想将其调整到侧边栏且固定浮动。

一、原生主题修改

dokuwiki自带生成文章目录，但是是在文章区域内。dokuwiki官方网址https://www.dokuwiki.org/zh:devel:templates内描述了修改目录指向的方法。

二、Bootstrap3主题修改

我这里使用的是Bootstrap3主题，该主题支持扩展右侧边栏功能。开启右侧边栏功能，默认为rightsidebar。

修改内容涉及dokuwiki/lib/tpl/bootstrap3/main.php、dokuwiki/lib/tpl/bootstrap3/Template.php、dokuwiki/lib/tpl/bootstrap3/tpl/sidebar.php这3个文件

1.将toc从文章模块中删除。

修改dokuwiki/lib/tpl/bootstrap3/main.php文件

在<div class=”page”>内删除if ($toc ) echo $toc;

2.将toc转移到右侧边

在dokuwiki/lib/tpl/bootstrap3/tpl/sidebar.php的<div class="dw-sidebar-body collapse in small">中新增

 <?php

$toc = $TPL->getTOC(true);

   if($sidebar_id == 'dokuwiki__rightaside') echo $toc;

?>

注意，dokuwiki__rightaside中为两条下划线。

3.将toc固定到页面浮动

在dokuwiki/lib/tpl/bootstrap3/Template.php中，修改function renderTOC().

在id为dw__toc的class里面新增affix,修改后为

$out .= '<nav id="dw__toc" role="navigation" class="toc-panel panel panel-default small affix">' . DOKU_LF;

修改后即将文章目录调整到右侧边栏，且能够固定浮动。