目录
使用 Dokuwiki 架设个人站点
本节描述使用 Dokuwiki 架设个人站点的配置和使用方法。为此您首先需要进行如下操作:
- 参考 DokuWiki 的安装环境 和 安装配置 DokuWiki 安装 DokuWiki
- 参考 Dokuwiki 的插件 一节的内容安装您所需的插件,建议安装如下的插件:
- 参考 Dokuwiki 的模版 安装支持 sidebar 的模板
- 本节以 Arctic 模板为基础(并安装了上面的插件)继续进行配置。
- 您可以安装如下的插件,也可以直接修改模板实现 Google Adsense 和 Google Analytics 的功能:
规划站点结构并创建页面
接下来应该规划站点的目录结构并创建 Sidebar、主页和相关页面。
规划站点结构
下面是一个站点结构示例:
/ |-- start --- 主页 |-- blog --- BLOG 首页 |-- blog/ --- 存放 BLOG 文章的目录 |-- archive --- BLOG Archive 页面 |-- tagcloud --- 存放 Tag Cloud 页面 |-- doc --- 文档主页 | |-- wiki | |-- blog | |-- cms | |-- docbook | |-- ajax | |-- python | `-- php |-- res --- 资源链接首页 | |-- tools | |-- software | |-- database | |-- linux | `-- windows |-- project --- 个人项目首页 | `-- cdbe |-- gallery --- 个人画廊首页 `-- about
创建 Sidebar 和相关页面
Arctic 模板支持 sidebar。要创建 sidebar 页面可以首先访问主站,然后在 URL 后添加 sidebar,回车
之后点击工具中的“创建该页面”链接。下面是一个 sidebar 的页面内容:
====== MAIN MENU ======
* [[:start]]
* [[:blog]]
* [[:archive]]
* [[:tagcloud]]
* [[:doc]]
* [[:doc:wiki]]
* [[:doc:blog]]
* [[:doc:docbook]]
* [[:doc:ajax:]]
* [[:doc:php:]]
* [[:res]]
* [[:res:tools]]
* [[:res:software]]
* [[:res:database]]
* [[:res:linux]]
* [[:res:windows]]
* [[:project]]
* [[:project:cdbe:]]
* [[:gallery]]
* [[:about]]
- 以
:开始的链接表示“绝对路径”,不以:开始的链接表示“相对路径” - 以
:结尾的链接,表示要创建名字空间下的start页面。例如:[[:project:cdbe:]] 表示/project/cdbe/start
页面显示结果
接下来依次创建各个链接页面即可。
配置与 BLOG 相关的插件
在 Dokuwiki 的管理界面中进入 配置管理器 进行配置。
配置 Tag 插件
配置 Blog 插件
配置 Avatar 插件
配置 Discussion 插件
- 若您希望在所有的页面中都包含讨论框,请勾选 discussion section on every page by default
- 若您希望使用 Gravatar 头像,请到 http://site.gravatar.com/ 注册并上传您的头像
- 若您希望使用 coComment 评论跟踪服务,请到 http://www.cocomment.com/ 以您要发表评论的 E-mail 注册
配置 Pagelist 插件
配置 Include 插件
使用 Blog 的相关功能
创建 Blog 主页
点击 Main Sidebar 中的 blog 文字链接创建该页,内容如下:
~~NOTOC~~
~~BOOKMARKME:off~~
====== BLOG ======
{{blog>blog?10}}
* {{blogfeed>blog?10|订阅BLOG内容}}
* {{commentsfeed>blog|订阅BLOG评注}}
{{tag>blog}}
显示结果如下:
创建 BLOG 文章
- 首先以可写的用户登录系统,然后在 Blog 主页面中的
New blog entry:后输入文章标题,之后单击 创建本页 - 用 Wiki 语法写 Blog 的内容
- 在 {{tag>}} 的
>之后填写以空格间隔的 Tags - 编辑后保存
例如:
1、 输入文章标题
2、书写文章内容
3、文章保存后的显示结果
4、BLOG 首页的显示效果
创建 BLOG Archive 页面
点击 Sidebar 中的 archive 链接创建 BLOG Archive 页面,内容如下:
====== BLOG Archive ======
===== 2008-06 =====
{{archive>blog?2008-06}}
===== 2008-05 =====
{{archive>blog?2008-05}}
{{tag>BLOG Archive}}
显示效果为:
- 此页面需要不断维护,每隔一个月就应该添加本月的内容
创建 TagCloud 页面
点击 Sidebar 中的 tagcloud 链接创建 TagCloud 页面,内容如下:
====== TagCloud ======
~~TAGCLOUD~~
{{tag>tags}}
显示效果为:
点击链接(如:blog)后的显示效果为
BLOG 评论
登录用户可以在界面中书写或回复评论(可以使用 Dokuwiki 语法)。
显示效果为:
未登录用户默认显示如下:
由于安装了 Avatar Plugin,Discussion Plugin 会根据登录用户注册的 Email 地址或匿名用户输入的 Email 地址显示 avatar 头像。
创建画廊
配置 gallery 插件
在管理界面中进入配置管理器,对 gallery 插件进行配置:
若您希望使用 AJAX 方式显示全图,请勾选 “Use Lightbox (implies direct linking)”之后的复选框。
创建画廊首页
点击 Sidebar 上的 gallery 链接,创建该页,内容如下:
====== Gallery ======
* [[gallery:me:]]
* [[gallery:penguin:]]
* [[gallery:books:]]
* [[gallery:ubuntu:]]
* [[gallery:dokuwiki:]]
{{tag>gallery}}
创建画廊
例如点击 penguin 链接,创建一个企鹅的画廊,输入如下内容:
====== 企鹅 ======
{{gallery>:gallery:penguin?3}}
{{tag>gallery}}
点击媒体工具按钮,上传图片,之后保存页面。
显示效果如图
当单击某图片时的显示效果为:
你可以创建页面收集 DokuWiki 中指定名字空间内的所有图片。例如:要收集
guide:dokuwiki 名字空间内的所有图片,可以创建如下内容的页面:
====== DokuWiki Gallery ======
{{gallery>:guide:dokuwiki?lightbox?3?showname}}
{{tag>gallery dokuwiki}}




































