編輯 CentOS Wiki 的指引
這頁提供了一些編輯 Wiki 的基本指引。由於這些指引仍在變動中,請偶爾檢查這個頁面。
假如你要找尋語法的說明(如何寫 wiki 的標記語言),請參閱 http://moinmo.in/HelpOnMoinWikiSyntax 。
1. 關乎 Wiki 標記的指引
使用相對連結,而不是絕對或自由連結。相對連結有這個形式::路徑:連結文* 字。例如要從這頁連結到 Bar 子頁面,你可以使用:[:/Bar:這段文字會以連結顯示]
若果你頁面的篇幅較長,考慮透過加入標題將 wiki 分段。= Title 1 =, == Title 2 == …… ===== Title 5 =====
若果你頁面的篇幅十分長,請在頂部加入 [[TableOfContents]] 這個巨集。它會展開成為這頁的索引。
2. 關乎風格的指引
- 避免在頁面裡使用第一人的單數稱謂(例如:「我」、「我的」),因為這樣對讀者幫助不大,亦有點不專業。假若你要提及自己或某人,請指向含有他們聯絡資料的 Wiki 頁面(如果他們在這 Wiki 上沒有一頁,只採用他們的全名亦可以)。
3. 關乎一般編輯的指引
- 在建設中的頁面加入一個「初稿」的告示,好讓人們不會以為頁面已經寫成。例如:「這頁仍在建設中,『甲』部及『乙』部並不存在」。
4. 關乎外部連結的指引
- 對外(不包含在這個 wiki 內)的 URL 及連結應該清楚地標示在 wiki 頁底,而不是嵌入於頁面內容。最理想的做法是建立一個「參考」部份,並將它們一併加進那個列表。視乎內容的版權,源自外部的相關資訊應該被直接放在 wiki 頁面裡。
5. 關乎翻譯的指引
翻譯這個 wiki 上的頁面時,請採用下列連結形式:
http://wiki.centos.org/$語系/頁面名稱
當中:
$語系:這是個含兩個英文字母的代碼,用來代表你所翻譯的語言。(見 ISO_3166-1 標準)。
頁面名稱:這是你取得內容來翻譯的英文頁面名稱。你只要在想翻譯的頁面前加入語系代碼便成了。這樣的話,語系代碼便應該是 http://wiki.centos.org/ 之後的首個元素。
若要翻譯一版未存在的頁面,你須要在連結後面加入 ?action=edit 這串字。例如你想將這頁翻譯成西班牙文:
http://wiki.centos.org/HowTos/SomePage
那麼你的連結應該是﹕
http://wiki.centos.org/es/HowTos/SomePage?action=edit
請在翻譯頁面的底部加入一行,聲明它的內容來自原始頁面的哪一個版本。
6. 令別人可以聯絡你
請協助查看修訂記錄的人聯絡到你,如讓他們在頁面有不清楚或陳舊的時候能建議作出修訂。建立一版 個人首頁並(至少)加入:你的 Wiki 用戶名稱、一個電郵地址的 mailto 連結、以及必須有的類別索引連結註腳:
---- CategoryHomepage
7. 額外的警戒及警示圖像
警示讓我們能夠凸出備註、主意或重要信息的內容。這在這個 wiki 內使用下列標記來建立警示:
|
||<class="lmimg blue"> ||||<class="lmtxt blue" (> ... || |
|
||<class="lmimg orange"> ||||<class="lmtxt orange" (> ... || |
|
||<class="lmimg green"> ||||<class="lmtxt green" (> ... || |
|
||<class="lmimg violet"> ||||<class="lmtxt violet" (> ... || |
|
||<class="lmimg red"> ||||<class="lmtxt red" (> ... || |
|
提示:你亦可以在警示信息中加入圖示: |
在警示中可用的圖示:
圖示 |
Wiki 代碼 |
|
|
attachment:ArtWork/WikiDesign/icon-admonition-alert.png |
|
|
attachment:ArtWork/WikiDesign/icon-admonition-attention.png |
|
|
attachment:ArtWork/WikiDesign/icon-admonition-idea.png |
|
|
attachment:ArtWork/WikiDesign/icon-admonition-star.png |
|
|
attachment:ArtWork/WikiDesign/icon-admonition-error.png |
|
|
attachment:ArtWork/WikiDesign/icon-admonition-info.png |
|
|
attachment:ArtWork/WikiDesign/icon-admonition-download.png |
|
圖示 |
Wiki 代碼 |
|
|
attachment:ArtWork/WikiDesign/icon-arrow-right.png |
|
|
attachment:ArtWork/WikiDesign/icon-arrow-right-blue.png |
|
|
attachment:ArtWork/WikiDesign/icon-arrow-right-green.png |
|
|
attachment:ArtWork/WikiDesign/icon-arrow-right-red.png |
|
|
attachment:ArtWork/WikiDesign/icon-arrow-right-violet.png |
|
|
attachment:ArtWork/WikiDesign/icon-arrow-right-orange.png |
Translation of revision 8