Visit Mozilla.org

MDC:開始動手

From MDC

如何協助 MDC:內容
清單
文件需求清單
編輯、檢視待辦事項
需搬移的文件清單
指南
開始動手
寫作指南 (含體例)
頁面命名原則
消歧義
開創新的 MDC 本地化專案
授權方式
參考文件
Wiki 標籤參考
自訂 CSS 類別
自訂樣板
MediaWiki 擴充功能
站外連結轉向
待轉向
MDC 正體中文
正體中文版
翻譯方法及須知
本文件正在翻譯中,請參考原文協助翻譯。

您只要使用您的網頁瀏覽器就可以很輕易地開始參與並協助 MDC。如果您曾經使用瀏覽器填過網頁表格,或是使用網頁介面發表過 blog 文章,您已經完全具備開始動手的所有技能了。

目錄

[編輯] 簡介

我們鼓勵所有人一起協助撰寫、編輯、檢查或是翻譯這個 wiki 中的任何文件。 敬請大家秉持著共同合作的精神,別因為其他人稍候將您的文件做修正或改進而感到失落或沮喪。我們大家在這兒都是想要讓 Mozilla 文件更健全、更有品質,因此「協同合作」是永遠會被讚賞的。

[編輯] 基礎

這份簡短的指南將引導您在 MDC wiki 裡編輯與建議頁面。歡迎您可以先在 測試沙箱 練習看看如何編輯 wiki 頁面。

[編輯] 編輯頁面

在編輯任何頁面之前,您需要先建立一個 wiki 帳號。請到 User login 這個頁面,然後填寫簡單的表格並送出。當您建立了一個帳號之後,就會自動登入並且可以開始編輯。

每一頁右手邊的欄位中,你都可以看到「編輯」的連結。用滑鼠點選後,你就會被帶到該頁面的編輯模式,你可以在編輯模式中做任何的變更、預覽,然後將之儲存進 wiki 中。一旦儲存之後,你將可以立即地看到該頁面編輯後的樣子。

[編輯] 新增頁面

要建立新頁面最簡單的方法,是在你自己的用戶頁面為新頁面建立一個連結,然後使用該連結進到新頁面的編輯模式。

要進到你的用戶頁面,請在 wiki 上方藍色橫棒選項中點選你自己的用戶名字。如果你尚未放任何東西在你的用戶頁面中,你將會直接被帶到該頁的編輯模式,然後你可以開始加任何你想加進去的內容上去。

要建立新頁面的連結,你只要用兩個方刮號將新頁面的標題框起來,像這樣:[[這是個範例]]。當你儲存之後,就會轉變成為一個連結:這是個範例

如果頁面還不存在,將會看到個紅色的連結。如果頁面真的已經存在,該連結會是藍色的。如果你想建立的新頁面標題已經有人用過了,建議你也許可以協助並改進已經存在的頁面。不然就為你的新頁面另外想一個不同的標題,然後再建立連結給新的頁面。

當你想要在你新的頁面中加些內容,只要點選你剛建好的那個紅色連結,即可開始編寫。記得在你編寫完成之後,使用編輯表單下方的「保存本頁」按鈕以儲存你的作品。

[編輯] 頁面命名原則

關於建立新頁面,並為之命名的更多資訊,請參閱我們的 頁面命名原則

[編輯] Wiki 標籤

假使你現在點選右手邊欄位中的「編輯」,你將會看到這個頁面中的文字以及一些奇奇怪怪的符號,例如,在標題文字旁會有「==」符號、在連結旁會有「[[ ]]」引號框住。這些都是 wiki 系統所特有的符號形式。這讓 wiki 系統能夠非常容易地辨認,並呈現出相對應的文字形式,而且如果你標錯了什麼,這套符號架構的容錯性也是很高的。

[編輯] Wiki 標籤參考

我們準備了一頁完整的 wiki 標籤參考 供你參考與學習關於這套 markup 語言,以方便你編輯 wiki 內容。

[編輯] 寫作、編輯與審閱

這是一份稍微長一些的 MDC 簡介,供寫作者、編輯人員以及檢閱伙伴參考。

[編輯] 寫作

MDC 永遠歡迎新的內容創作,所以我們鼓勵你為目前這個 wiki 中所包含的任何 主題 來創作文章。創作內容可以是個簡單一頁份的「點子」,或是複雜到一份架構完整像本書的程式寫作指南或參考文獻。你創作的長度是不受限制的,整個地由你決定。

