DokuWiki 简明使用教程

什么是WIKI?什么是DokuWiki?

和博客、论坛一样,WIKI 是一种网站的类型,它最大的特点是允许不同的人修改同一份内容,从而使其更加完善。互联网上基于 WIKI 的理念创建的网站中最有名的当数 Wikipedia (即维基百科),尽管它的中文版本在中国无法直接访问,但并不妨碍它成为世界上流量最大的网站之一。如果你没有听说过维基百科,你可以认为它类似于国内的百度百科,不过维基百科比起百度百科内容更加丰富和优质,而且不像百度百科一样商业化。

如果有一台自己的服务器或是虚拟主机,你也可以搭建属于自己的 WIKI,这个过程不需要太多技术知识,因为网上有很多现成的开源程序可用。例如上面提到的维基百科就是采用叫 MediaWiki  的程序搭建的。这里将要介绍的 DokuWiki 就是一款用来构建 WIKI 网站的程序,相比MediaWiki,它更加轻巧和简单(只需PHP环境,无需数据库),适合小型团队和个人网站使用。

WIKI 类网站的适用范围很广,常见可以用作个人或是小型团队的知识库或是用来存放软件的文档等。协同编辑是 WIKI 最重要的特点。

修改页面

当你加入到一个 WIKI 网站(例如公司内部的知识库),除了进行正常的浏览外,最常见的两项活动无非就是修改现有页面新建页面了。

首先介绍如何修改页面。在默认的 DokuWiki 模板下,修改(编辑)页面的入口在页面主要内容区的右侧,是一个铅笔状的图标(见下图)。

Edit Link of DokuWiki

不同的 WIKI 有不同的权限设定,比如有些 WIKI 允许所有人参与编辑,有些 WIKI 则设定了只有部分人(注册用户等)才能编辑——对于这类 WIKI,你需要登陆后才能开始编辑,否则只能浏览。

进入了修改页面后就可以看到编辑区域,现在你可能会发现编辑区域内显示的内容很奇怪,但是不要担心,这些不是什么高深的东西,后面解释了就明白了。现在要知道的是,要修改(或者新建)页面的内容就是这里进行的。编辑完成后,可以点击文本框下方的预览按钮看看效果,满意的话就可以保存。

注:在每次修改后留下修改说明是个好习惯。

新建页面

WIKI 上的每一个页面都不应该是孤立的,不同页面之间应该通过超链接连接起来(孤立的页面即使被创建出来也往往无法被浏览到,因为没有指向它们的超链接)。正因如此,DokuWiki 上并没有单独的新建页面的按钮(当然这个功能可以通过插件来实现)。如果需要为某个主题新建一个页面的话,应该考虑采用『在现有页面上建立一个链接』的方法来完成。

在上一节修改页面中提到,编辑区域内的内容看起来很奇怪,那是因为大多数 WIKI 都会用到自己特有的语法来书写内容。这篇教程中会介绍少量语法,不过当你明白了所谓的语法是什么意思后,你可以自己查阅语法说明来进一步学习。

那么什么语法呢?打个比方:例如你在 WIKI 中加入了如下内容:

Woolandbun 是羊毛和包子系列内容的统称,是一个在想象中构建的虚拟世界。
现在我们想把其中 Woolandbun 这个单词加粗显示要怎么办呢?很简单,只需要在要加粗的内容前后加上两个 * ,那保存以后就能看到对应的加粗效果,就像这样:
加入了加粗语法的句子: **Woolandbun** 是羊毛和包子系列内容的统称,是一个在想象中构建的虚拟世界。

实际的显示效果:
Woolandbun 是羊毛和包子系列内容的统称,是一个在想象中构建的虚拟世界。


际使用中,可以自己查阅语法说明或是使用编辑框上方的快捷工具条(DokuWiki Editor Toolbar)编辑内容。工具条的使用很简单,在上面的例子中,选中要加粗的内容再点击工具条上的加粗按钮(B)就能自动加上星号。

前面说了,要新建一个页面最好的办法是在现有页面上创建一个指向新页面的链接。和加粗文字一样,创建一个链接也有自己的语法,只需要在对应的文字前后加上两个方括号即可。(当然也可以用快捷工具条)

