DokuWiki 学习使用记录

本文为学习使用 DokuWiki 的过程记录包括基本使用、插件体验及所遇问题的解决。

安装

下载地址：https://www.dokuwiki.org/zh:install。推荐下载官方建议的 Stable 版本。
解压后打开目录下的 run.cmd，填写相关信息后安装完毕，将目录下的 install.php 文件删除。

更多安装相关详见官方文档：DokuWiki安装指南

解决中文文件名乱码问题

1.在 dokuwiki/conf/local.php 最后一行添加

$conf['fnencode'] = 'utf-8';

2.在 dokuwiki/inc/pageutils.php 找到如下两个函数，并进行修改

function utf8_encodeFN($file,$safe=true){
    global $conf;
    if($conf['fnencode'] == 'utf-8') return $file;

    if($safe && preg_match('#^[a-zA-Z0-9/_\-\.%]+$#',$file)){
        return $file;
    }

    if($conf['fnencode'] == 'safe'){
        return SafeFN::encode($file);
    }

    // 删除下面两行
    - $file = urlencode($file);
    - $file = str_replace('%2F','/',$file);

    return $file;
}

function utf8_decodeFN($file){
    global $conf;
    if($conf['fnencode'] == 'utf-8') return $file;

    if($conf['fnencode'] == 'safe'){
        return SafeFN::decode($file);
    }

    // 删除下面一行
    - return urldecode($file);
    // 加上下面这行
    + return $file;
}