存放在 Bugzilla 資料庫 中 Mozilla 專案的 Bug ,若是與文件相關的都應該標上關鍵字: dev-doc-needed。這是另一個很好的方式,讓其他人可以找到目前還有什麼項目是需要文件工作的。一般來說,只有那些最後有改進原始程式碼的 bug 是應該用文件記錄的。當有文件變更的需求,且完成文件編輯之後,該 bug 應該加入關鍵字: dev-doc-complete

如果你正準備起草一個大型專案,建議你加入 MDC 社群 並且在那兒先提出你的想法,這只是避免另外也有人正計畫開始(或已經在進行中)與你的想法相類似的專案。

假如你對文件編排風格或 wiki 的使用政策有些疑問,請參閱我們的 寫作指南

[編輯] 編輯

在這個 wiki 很歡迎你編輯訂正他人的文件,不論是改進或更正寫作風格、文法、拼字。請參閱我們的 寫作指南 以獲得更多資訊。

[編輯] 審閱

在這裡也很歡迎你更正與審閱技術方面的資料,假使你在閱讀文件時發現了技術相關的錯誤(不論是文字敘述或程式碼中),歡迎你隨時編輯並更正之。如果這可能是個有爭議的變更,你可以在「talk」頁中註記之 (請點選右手邊欄位中的「討論」連結),並留下你想變更的理由供他人參考。

[編輯] 寫作指南

MDC 中文版的寫作指南尚未制定,原則上翻譯文章皆依循原有格式,其他未定事宜歡迎提出建議,煩請聯絡文件管理員

[編輯] 搬移既存舊文件

除了翻譯文章之外,MDC 中文版另一個任務是將 Mozilla Taiwan 上既存的相關技術文件都搬到這個 Wiki 上。流程很簡單:

  1. 既存內容清單中選一個你想幫忙「搬」的文件。
  2. 參考頁面命名原則,決定這份文件在此 Wiki 上的標題名稱。
  3. 建立新頁面,將文章搬過來,依據本站 wiki 標籤參考所列方式盡可能為該文件加上適當標籤。
  4. 將該文件自既存內容清單中刪除。
  5. 將該文件列入待轉向清單。

如果你願意幫忙做點清理的工作,也可以:

  1. 使用我們的搜尋引擎搜尋 Wiki 上連到原文件網址的所有頁面,然後將該頁面上的連結修正到 Wiki 的新連結位置。
  2. 檢查連往原文件位置的站外連結轉向,在轉向頁加上 [[Category:垃圾桶]] 以請求刪除。

[編輯] MDC 在地化

若你願協助將 MDC 的文件翻譯為另一種語言,就到該語言的 MDC 去逛逛吧!

[編輯] 現存的在地化專案

截自本文撰寫時間(2007年1月8號),MDC 有以下數種語言的 Wiki: Català, 中文(简体), Deutsch, English, Français, Italiano, 日本語, Nederlands, Polski, Português, Español, 한국어 中文(正體),.

最新的語言列表請參考英文版網頁

[編輯] 如何開創新的 MDC 在地化專案

如果您想要為某種語言新增一個在地化專案,我們目前沒有這樣的維基(wiki)供用, 請參閱 在地化專案 以及下面的介紹。

[編輯] 處理「編輯戰」及其他爭議

如果碰上了所謂的「編輯戰」,也就是兩個(以上)的編輯者刻意相互不斷修正、回退對方編輯內容的情形,請先試圖調停眾人間的衝突。

如果真的解決不了,則請到 MDC 郵件清單上回報狀況、並通知開發者文件管理員。我們會請適合的技術專家、作者、編者提出經驗協助解決這個問題。

[編輯] 請求刪除文件

若不慎誤建立無用頁面、或覺得某頁面應予刪除,請在文件最後放上 [[Category:垃圾桶]] 將其加到「垃圾桶」類別。本站管理員會不定期查閱垃圾桶類別,評估其中的內容是否該刪除。

:請不要刪除您放到「垃圾桶」中文章的任何部份。

[編輯] 加入 MDC 社群

MDC 由一群志工協力鑄成,我們也非常願意協助新成員參與寫作編修。

[編輯] 郵件群組及新聞群組

[編輯] IRC 頻道

我們也會常常掛在 irc.mozilla.org 主機上的 #devmo 頻道: #devmo 於 irc.mozilla.org.

[編輯] 專案管理

MDC 專案管理:Deb Richardson

文件管理:Eric Shepherd