This site has been retired. For up to date information, see handbook.gnome.org or gitlab.gnome.org.


[Home] [TitleIndex] [WordIndex

使用 GNOME Wiki 的快速指南

在 wiki 世界裡,很多新的使用者不知該如何入手。本頁面意在讓使用者能快速對 wiki 有一個了解。

什麼是 wiki?

Wiki 是一個網站。但它是一個特殊的網站,一個你可以編輯和建立新頁面的網站。每一個 wiki 頁面的下方都有一個 EditText 鏈結。點擊它你會轉到一個網頁。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」,就會存取指定的頁面了,除非在輸入框裡你什麼也沒有輸入。

另一個建立新頁面的方法(除了在一個頁面內添加鏈結,然後點擊鏈結)是直接在瀏覽器裡輸入位址。如果你在瀏覽器輸入 https://wiki.gnome.org/DoesntExistYet ,你會看到「DoesntExistYet」頁面(不要改動它)。你可以通過這種方式來建立獨立的或者隱藏的頁面,或者是還沒準備好給人們閱讀的草稿頁面。

Wiki 文件

現在——你處在編輯頁面。然後你想在頁面中輸入一些內容。格式是怎麼標記的呢?

第一個規則——當你輸入純文字、沒有格式的文件,你輸入的是什麼樣,輸出就是什麼樣。如果你想開始新的段落,空一行,然後再輸入文字。很容易!

下一個你可能想知道的是如何建立標題。為了建立標題,只需要在你需要的地方加上不同個數的「=」。例如:

= 測試標題 =

「=」用的越多,標題字號越小。

==== 更小的標題 ====

一定要注意在標題記號的行尾不能有空白字元。儲存時注意檢查並刪去多餘的空白字元。

接下來是更有用的東西——清單。清單有兩種,有編號列表和無編號列表。它們都還可以有子清單。

若要建立一個無編號的項目符號清單,在段首的空白字元後使用不同個數的「*」。段首至少要空一格。若要建立子清單,段首空兩格即可。若要建立子清單的子清單,段首空三格。

若要建立有編號列表,方法完全一樣,唯一的區別是使用「1」,而不是「*」。

舉個例子——

 * 清單項 1
  1. 編號 1
   * 子清單的子清單
  1. 編號 2
 * 清單項 2
  * 子清單 1
  * 子清單 2 

會轉換成

使用這幾個標記符號,就足夠我們開始了。更多的資訊,可參看 HelpOnEditing

受限制的頁面或章節

Wiki 中的一些頁面和章節對特定的人群是受限的。一般情況下,受限頁面提供有電子信箱,你可以聯繫以取得存取和編輯此頁面的許可權。通常,你只要擁有一個帳號並登入,就可以閱讀和編輯頁面了。

訂閱頁面更新

如果你訂閱了頁面的更新,當這個頁面的結構發生變化時,你會收到郵件通知。例如,你想接收 Stuttgart2005/InternalPlanning 章節的所有更新,在你的偏好設定頁(你可以點擊頂部你的使用者名稱看到這個頁面)加上

Stuttgart2005/InternalPlanning.*

到「Subscribed wiki pages」位置。

製作表格內容

如果你要在頁面上製作表格內容,只要這樣放置即可:

<<TableOfContents>>

跨 wiki 鏈結

你可以鏈結到外部 bug。可以使用下一代編輯程式:

[wiki:gnomebug:123456 #123456]

或者使用圖形介面編輯程式:

  1. 寫下要添加鏈結的文字
  2. 選取文字
  3. 選取「InterWiki

  4. 選取 gnomebug (或者 interwiki 鏈結)
  5. 輸入數字
  6. 點擊儲存

如何尋找鏈結到目前頁面的頁面

點擊頁面標題即可。不同主題(如果你切換了)間佈局可能不同。所以如果想檢視哪些頁面鏈結到 QuickStart,點擊頂部的「QuickStart」即可。如果你想移動一個頁面或者改變所有鏈結到這個頁面的鏈結,或者僅僅想看看有哪些頁面鏈結到你正在看的頁面的話,這是非常有用的。


CategoryWiki


2024-10-23 11:42