====== Dokuwiki安装与使用 ======


===== 环境 =====

PHP需要安装成7.4版本。不支持低于7.2的版本，也不支持PHP8。

宝塔默认的是5.6，安装Web服务环境的时候，需要修改。


===== 安装方法1 =====

最简单的安装方法：[[https://www.dokuwiki.org/install:downloader | DokuWiki Downloader]]

  - 在服务器建立空目录wiki，并把下载的dokuwiki-downloader.php上传到这个目录
  - 修改wiki目录的所有者和组：chown -R www:www wiki
  - 浏览器访问downloader.php，按照说明进行安装


===== 安装方法2 =====

==== 1，下载，上传，解压 ====
  - 下载：[[https://www.dokuwiki.org/dokuwiki | DokuWiki官网]]
  - 上传：RLogin - SFTP
  - 解压：$ tar -xzvf dokuwiki-******.tgz

==== 2，修改用户和组、文件权限 ====

参考：[[https://www.dokuwiki.org/start?id=zh:install:permissions | 设置文件权限]]

  $ chown -R www:www wiki
  $ cd wiki
  $ chmod -R 777 data
  $ chmod 777 lib/plugins/
  $ chmod 755 lib
  $ chmod 777 lib/tpl/
  $ chmod 777 conf
  $ chmod 666 conf/*

==== 3，安装 ====

浏览器访问wiki/install.php，进行安装。


===== 网站访问安全设置 =====

参考：[[https://www.dokuwiki.org/start?id=zh:security | 网站访问安全]]

发布的压缩包里面含有一组 “.htaccess”文件，这些文件会告诉 Apache Web 服务器拒绝访问某些目录。

如果不使用 Apache Web 服务器又或者 Apache 不能使用 “.htaccess” 文件，那么需要手动设置。

宝塔 - 网站 - 设置 - 访问限制 - 禁止访问，添加下列目录禁止访问，规则"php|jsp|txt"：
  /wiki/data
  /wiki/conf
  /wiki/bin
  /wiki/inc (isn't dangerous when accessible, though)
  /wiki/vendor (leaks info about your environment)

验证方法：访问http://yourserver.com/data/pages/wiki/dokuwiki.txt，如果无法显示，则表示设置正常。


===== 定期备份，复原方法 =====

备份：所有数据保存在data文件夹，备份这一个文件夹即可。

复原：重新安装DokuWiki后，用备份的data文件夹覆盖data文件夹，然后执行权限修改即可：
  $ chmod -R 777 data


===== 插件 =====

参考：[[https://dokuwiki.oreda.net/plugin/list.html | DokuWikiおすすめプラグイン一覧]]

  * Upgrade Plugin by  Andreas Gohr - DokuWiki版本更新（用法：Admin Page - “Wiki Upgrade”）
  * Wrap Plugin by  Anika Henke - 排版（[[https://demo.selfthinker.org/plugin:wrap | 用法示例]]）
  * ImgPaste Plugin by  Andreas Gohr - Ctrl-V粘贴图片（[[https://dokuwiki.oreda.net/plugin/imgpaste.html | 用法示例]]）
  * EditTable Plugin by  Andreas Gohr - 表格编辑（[[https://dokuwiki.oreda.net/plugin/edittable.html | 用法示例]]）
  * Table Width Plugin by  Mykola Ostrovskyy - 表格宽度设置（[[https://www.achiachi.net/blog/dokuwiki/table-width-plugin | 用法示例]]）
  * color Plugin by  Harald Hanche-Olsen - 文字颜色和背景色（[[https://www.dokuwiki.org/plugin%3Acolor | 用法示例]]）


===== 参考 =====

  * DokuWiki简介：[[wiki:dokuwiki | About Dokuwiki]]
  * DokuWiki文法：[[wiki:syntax | Syntax Page]]
  * 欢迎页面：[[wiki:welcome | Welcome Page]]