九溪

本页面只读。您可以查看源文件，但不能更改它。如果您觉得这是系统错误，请联系管理员。
====== DokuWiki 常用设置 ======

===== 安装 =====

从DokuWiki官网下载安装包
  * Download DokuWiki![[https://download.dokuwiki.org/]]
  * 稳定版安装包 [[https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz]]

解压到相应目录后，在浏览器中访问 http://sitename/install.php
  
===== 常用的站点设置 =====

^设置项 ^设置值 ^
|标题(title)|Site Title|
|副标题(tagline)|Site Tagline|
|开始页面(start)|home|
|侧边栏(sidebar)|sidebar|
|目录的最顶层(toptoclevel)|2|
|使用“标题 H1”作为页面名称(useheading)|true|
|使用更整洁的 URL(userewirte)|.htaccess\\ (tip:需要[[dokuwikisetting#伪静态规则]]支持) |
|在 URL 中使用斜杠作为命名空间的分隔符(useslash)|true|

===== 常用编写说明 =====

完整版请查看 [[help:syntax]]

标题可通过文本编辑器的按钮快速插入标题

一级标题(不在目录中出现。目录从二级标题开始。) 6个=
  ====== 一级标题 ======
二级标题 5个=
  ===== 二级标题 =====
三级标题 4个=
  ==== 三级标题 ====
  
链接
  [[wiki:syntax]]

加入一行代码(空两行开始)
    the code

加入一坨代码 使用 code 或 file 标记。输入文档格式与文档名称（若要显示文件，则需制定文档格式）。

**只显示代码 code 标记**
  <code php>
  <?php echo "hello world!"; ?>
  </code>
<code php>
<?php echo "hello world!"; ?>
</code>

**显示代码与文件 file 标记**
  <file php thecode.php>
  <?php echo "hello world!"; ?>
  </file>
<file php thecode.php>
<?php echo "hello world!"; ?>
</file>

**显示代码与文件 code标记**

  <file php thecode.php>
  <?php echo "hello world!"; ?>
  </file>
<file php thecode.php>
<?php echo "hello world!"; ?>
</file>

===== 升级 =====
定位到网站上级
  cd /var/www/

备份
  cp -Ra colinol.com colinol.com.bak

下载升级包
  wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz

解压升级包
  tar -xzvf dokuwiki-stable.tgz

复制上传
  cp -rf dokuwiki-xxxx-xx-xx/* colinol.com/

或者强制复制
  yes | cp -rf dokuwiki-xxxx-xx-xx/* colinol.com/

至此，网站已升级完成，可以访问验证有没有问题

从备份文件夹中恢复数据文件
  cd /colinol.com.bak

  yes|cp -rf conf/* ../colinol.com/conf/
  yes|cp -rf data/* ../colinol.com/data/
  yes|cp -rf lib/* ../colinol.com/lib/

备份
  tar -zcvf colinol.com.tar.gz colinol.com
  
安全设置
  #data和conf目录需要写权限
  sudo chown -R www-data:www-data data conf


按照经验：升级时，最好先下载最新安装包，全新安装。再将旧的数据拷贝到新网站程序中。
数据存储在 data/pages
主要备份目录应为 conf data lib

===== 伪静态规则 =====
==== 适用于 Apache ====
<file htaccess .htaccess>
RewriteEngine on
RewriteBase /
RewriteRule ^_media/(.*) lib/exe/fetch.php?media=$1 [QSA,L]
RewriteRule ^_detail/(.*) lib/exe/detail.php?media=$1 [QSA,L]
RewriteRule ^_export/([^/]+)/(.*) doku.php?do=export_$1&id=$2 [QSA,L]
RewriteRule ^$ doku.php [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule (.*) doku.php?id=$1 [QSA,L]
</file>

==== 适用于 Nginx ====
<code>
rewrite ^(/)_media/(.*) $1lib/exe/fetch.php?media=$2 last;
rewrite ^(/)_detail/(.*) $1lib/exe/detail.php?media=$2 last;
rewrite ^(/)_export/([^/]+)/(.*) $1doku.php?do=export_$2&id=$3 last;
location /
{
    if (!-f $request_filename)
    {
        rewrite ^(/)(.*)?(.*)  $1doku.php?id=$2&$3 last;
        rewrite ^(/)$ $1doku.php last;
    }
}
</code>

===== 替换网站原生logo =====

dokuwiki安装或升级后，可以将系统自带的logo换成自己的。logo文件保存位置：

  \lib\tpl\dokuwiki\images\

与logo相关的三个文件

  - apple-touch-icon.png
  - favicon.ico
  - logo.png

更改方法：先选择好自己的logo标志，然后根据这三个文件的类型及原图标的尺寸，制作相对应格式的新图标。最后分别保存为同名文件，再上传到对应目录中覆盖系统自带文件即可。再刷新网站时，就会发现已经变成新的logo了。