Contents
使用 GNOME Wiki 的快速指南
在 wiki 世界里,很多新用户不知该如何入手。本页面意在使用户能快速对 wiki 有一个了解。
什么是 wiki?
Wiki是一个网站。 但它是一个特殊的网站,一个你可以编辑和建立新页面的网站。每一个 wiki 页面的下方都有一个“Edit”文本链接。点击它你会转到一个网页。wiki 页面中的所有内容都在新网页的输入框里。
方便的添加新页面、页面内编辑的特性,使得 wiki 成为协作编写文档的好工具,特别是持续改进中的文档和有过期可能性的说明文档。Wiki 是一个极好的工具,它允许很多人一起工作来编写文档,或者在一个公共论坛上交流工作意见。这样的 wiki 页面的一个不错的例子是 ThreePointZero 页面,在不同的时间点,一大批人添加了他们的评论。
Wiki 页面是从“wiki 文本”创建的。“wiki 文本”是一种非常简单的标记,设计用来生成一般的页面,没有 HTML 和 CSS 那么强大。 下面是介绍 wiki 中基本元素的使用。
要开始,我需要什么?
GNOME Wiki 要求使用者有一个帐号才能开始编辑页面。如果你只是想浏览公开的可访问的页面,就像一个普通的网站一样浏览就行。不过,如果你想使用 wiki,你就需要一个帐号了。
获得一个帐号很容易,但不太明显。
在每一个 wiki 页面的左上角,有一个链接叫做“UserPreferences”。点击这个链接会将你带到一个新页面,在这里你可以输入你的用户名(建议采用“名姓”的方式,并且没有空格 )、密码和邮箱地址。输入后,点击“Create profile”,你将会进入一个偏好设置页面。而“UserPreferences”链接现在已经变成你填入的“名姓”。到此,你的帐号已经创建成功了,可以准备继续了!
好了,我已经有一个帐号了。然后呢?
你可能想给一个页面添加新内容,或者创建一个新页面。
编辑已存在的页面
访问一个 wiki 中已经存在的页面。WikiSandBox 是一个不错的用来教学的页面。你可以创建内容,随便乱来,而不会影响其他人。现在点击 WikiSandBox 链接打开页面,然后点击下面的编辑文本链接。
乍看上去,页面中的内容似乎有些凌乱。随处可见很多的“=”,“'”,“{”,“}”。看看下面的“Wiki 文本”这段来快速学会使用最常用的 4 个或 5 个常用的 wiki 格式化元标记(更深入的了解,wiki 中有一个叫“HelpOnEditing”的页面有详细介绍)。
创建新页面
创建新页面是非常容易的。Wiki 页面的名称由两个或多个单次首字母大写组成。例如, MingTang 是我的 wiki 主页。如果你点击 MingTang 你会访问我的主页了。如果页面还不存在,当你点击它,你会转到一个提供创建该页面选项的页面。点击“Create this page”,就会访问指定的页面了,除非在输入框里你什么也没有输入。
另一个创建新页面的方法(除了在一个页面内添加链接,然后点击链接)是直接在浏览器里输入地址。如果你在浏览器输入 http://wiki.gnome.org/DoesntExistYet, 你会看到 "DoesntExistYet" 页面(不要改动它).你可以通过这种方式来创建独立的或者隐藏的页面,或者是还没准备好给人们阅读的草稿页面。
Wiki 文本
现在——你处在编辑页面。然后你想在页面中输入一些内容。 格式是怎么标记的呢?
第一个规则——当你输入纯文本、没有格式的文本,你输入的是什么样,输出就是什么样。如果你想开始新的段落,空一行,然后再输入文本。很容易!
下一个你可能想知道的是如何创建标题。为了创建标题,只需要在你需要的地方添加不同个数的“=”。例如,
= 测试标题 =
= 用的越多,标题字号越小
==== 更小的标题 ====
一定要注意在标题标记的行末尾不能有空格。保存时注意检查并删去多余的空格。
接下来是更有用的东西——列表。列表有两种,有序列表和无序列表。它们都还可以有子列表。
若要创建一个无序列表的项目符号列表,在段首的空格后使用不同个数的“*”。段首至少要空一个。若要创建子列表,段首空两格即可。若要创建子列表的子列表,段首空三格。
若要创建有序列表,方法机会完全一样,唯一的区别是使用“1”,而不是“*”。
举个例子——
* 列表项 1 1. 编号1 * 子列表的子列表 1. 编号 2 * 列表项 2 * 子列表 1 * 子列表 2
会转换成
- 列表项 1
- 编号 1
- 子列表的子列表
- 编号 2
- 编号 1
- 列表项 2
- 子列表 1
- 子列表 2
使用这几个格式符,就足够我们开始了。更多的信息,可参看 HelpOnEditing.
受限制的页面或章节
Wiki 中的一些页面和章节对特定的人群是受限的。一般情况下,受限页面提供有电子邮箱,你可以联系以获取访问和编辑此页面的权限。通常,你只要拥有一个帐户并登录,就可以阅读和编辑页面了。
订阅页面更新
如果你订阅了页面的更新,当这个页面的结构发生变化时,你会收到邮件通知。例如,你想接收Stuttgart2005/InternalPlanning章节的所有更新,在你的偏好设置页(你可以点击顶部你的用户名看到这个页面)添加
Stuttgart2005/InternalPlanning.*
到 "Subscribed wiki pages"位置。
制作表格内容
如果你要在页面上制作表格内容,只要这样放置即可:
<<TableOfContents>>
跨 wiki 链接
你可以链接到外部 bug。可以使用下一代编辑器:
[wiki:gnomebug:123456 #123456]
或者使用图形界面编辑器:
如何查找链接到当前页的页面
点击页面标题即可。不同主题(如果你切换了)间布局可能不同。所以如果想查看哪些页面链接到 QuickStart,点击顶部的“QuickStart”即可。如果你想移动一个页面或者改变所有链接到这个页面的链接,或者仅仅想看看有哪些页面链接到你正在看的页面的话,这是非常有用的。