MDC:開始動手
From 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 上。流程很簡單:
- 從既存內容清單中選一個你想幫忙「搬」的文件。
- 參考頁面命名原則,決定這份文件在此 Wiki 上的標題名稱。
- 建立新頁面,將文章搬過來,依據本站 wiki 標籤參考所列方式盡可能為該文件加上適當標籤。
- 將該文件自既存內容清單中刪除。
- 將該文件列入待轉向清單。
如果你願意幫忙做點清理的工作,也可以:
- 使用我們的搜尋引擎搜尋 Wiki 上連到原文件網址的所有頁面,然後將該頁面上的連結修正到 Wiki 的新連結位置。
- 檢查連往原文件位置的站外連結轉向,在轉向頁加上
[[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