Windows调试

安装wampserver64

在wampserver中文镜像站下载wampserver最新版，高速下载安装包需要付费1元，推荐付费
若已安装wampserver旧版本，则只能通过升级包升级，不能直接安装新版本
安装位置只能在某个盘符的根目录，如C:\

安装dokuwiki

在dokuwiki官网下载安装包
清空C:\wamp64\www目录，将安装包直接解压在该目录下
此时的C:\wamp64\www目录应该有一个文件夹dokuwiki，而C:\wamp64\www\dokuwiki下有很多文件
在wampserver保持开启时，直接在浏览器中访问localhost/dokuwiki/install.php即可安装dokuwiki。若需要改端口则需要在wampserver中进行设置，以后再研究
访问localhost/dokuwiki/doku.php进入主页

调整关键设置

点击右上角的齿轮图标可以进入主设置页面，齿轮图标里可以切换语言至中文，拼图图标里可以安装插件
在“高级设置”里找到fncode选项并改为utf-8，更改完此设置之后才可以开始写内容，如果改迟了，会导致改之前的中文名页面全部失效
或在conf/local.php里加入

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

部署

直接使用dockerhub上的dokuwiki镜像，注意更改配置文件中的UID

version: "2"
services:
  dokuwiki:
    image: lscr.io/linuxserver/dokuwiki
    container_name: dokuwiki
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
    volumes:
      - ./data:/config
    ports:
      - 9665:80
    restart: unless-stopped

然后docker-compose up -d，访问http://host/install.php
之后的关键设置同Windows

dokuwiki具体内容和设置

重要插件

插件统一使用插件管理器安装，先在官网插件一览或其中文翻译页面找到所需插件，然后在插件管理器的搜索区搜索其名称
下面是一些较为重要的插件

  • cleanup用于自动定时清除缓存和文章历史记录，时间间隔可在设置页面调整
  • Move用于移动和删除页面及其对应媒体文件
  • nspages用于目录
  • Upgrade用于升级dokuwiki版本，docker模式部署则不需要
  • Hidden用于切换一些细节内容的显示

在插件页面复制下载直链，打开本wiki的插件管理器，可以从url直接安装

批量导入内容

直接把未链接媒体文件的txt文件放入data/pages及其子目录下，无需重启docker容器，内容即可自动加入wiki系统

添加新内容

直接访问host/dokuwiki或www/doku.php?id=ns123:abc可以访问尚不存在的页面，点击屏幕右侧的铅笔按钮即可编辑并创建该页面

目录相关

nspages插件

有很多类似插件，但随着dokuwiki版本更新，有很多不能用了，目前的dokuwiki最新版本为2022-07-31 "Igor"

在管理员页面的齿轮图标页面把breadcrumbs设为0，youarehere设为true，这样可以回到上一级目录

侧边栏sidebar.txt

每个名空间都可以有独立的侧边栏，下面的例子是主页的侧边栏

~~NOCACHE~~
<nspages -exclude:[start sidebar playground: playground wiki: syntax] -tree -subns -pagesInNs -textNs="" -title>

每个名空间的start页面

名空间的start页面的文件名为start.txt，其内容如下。注意这个目录中不含有该页面自身

~~NOCACHE~~
======sky======
<nspages -exclude -tree -subns -pagesInNs -title -nbCols=1 -textNs="">

页面和媒体文件的api接口

见python库python-dokuwiki官网说明，在页面右上角可以找到其github仓库，核心代码只有一个文件