九溪

溪水润知林,滴露启慧心

用户工具

站点工具


pages:help:dokuwikisetting

DokuWiki 常用设置

安装

从DokuWiki官网下载安装包

解压到相应目录后,在浏览器中访问 http://sitename/install.php

常用的站点设置

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

常用编写说明

完整版请查看 DokuWiki格式语法说明

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

一级标题(不在目录中出现。目录从二级标题开始。) 6个=

====== 一级标题 ======

二级标题 5个=

===== 二级标题 =====

三级标题 4个=

==== 三级标题 ====

链接

[[wiki:syntax]]

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

  the code

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

只显示代码 code 标记

<code php>
<?php echo "hello world!"; ?>
</code>
<?php echo "hello world!"; ?>

显示代码与文件 file 标记

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

显示代码与文件 code标记

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

升级

定位到网站上级

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

.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]

适用于 Nginx

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;
    }
}

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

\lib\tpl\dokuwiki\images\

与logo相关的三个文件

  1. apple-touch-icon.png
  2. favicon.ico
  3. logo.png

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

评论

请输入您的评论. 可以使用维基语法:
 
pages/help/dokuwikisetting.txt · 最后更改: 2025/02/27 15:56 由 colin