在 DokuWiki 中设置侧边栏(sidebar)通常涉及安装和使用插件以及配置相关页面。以下是一个详细的步骤指南:
一、安装必要的插件
indexmenu 插件:
这是一个常用的目录插件,可以帮助你在侧边栏中显示页面的层次结构。
-
下载后,解压并将插件文件夹放到 DokuWiki 的 lib/plugins/ 目录下。
刷新 DokuWiki 的管理页面,在扩展管理器中启用该插件。
addnewpage 插件(可选):
这个插件允许你在侧边栏中添加一个“新建页面”的链接,方便用户快速创建新页面。
同样,从官方插件页面下载并安装该插件。
二、创建侧边栏页面
创建 sidebar 页面:
在 DokuWiki 中,侧边栏的内容通常存储在一个名为 sidebar 的页面中(文件名可能因配置而异,但默认为 sidebar)。
-
编辑 sidebar 页面:
在 sidebar 页面中,你可以使用 DokuWiki 的语法和插件来定义侧边栏的内容。
例如,使用 indexmenu 插件的语法来显示页面的目录树:
-
这行代码将显示当前命名空间下的一级子页面作为侧边栏的目录树。
添加其他内容:
除了目录树,你还可以在侧边栏中添加其他内容,如链接、标签云等。
使用
newpage 语法可以添加一个“新建页面”的链接(如果安装了 addnewpage 插件)。
使用 ~~TAGCLOUD[showCount]:50~~ 语法可以显示一个包含最多 50 个标签的标签云。
三、配置和美化侧边栏
配置插件:
在 DokuWiki 的管理页面中,你可以找到插件的配置选项,并根据需要进行调整。
例如,对于 indexmenu 插件,你可以配置它显示哪些命名空间、是否使用 JavaScript 渲染等。
美化侧边栏:
你可以通过修改 DokuWiki 的模板文件或样式表(CSS)来美化侧边栏的外观。
通常,这些文件位于 DokuWiki 的 lib/tpl/ 目录下。
你可以添加自定义的
CSS 规则来更改侧边栏的字体、颜色、边距等属性。
调整显示宽度:
如果侧边栏太宽或太窄,你可以通过修改样式表来调整其宽度。
打开 DokuWiki 模板的样式表文件(如 style.ini),并找到与侧边栏宽度相关的设置进行调整。
四、测试和保存
测试侧边栏:
在进行任何更改后,记得刷新你的 DokuWiki 页面以查看侧边栏的效果。
确保所有链接和插件都正常工作。
保存更改:
在编辑完 sidebar 页面或进行其他配置后,确保保存你的更改。
对于 sidebar 页面,你可以直接点击保存按钮。
对于插件配置,你可能需要在管理页面中点击相应的保存或应用按钮。
通过以上步骤,你应该能够在 DokuWiki 中成功设置和自定义侧边栏。