DokuWiki 插件集及如何使用笔记

首先,DokuWiki 的名字来自于“Doku” + “Wiki”，“Doku” 是德文中 “Dokumentationen” 的缩写，也就是英文的 “Documentation” ——“文件”的意思。

DokuWiki 主页：https://www.dokuwiki.org/start?id=zh:dokuwiki

DokuWiki 语法：zh:wiki:syntax [DokuWiki]

在Windows上安装dokuwiki其实很简单，DokuWiki下载页面 勾选包括网络服务器、热门插件全选、语言可以只选英文和中文。然后点下载即可。

使用的话，主要是dokuwiki的语法，此语法涵盖书写与插件的使用。具体细节看插件的使用说明与dokuwiki语法的介绍。

创建页面

更改doku链接的id值为“新页面”，回车，即可看见正中的“该主题尚不存在”，此时，点击右侧的铅笔。

然后进入富文本编写页面，可以使用dokuwiki自带的语法进行编写，也可以使用工具栏设置格式。

删除页面

清空页面内容并保存即可。

重命名页面

安装move插件，在右边【编辑本页】按钮的工具栏中会显示【页面重命名】。

创建命名空间

命名空间其实就是dokuwiki的dokuwiki/data/pages下建立的目录，如果你不使用命名空间.那么你所有建立的页面都到保存在dokuwiki/data/pages下,变得非常难以管理。

根目录指的是dokuwiki/data/pages的路径为根目录。所有页面中创建目录和文档都会保存到这里面.

例如，想要创建"项目"这样的命名空间，id改为命名空间:页面名这样的值，就可以创建新页面了。可以看到在网站地图中的索引，项目命名空间。

删除命名空间

如果该命名空间（该目录）下有多个页面，将每个页面的内容清空保存，然后该命名空间就会消失。

名称空间和GitHub的文件目录差不多呢。都是删除所有文件后，文件夹消失。

设置侧边栏

需要插件：addnewpage、indexmenu、cloud

配置管理器 - 基本设置，查看侧边栏的页面名称。

创建以此名称的页面。

创建页面
{{NEWPAGE}}


