DokuWiki安装与配置

DokuWiki

本文简要介绍DokuWiki的下载、安装和初始配置。

下载

DokuWiki官网下载,注意下载时可以选择语言文件和常用文件一起打包下载。我选择了以下两个插件:

  • Upgrade Plugin  可以自动升级
  • Wrap Plugin  增加一些漂亮的显示效果

安装

解压,上传至服务器,在浏览器中打开install.php文件,开始安装。

安装时的主要设置步骤是ACL(权限控制),如果不想Wiki被公开访问,那么设置管理员帐户,Initial ACL policy设置为Closed Wiki(另外两种是Open和Public),并且设置不允许用户自行注册。

最后删除install.php,安装完成。

安装插件

除了下载安装包时可选的默认插件,DokuWiki还有其它许多插件用以功能增强。我准备下载Tag插件以启用标签功能给条目分类(还有Tag插件的基础插件Pagelist)。

DokuWiki安装插件很方便,打开Admin > Extension Manager > Search and Install,在Search Extension文本框里填入插件的名称(Tag、Pagelist)并直接安装即可,免去了反复下载上传的麻烦。

配置

因为一些系统选项的改动可能会使之前的数据不可访问,因此安装完成后,首先对选项进行必要的设置。通过Admin > Configutation Settings打开选项设置页,DokuWiki的选项都集中在这一页内分段显示。以下是几个需要注意的配置项:

userewrite

默认是未启用URL rewritting,可以选择.htaccsssDokuWiki Internal,懒得设置.htaccsss文件,于是选择使用DokuWiki内置的URL rewritting,无需额外设置,够用。

fnencode

DokuWiki会把词条保存为txt文件,为了避免文件名中包含的非ASCII和特殊字符和底层操作系统不兼容,DokuWiki会对文件名进行编码。这个设置有URL、Safe和UTF-8三个选项。URL使用URL编码产生文件名,会产生很长的文件名,有可能会超过某些系统255个字符的长度限制;Safe选项会更紧凑地对文件名编码,避免以上的问题,因此推荐使用。

因为我的Wiki会主要使用中文,UTF-8选项不会对文件名进行编码,而是直接以UTF-8格式保存中文的文件名,因此我选择UTF-8。这样的话如前面一篇文章所说,如果出了问题,我可以保存这些txt文件,直接进行检索。注意这个选项在某些操作系统上可能不起作用。

sepchar

词条名称中除了字母(包括中文字符)、数字、下划线、横杠、小数点之外的所有字符都会被设置的sepchar分隔符替换,默认的分隔符是下划线。

这个功能对于比较纠结的人呢就比较讨厌,特别是外国人的名字。比如“Issac Newton” > “issac_newton”、“艾萨克·牛顿” > “艾萨克_牛顿”,虽然不影响使用但比较难看。

找了一些解决方法都需要改代码,不是很推荐。因为我英文的词条不会太多,我的应对是首先把sepchar分隔符从下划线改为小数点,稍稍好看一些,中文的外国人姓名间的中点,使用全角的中点可以避免被替换,暂时就这样了。

deaccent

这个设置有三个可选项:off、remove accents和romanize。

默认值remove accents会把词条名称里某些语言罗马字母上的注音符号去掉。虽然中文内容几乎影响不到,但是去掉注音符不是一个“合适”的方法,不推荐。

romanize会把词条名称里某些语言(比如日语、韩语)的字母罗马字母化,尝试了一下日语,只转换假名不转换汉字,只能说这个功能还不成熟。

因此我把这一项设置为off,配合之前fnencode设置为UTF-8格式保存文件名,正合适。


以上就是目前为止的一些经验,更多的功能留待后继的使用中慢慢发掘。

Leave a Reply