用户工具

站点工具


wiki:tutorial

百科建立教程

dokuwiki是一个轻量化的百科系统,使用起来十分简单,希望此教程可以让你学会建立属于自己的百科系统。 8-)

1. 基础结构

首先我们需要了解dokuwiki的基础结构,即页面和命名空间。页面和命名空间均可以使用中文。

1.1 页面

页面(page)即作者直接参与编辑、读者直接观看的界面,作者可以通过访问一个不存在的页面(如https://www.dragicland.com/wiki/doku.php?id=测试)进行编辑添加。当访问不存在的页面时,DokuWiki会给你提供选项让你创建它(这取决于你的访问权限)。你也可以在另一个DokuWiki页面中创建一个链接(如测试),然后让浏览器访问该链接,从而创建新的页面。

如果你编辑一个页面并移除其中的所有内容,DokuWiki就会删除该页面。

页面的标题即页面内容中的第一个一级标题(H1),而标题内容会在各种列表和标题栏中予以显示。因此,为了方便查阅,最好将第一个一级标题取名为需要的页面名称。

1.2 命名空间

如果说是页面是一个一个单独的文件,那么命名空间(namespace)就是分门别类保存这些文件的文件夹(实际上,dokuwiki也确实是按照文件夹/文件.txt的方式分类储存所有页面数据的)。

在dokuwiki中,页面和命名空间的从属关系由页面名称定义,例如一个页面名称为a:b,则表示这是一个放置于a命名空间下的b页面。文件夹结构为:

   根级命名空间 (总是存在的)
     |
     +-- 'a' 命名空间
           |
           +-- 'b' 页面

命名空间可以有多级,如建立一个页面名称为a:b:c,那么文件夹结构则为:

   根级命名空间 (总是存在的)
     |
     +-- 'a' 命名空间
           |
           +-- 'b' 命名空间
                 |
                 +-- 'c' 页面

如果你的页面名中包含不存在的页面空间,那么,该页面空间也会被自动创建。

善用命名空间可以更能够有效地编辑和管理你的百科结构。

2. 世界首页

现在,我们已经学会了如何建立和编辑页面,下一步就可以开始着手编写内容了。

当你成功申请到一个世界观百科后,你会在站点首页已【收录的世界】列表中看到你的世界首页页面(即你的世界名称),点击它进入你的百科首页吧。

如无必要,请不要修改首页的一级标题(即世界观的名称),这会影响你的世界首页在站点首页上的展示文本内容。

也请不要移除首页中的tag(可以添加别的tag,但请别移除这个)

{{tag>首页}}

移除后站点首页上就不会显示你的世界观首页了。

3. 侧边栏

在你的世界百科根目录下建立一个名叫sidebar的页面(即sidebar),该页面中的所有内容就都会作为侧边栏展示出来。建议和插件:索引菜单(IndexMenu)配合编写侧边栏,效果更佳哦。

4. 数据备份

如有需要,你可以联系Dragicland站长羽·凌风获取你的所有百科数据备份。获得的页面数据均为txt格式,内容和页面编辑器中的内容相同,并分门别类收纳在和命名空间结构相同的文件夹中。

wiki/tutorial.txt · 最后更改: 2020/03/22 22:11 由 羽_凌风