Dokuwiki布署小记

Posted 2020-08-17 永远的阿哲

      最近个人写作风格全面转向Markdown模式，但之前使用的Mediawiki并未原生支持，且本人在布署时为了实现其所见即所得的方案和别的一些个性化需求，添加了太多插件和自定义设置，两年多过去了，很多设置细节已不甚记得，所以想进行Wiki的重新布署与实施。经研究，最终选择Dokuwiki。其优点很多，如功能强大，更新及时，插件丰富，结构简单，布署方便等。现将布署过程记录如下，以示备忘。

 

      10.从官网上下载程序包，如果本地没有php环境，注意在“Include Web-Server”处勾选“MicroApache (Windows)”

 

      20.解开压缩包后，运行run.cmd，会在本地8800端口创建服务并打开浏览器，进行Wiki初始化工作，按界面提示填写即。可以在右上角的下拉框中选择中文语言

 

      30.初始化后，用刚才填写的管理员用户进行登录，右上角管理，点击扩展管理，然后点击搜索和安装页签

 

      40.搜索并安装【Markdowku】插件，让Wiki支持Markdown语法

 

      50.搜索并安装【Codemirror】插件，让输入框支持语法着色。默认情况下，其只是将自带的Doku语法进行了着色，我需要将其更改为Markdown语法

        a.打开插件安装目录

D:\DokuWikiStick\dokuwiki\lib\plugins\codemirror

 

        b.打开action.php，为data数组增加两个新的元素

$event->data[‘script‘][] = array(
    ‘type‘ => ‘text/javascript‘,
    ‘charset‘ => ‘utf-8‘,
    ‘src‘ => "$base_url/dist/modes/markdown.min.js?v=$version",
);

$event->data[‘script‘][] = array(
    ‘type‘ => ‘text/javascript‘,
    ‘charset‘ => ‘utf-8‘,
    ‘src‘ => "$base_url/dist/modes/gfm.min.js?v=$version",
);

 

        c.打开dist/scripts.min.js，将对doku语法的调用修改为对gfm语法的调用。这是个被压缩后的代码文件，通过Ctrl+F文本查找工具，以“doku”为关键词进行查询，在第7行大概第29619个字符处，将“doku”修改为gfm，其上下文代码如下

function i(){b=JSINFO.plugin_codemirror;b.name="gfm";b.loadMode=function(c)

 

      60.搜索并安装【Imgpaste】插件，让Wiki支持在Chrome浏览器下，支持通过编辑器内Ctrl+V，实现图片资源上传

 

      70.将dokuwiki文件夹打包，即可完成整个站点的迁移

 

      参考

      哪个开源的wiki系统比较好用，请大家推荐一下？

      Dokuwiki 插件整理

      Wiki对比