全部页面
{{indexmenu>..#1|navbar nocookie}}


标签云
~~TAGCLOUD[showCount]:50~~

相关插件：simplenavi、simpleindex、indexmenu（基于dtree）、navi（利用一个页面中的链接生成导航。自动根据当前页面展开命名空间。）、Sidebar Template（自动加载本命名空间的sidebar页面。展示形式跟Dokuwiki的站点地图一样。）、NsToC（列出指定命名空间的标题，可以指定标题的层级。场景：比如图书的目录等。）、pageindex、catlist、dir、nspages、pagequery

优化编辑体验

侧边栏分类索引：

需要插件：pagequery

{{pagequery>*;sort=ns,name;group;cols=4}}

dokuwiki的原生编辑器编辑体验只能说是刚好可以写字。撤销，工具栏按钮啥的不太好用。

设置网站图标

logo图标位置：dokuwiki/lib/tpl/dokuwiki/images/logo.png

使用新图标替换log.png 图标。清除浏览器缓存刷新即可看到效果。

设置在新窗口打开外部链接

配置管理器 - 链接设置，找到 外部链接的目标窗口 写上值''_blank'' （类似,a标签的target属性。）

快捷键

编辑状态下快速保存 ： Ctrl + Enter

删除修订记录

清空下面两个文件夹内的内容，但不要删除文件夹。

dokuwiki/data/meta、dokuwiki/data/attic

手动安装插件

下载扩展并将其解压缩到 dokuwiki/lib/plugins/<base-plugin-name>

插件的基本名称可以在plugin.info.txt找到（例如，对于图库插件，它由以下行定义base gallery)

Markdown转DokuWiki

安装pandoc，输入命令：

pandoc -f markdown_github -t dokuwiki 文档名.md -o 文档名.txt

转换后将转化后内容贴到dokuwiki即可。

DokuWiki 列表

1. https://www.ichiayi.com/wiki
2. https://wiki.idealclover.top/doku.php?id=start
3. https://wiki.imzm.im/

内置插件（21）

• authad：Provides user authentication against a Microsoft Active Directory（提供针对微软活动目录的用户认证）
• authldap：LDAP授权插件，提供对LDAP服务器的用户认证
• authpdo：通过PDO对数据库进行认证
• authplain：普通授权插件，针对DokuWiki的本地密码存储提供用户认证。
• captcha（可选）：验证码插件，使用验证码机制来保护DokuWiki免受自动垃圾邮件的影响。

• usermanager：用户管理器，添加和管理用户，管理DokuWiki用户帐户
• acl： ACL管理器，修改用户/组对于页面和命名空间的权限
• extension：插件管理器， 允许管理和安装插件和模板
• config：配置管理器，管理Dokuwiki的配置设置
• revert：恢复管理器，允许你大规模恢复最近的编辑，以消除垃圾邮件或破坏行为。
• styling：样式插件，Allows to edit style.ini replacements
• upgrade（可选）：升级插件，升级DokuWiki 的最简单方法

• info：列出系统插件列表等信息，（显示有关各种DokuWiki内部的信息）
• wrap（可选）：多功能插件，天机了用于创建各种彩色框、列的额外语法，甚至是您自己的风格。
• vshare（可选）：视频共享插件。可以轻松地从流行的视频共享网站嵌入视频到您的wiki页面。（如B站，YouTube）
• gallery（可选）：图库插件，轻松将美观的图像库嵌入到您的页面中。
• translation（可选）：翻译插件，如果您想创建一个多语言维基，这是推荐的插件。
• logviewer：查看DokuWiki日志
• popularity：人气反馈插件，向DokuWiki开发者发送关于你的维基的匿名数据
• safefnrecode：安全代码插件，Changes existing page and foldernames for the change in the safe filename encoding（为安全文件名编码的变化而改变现有的页面和折叠名）
• testing：Used to test the test framework. Should always be disabled.

主题

• 默认主题
• Bootstrap3
• Argon

插件

Dokuwiki的插件很多，全部可用 (1345)。许多插件被遗弃且陈旧，但也不乏精品，只是查找自己需要功能的插件比较困难，所以在此列举一二，以供参考。

dokuwiki的插件的使用方式大概分成两类，一类是有UI 的，另一类的没有UI只有语法或接口的。没有UI的插件，要阅读使用说明使用插件定义的语法应用插件的功能。

链接：https://www.dokuwiki.org/zh:plugins

1. move：移动页到其它名称空间，移动页面的同时移动对应的媒体，修改链接到它的页面链接。
2. addnewpage：添加页
3. pagequery：创建索引页的多用途的导航插件,全文搜索过滤,分栏、分组、排序显示，预览
4. indexmenu：索引目录插件
5. imgpaste：在编辑器直接粘贴就可以插入剪贴板中的图片，可以用来快速上传截图。
6. cloud：Tag云，依赖(tag插件)
7. linksuggest：自动建议插件（仅支持原生编辑器）
8. todo ： 待办列表，并且可以打勾等操作
9. Graphviz ：生成关系图，可视化图谱插件。
10. edittable： 插入表格
11. mathjax：启用MathJax [MathJax]对维基页面中的TeX数学表达式进行解析。
12. mathpublish：数学公式渲染
13. refnotes：文献管理与引用，很灵活很强大，配置上有些复杂。
14. Note：信息提示栏。可以在页面中插入醒目的提示文字，有几种默认图标和样式。
15. SyntaxHighlighter4：语法高亮
16. markdownextra：支持markdown语法
17. tag：用标签来组织内容
18. tagentry：在编辑框下列出所有标签。（没搞明白）
19. backup：备份页面、修订记录、媒体、配置等所有内容
20. EditTable Plugin：提供一个可视化的表格编辑和插入界面
21. dw2markdown（导出为md文件）

•    Prosemirror：DokuWiki的所见即所得编辑器
•    codemirror：CodeMirror编辑器，用于 DokuWiki 的语法高亮。
• imagereference：类似mediawiki那样给图片加题注并引用。
• NumberedHeadings：给标题编号
• cacherevisionserase：清除所有缓存和编辑历史，https://www.dokuwiki.org/plugin:cacherevisionseraser
• include： 包含其它wiki页面
• simpleindex: 生成类似内置索引的简单导航，仅适用于顶层命名空间。
• simplenavi: 生成一个简单的导航。
• zotero：从zotero引用文献
• bookcreator：导出多个页面为pdf文档
• Blockquote：可内嵌的区块语法，blockquote、QUOTE、quote、q语法
• Blog：列出类似博客的文章列表
• color：文字前景色背景色
• CSV：csv格式渲染为table语法
• definition list ：渲染为<dt><dd>
• discussion： 添加评论区域
• DocSearch： 附件搜索
• DocNavigation ： 显示上一篇文章、下一篇文章、目录页
• dw2pdf：导出pdf
• epub：创建epub电子书
• goto ： wiki内重新转向。
• History Cleanup ： 删除部分页面历史
• issuetracker： 问题跟踪系统
• Lightbox v2：弹出遮罩层显示图片
• Meta ： 指定页面元数据，比如页面标题、作者、创建时间等。以用作其他用途。不会覆盖data/meta中数据
• Numbered Headings ： 给标题加上数字编号。类似 1 1.1
• nspages：列出wiki页面（页面目录）列表
• http://OpenOffice.org ：导出odt格式文档（相当于word）
• pagelist ：表格形式列出wiki页面列表
• pagenav ： 显示上一页下一页等
• plaintext ： 支持text标签
• Searchindex ：重建全文搜索索引
• S5 Presentations： 创建幻灯片页面
• saveandedit：保存后继续编辑
• simplenavi ：根据当前页动态列出目录结构
• snippeter ： 编辑器按钮，插入文档模版
• NumberedHeadings：给标题编号（不会用）
• Symbols ：一些表情符号
• sync： 同步dokuwiki
• tabinclude ：在页面内用tab页签引用多个页面
• templatepagename ：在命名空间下创建页面作为该命名空间的模版。替代原生的_template
• blogtng：博客插件，需要sqlite支持。
• html5video2：使用video.js用html5和flash-fallback播放mp4视频
• virtualgroup：在 DokuWiki 中创建虚拟用户组
• abc和abc2：显示乐谱（输入 ABC、输出 SVG 和 MIDI）
• popupviewer：有没有想过不仅仅是让你的网站弹出图片，而是整个页面？PopUpViewer可以为你做到这一点!
• sqlite Plugin（连接数据库）
• randompage Plugin（随机页面）只有一个动作并无按钮，需要自定义

• yalist：简单的通用列表插件
• box：在方框中突出显示你的维基中特别重要的部分。
• styler：这个插件为你的文本提供额外的格式化：扩展引文、附言、诗句等。
• columns：在多栏中排列信息
• rss：RSS插件让你在DokuWiki中显示RSS源
• backlinks：反向链接，列出所有链接到给定页面的页面，使用第一个标题作为链接标题。
• Select：创建下拉菜单，将用户导航至所选链接
• BookmarkMe：创建各种社交书签服务的链接
• AV Bar Chart：在DokuWiki页面上创建快速简便的条形图
• googleanalytics ：此工具允许您设置与Google Analytics一起使用的代码，从而可以跟踪访问者。
• Loglog ：使用时间、IP和用户名记录所有的登录/注销操作和管理工具的使用情况
• Statistics 记录和分析访问统计信息（需要mysql）
• fields：允许在整个页面中存储和检索用户定义的字段
• data：在你的wiki中添加和查询结构化数据
• struct：新的结构化数据插件（data插件的替代，需要SQLite 插件）
• odt：将一个页面导出为LibreOffice和其他文字处理器使用的开放文档格式（ODF）。
• tabinclude：DokuWiki的Tab控件

注：此笔记中所有内容均收集于互联网。