例如,如果要创建一个关于羊毛和包子党的页面,就可以在现有的页面上输入[[羊毛和包子党]]保存后就能看到一个红色的链接(红色代表该链接指向一个没有内容的页面),点击这个红色链接就能进入到一个空白页面,然后就可以按修改页面的方法输入内容,保存后新的页面就创建完成了。

在实际的使用中,我们建议采用[[woolandbun|羊毛和包子党]]这样的形式来创建页面的链接。为什么呢?简单地讲就是给创建的页面起一个英文名字。两种方式显示的链接文字都是羊毛和包子党,区别在于页面的网址不同,例如前一种方式生成的网址可能会是 http://wiki.lichifeng.com/羊毛和包子党/ 而后一种方式生成的网址则会是 http://wiki.lichifeng.com/woolandbun/ 显然英文的网址更利于 SEO。

关于创建各种链接更详细的说明可以查阅链接的语法说明

删除页面

要删除页面只需在编辑框内把所有内容清空后保存即可。

使用标题生成目录

好的内容首先要有好的结构。如果你浏览过维基百科或是国内的一些百科网站,不难发现绝大部分页面都会有一个层次清晰的目录,就如下图中红框所示:

DokuWiki ToC Sample

这个目录是如何生成的呢?显然不是作者手工输入的,在大部分 WIKI 中这样的目录都可以自动生成(这种目录一般称为 TOC,如果想要搜索相关插件,可以用 TOC 作为关键词)。

那 WIKI 又是根据什么来生成的内容的目录呢?它怎么知道哪些是大标题,哪些是小标题呢?答案上面其实已经提到——通过WIKI 的语法来指定。

例如我们有如下内容:

Wiki 是一种在网络上开放且可供多人协同创作的超文本系统,由沃德·坎宁安于1995年首先开发。沃德·坎宁安将 wiki 定义为“一种允许一群用户利用简单的描述来创建和连接一组网页的社会计算系统”。

词源

wiki 源自夏威夷语的 “WikiWiki”,本是“快点快点”之意。wiki的中文翻译有维客、围纪、围记、快纪、共笔或维基等等,其中“维基”一词是中文维基百科人特别为维基百科而创,属于维基媒体的专用术语。

历史

Wiki 软件是由软件设计模式社区发展出来,用来书写与讨论模式语言。沃德·坎宁安于1995年3月25日成立了第一个 Wiki 网站:WikiWikiWeb,用来补充他自己经营的软件设计模式网站。他发明了 Wiki 这个名字以及相关概念,并且实现了第一个 Wiki 引擎。坎宁安说自己是根据檀香山的 Weekee Weekee (快点快点)公车取名的。这是他到檀香山学会的第一个夏威夷语。

特征

奥德·坎宁安和波·路夫(Bo Leuf)在《The Wiki Way: Quick Collaboration on the Web》一书中描述了 Wiki 概念的几个本质特征:
Wiki 允许任何用户在 Wiki 网站内剪辑任何页面或新建页面,不需要任何额外的附加组件,只需通过普通的网页浏览器即可。


显然文中的“词源”、“历史”、“特征”适合作为目录内的标题。那我们只需在需要作为标题的内容前后加上一定数量的英文等号和空格即可,如果一篇内容含有超过三个标题(不同的 WIKI 设定不同,有些可能不是以三个为阀值),目录就会自动生成。

上面的例子就可以改为:

Wiki是一种在网络上开放且可供多人协同创作的超文本系统,由沃德·坎宁安于1995年首先开发。沃德·坎宁安将wiki定义为“一种允许一群用户利用简单的描述来创建和连接一组网页的社会计算系统”。

==== 词源 ====

... ...

==== 历史 ====

... ...

==== 特征 ====

... ...


目录可以有很多层,不同层次的目录用不同数量的英文等号标记。更详细的语法说明可以查看这里:DokuWiki语法

插入图片

插入图片有两种方式,一种是直接上传,另一种是引用其它网站的图片。一般来说,除非来源很可靠,最好不要引用来自于其它网站的图片,有很大可能对方关站或者其它原因导致图片失效不能正常显示。

图片插入流程不废话,直接录了一个简单的录像:(动画尺寸略大,约1M,请点击观看)

dokuwiki insert image

标签: DokuWiki, WIKI, Tutorial

仅有一条评论

  1. Cliff Cliff

    谢谢~很有帮助

添加新评论