使用说明

页面都是纯文本,第一个标题会成为页面标题;下面这些是 Wiki 在文字之外提供的用法。

页面与分节

每个页面都有名字。名字里带 / 就分节:guides/install 属于 guides 这一节。打开一节会列出里面的页面,所以分节不会是空白页。

Wiki 的写法

只有下面这几种写法有特殊含义,其余都是普通文字。

  • [[页面]]链接到另一个页面;红色的表示还没人写。
  • [[页面|文字]]链接到某个页面,但显示你自己的文字。
  • {{页面}}把那一页的内容放在这里,多个页面可以共用一段文字。
  • 节/页面名字里带 / 就分节;打开这一节会列出里面的页面。
  • _header用这个名字的页面会自动成为本节每页的页头(叫 _footer 则是页脚)。
  • _片段以 _ 开头的页面不进列表也不进搜索,只在被用到的地方出现。

共用同一段内容

{{页面}} 会把另一页放在这里。改一次错字,所有用到它的页面都会更新。被包含页的第一个标题会被略去,页面仍然只有一个标题。

名字叫 _header(或 _footer)的页面会自动加到本节每个页面的顶部(或底部);就近的优先,所以 guides/_header 影响 guides/install,但不影响 guides 之外的页面。改名后这些页面就不再显示它,因为它是按名字匹配的。

名字以 _ 开头的页面不会出现在列表和搜索里,只在被用到的地方显示。

页面模板

页面可以在最上面写一小段字段,其中一个决定用哪种版式。这段字段就是普通正文,会一起保存、进历史、进备份。

---
template: book
series: Handbook
author: Ada
---
# Chapter one

第一个标题仍然是页面标题,字段只给模板用。在编辑页选一个版式,这段字段会自动写好。当前可用模板:book。

历史

每次保存都会留下上一版。历史页列出所有版本:可以对比任意两版,或恢复旧版。你填的摘要会显示在那份列表里。

改名与移动

旧地址会继续跳转到这里,已有的链接和包含也会自动跟过来,不用手改。例外是 _header / _footer,它们按名字匹配。

管理员可以在 Wiki 后台一次性给整节改名:节内所有页面(含共用块)一起搬走,旧地址继续能用。

同时编辑

别人正在编辑时会看到提示。如果保存前页面已被改过,会把两版并排给你合并,而不是丢掉你的文字。

找页面

搜索会查标题和正文。红链指向还没人写的页面,点开就能创建它;缺页清单会把这些页面一并收齐。Wiki 首页按分节列出全部页面,并附上最近更改。

打开搜索结果后,搜索词会被高亮并直接跳到第一处,长页面不用从头读。

最近更改页会把整份日志一页页列出来;如果你习惯用订阅器,它也在 /wiki/changes.rss 提供 RSS。

评论

登录且站点允许回复的会员都能在页面下评论,不需要编辑权限。评论作者、版主和管理员可以删除评论。

页面改名时评论跟着走,进回收站后也还留着;清空 wiki 时一起删除。管理员可以关闭评论,或设置同一人两条评论之间要等多少秒。

新评论会通知这一页最近编辑过的人,通知点进去直接落在评论区。

评论输入框平时折成一行,点一下才展开完整编辑器,工具栏和发帖回复时一样。

关注的页面

关注一页后,它会出现在「我关注的页面」里,每条都标着最近更新时间。最近更改可以只看这些页,热闹的 wiki 也能读得下来。

关注不会改变页面本身:不会收到邮件,页面也不会被保护,只是把你在意的页面收在一处。