在 DokuWiki 中设置侧边栏(sidebar)通常涉及安装和使用插件以及配置相关页面。以下是一个详细的步骤指南:
- 一、安装必要的插件
- indexmenu 插件:
- 这是一个常用的目录插件,可以帮助你在侧边栏中显示页面的层次结构。
- 你可以从 DokuWiki 的官方插件页面(https://www.dokuwiki.org/plugin:indexmenu)下载该插件。
- 下载后,解压并将插件文件夹放到 DokuWiki 的 lib/plugins/ 目录下。
- 刷新 DokuWiki 的管理页面,在扩展管理器中启用该插件。
- addnewpage 插件(可选):
- 这个插件允许你在侧边栏中添加一个“新建页面”的链接,方便用户快速创建新页面。
- 同样,从官方插件页面下载并安装该插件。
- 二、创建侧边栏页面
- 创建 sidebar 页面:
- 在 DokuWiki 中,侧边栏的内容通常存储在一个名为 sidebar 的页面中(文件名可能因配置而异,但默认为 sidebar)。
- 你可以通过访问类似 http://your-wiki-domain/doku.php?id=sidebar 的 URL 来创建或编辑这个页面(将 your-wiki-domain 替换为你的 DokuWiki 域名)。
- 编辑 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 中成功设置和自定义侧边栏。