Please note, this is a STATIC archive of website developer.mozilla.org from 03 Nov 2016, cach3.com does not collect or store any user information, there is no "phishing" involved.

Revision 925265 of 開始入門 MDN

  • 版本網址代稱: MDN/Getting_started
  • 版本標題: Getting started on MDN
  • 版本 ID: 925265
  • 建立日期:
  • 建立者: BobChao
  • 是目前線上的版本?
  • 回應 修改從 zh-CN 上搬過來的語詞,改善翻譯

版本內容

{{IncludeSubnav("/en-US/docs/MDN")}}

這裡不分品牌、瀏覽器、平台,我們都是希望能為美好的 Web 未來提供更多資源。大家都能貢獻,而每個貢獻者都讓我們更為壯大。要想持續推動 Web 創新、成就更為偉大的事物?就讓我們和您一起,從這裡開始。

MDN 上的每一個部分(網站本身的程式、文件、程式範例、效果展示等等)都是由一群開發者及文案編輯組成的社群完成。術業有專攻,您也一定有些妙招可以分享,請加入我們!

MDN 三步驟快速上手

MDN 是一個 wiki,每個人都可以添加、編撰內容。您不必得是個了解許多技術的程式設計師才能加入,畢竟總有各種事情需要完成,從簡單(校對、糾正拼寫)到複雜(寫作API文檔)都有。

加入貢獻非常容易,且即使您不慎犯了個錯誤,也很容易修正。就算您不知道文件該怎麼編排,或者不太了解語法,也不用煩惱:我們有一群人就是專門努力巡視四周、盡力確保 MDN 上的內容優質依舊;有人會盡力編輯您的貢獻確保文件格式正確,所以就放膽分享您的所學吧!

步驟 1:建立 MDN 帳號

第一步是要有 MDN 帳號,請參考建立帳號說明

步驟 2:找件事來完成

現在您已經登入完畢,請閱讀{{anch("各種工作內容", "下面列表")}}中不同工作的描述,找出最吸引您的一個。您可以任選一個喜歡的工作作為第一步。

步驟 3:動手

一旦決定了想做什麼事,就找個特定的頁面、程式碼範例之類的,然後開工吧!

別擔心您無法做到完美,會有 MDN 成員來幫忙修復問題與錯誤。有任何疑問,都歡迎到社群網頁上查詢郵件群組、聊天頻道等資訊,協助您找尋答案。

註:如果您想在實際動手前先「測試」一下,可以先到 Sandbox 頁面隨意玩玩。如果要測試什麼東西,請都在那一頁做就好,避免只是為了「看看效果如何」就動手改任何內容頁面,不然負責清理的志工就又有得忙啦 :P

完成這項工作以後,歡迎再挑另一件事情做,或者看看{{anch("其他可以在 MDN 上做的事", "其他可以在 MDN 上做的事")}}。

各種工作內容

基於你的技能和興趣,有很多方法可以幫助MDN。儘管一些任務可能是艱巨的,我們有很多簡單的活動可進行。很多人只需要五分鐘(或更少!)。隨著任務和它的簡短描述,你會發現每一種類型的任務通常需要近似的時間。

選項 1: 我喜歡文字

你可以幫我們審查或編輯現有的文檔,並對它們應用正確的標籤。

注意:在你審查已有的文章或者編寫新的文章之前,最好先看一下我們的風格指南這樣有助於確保大家寫出的文章的風格是一致的

選項 2: 我喜歡代碼

我們需要更多的代碼示例!你也可以幫助建立我們的網站平臺,Kuma

選項 3: 我喜歡文字和代碼

我們有需要的技術和語言技能的任務,像寫新文章,審查技術的準確性,或調整文檔。

選項 4: 我希望MDN有我的語言

所有的當地語系化和翻譯工作是由我們的令人驚訝的MDN社區志願者做的。

選項 5: 我發現了一些錯誤的資訊,但我不知道該怎樣修復它

你可以在 Bugzilla 上提交 bug。(5分鐘)

注意在新建 bug 時要按照下面說的規則填寫:

Bugzilla 頁面中的欄位名 應該選擇或填寫的內容
product Developer Documentation
component [經可能選擇正確的 component,如果實在不知道選哪個,就選 "General" 好了]
URL 你發現問題的頁面位址
Description 盡可能把錯誤的資訊描述清楚,還可以附上一些連結來證實自己的說法。

其他可以在 MDN 上做的事

版本來源

<div>{{IncludeSubnav("/en-US/docs/MDN")}}</div>

<p>這裡不分品牌、瀏覽器、平台,我們都是希望能為美好的 Web 未來提供更多資源。大家都能貢獻,而每個貢獻者都讓我們更為壯大。<span class="ordinary-span-edit">要想持續推動 Web 創新、成就更為偉大的事物?就讓我們和您一起,從這裡開始。</span></p>

<p>MDN 上的每一個部分(網站本身的程式、文件、程式範例、效果展示等等)都是由一群開發者及文案編輯組成的社群完成。術業有專攻,您也一定有些妙招可以分享,請加入我們!</p>

<h2 id="3個簡單的_MDN_步驟"><span>MDN 三步驟快速上手</span></h2>

<p>MDN 是一個 wiki,<strong>每個人</strong>都可以添加、編撰內容。您不必得是個了解許多技術的程式設計師才能加入,畢竟總有各種事情需要完成,從簡單(校對、糾正拼寫)到複雜(寫作API文檔)都有。</p>

<p>加入貢獻非常容易,且即使您不慎犯了個錯誤,也很容易修正。就算您不知道文件該怎麼編排,或者不太了解語法,也不用煩惱:我們有一群人就是專門努力巡視四周、盡力確保 MDN 上的內容優質依舊;有人會盡力編輯您的貢獻確保文件格式正確,所以就放膽分享您的所學吧!</p>

<h3 id="步驟_1_創建一個MDN帳號">步驟 1:建立 MDN 帳號</h3>

<p>第一步是要有 MDN 帳號,請參考<a href="/docs/MDN/Contribute/Howto/Create_an_MDN_account">建立帳號說明</a>。</p>

<h3 id="步驟_2_選擇一個任務並完成">步驟 2:找件事來完成</h3>

<p>現在您已經登入完畢,請閱讀{{anch("各種工作內容", "下面列表")}}中不同工作的描述,找出最吸引您的一個。您可以任選一個喜歡的工作作為第一步。</p>

<h3 id="步驟_3_做任務">步驟 3:動手</h3>

<p>一旦決定了想做什麼事,就找個特定的頁面、程式碼範例之類的,然後開工吧!</p>

<p>別擔心您無法做到完美,會有 MDN 成員來幫忙修復問題與錯誤。有任何疑問,都歡迎到<a href="/docs/MDN/Community">社群網頁</a>上查詢郵件群組、聊天頻道等資訊,協助您找尋答案。</p>

<div class="note">
<p><strong>註:</strong>如果您想在實際動手前先「測試」一下,可以先到 <strong><a href="/docs/Sandbox">Sandbox</a></strong> 頁面隨意玩玩。如果要測試什麼東西,請都在那一頁做就好,避免只是為了「看看效果如何」就動手改任何內容頁面,不然負責清理的志工就又有得忙啦 :P</p>
</div>

<p>完成這項工作以後,歡迎再挑另一件事情做,或者看看{{anch("其他可以在 MDN 上做的事", "其他可以在 MDN 上做的事")}}。</p>

<h2 id="可能的任務類型">各種工作內容</h2>

<p>基於你的技能和興趣,有很多方法可以幫助MDN。儘管一些任務可能是艱巨的,我們有很多簡單的活動可進行。很多人只需要五分鐘(或更少!)。隨著任務和它的簡短描述,你會發現每一種類型的任務通常需要近似的時間。</p>

<h3 id="選項_1_我喜歡文字">選項 1: 我喜歡文字</h3>

<p>你可以幫我們審查或編輯現有的文檔,並對它們應用正確的標籤。</p>

<ul>
 <li class="ordinary-output target-output"><a href="/zh-CN/docs/MDN/Contribute/Howto/Set_the_summary_for_a_page"><span class="edited">設置一個</span><span class="edited">頁面</span><span>的摘要</span></a><span>(5-15</span><span>分鐘)</span></li>
 <li class="ordinary-output target-output"><a href="/zh-CN/docs/Project:MDN/Contributing/How_to/Do_an_editorial_review"><span>編輯評論</span></a><span>(5</span><span>–</span><span>30分鐘)</span></li>
 <li class="ordinary-output target-output"><a href="/zh-CN/docs/MDN/User_guide/Writing#Editing_an_existing_page"><span class="edited">隨著新的資訊更新現有的文章</span></a><span>(5</span><span class="edited"> 分鐘-1</span><span>小時)</span></li>
 <li class="ordinary-output target-output"><a href="/zh-CN/docs/MDN/User_guide/Writing#Adding_a_new_page"><span class="edited">寫</span><span class="edited">關於新的技術或</span><span>API</span><span>的一篇文章</span></a><span>(30</span><span class="edited"> 分鐘-2</span><span>小時)</span></li>
</ul>

<div class="note">
<p class="ordinary-output target-output"><span><strong>注意:</strong>在你審查已有的文章或者編寫新的文章之前,最好先看一下我們的<a href="/zh-CN/docs/Project:MDN/Style_guide">風格指南</a></span><span style="line-height:1.5">,</span><span style="line-height:1.5">這樣有助於確保大家寫出的</span><span class="edited" style="line-height:1.5">文章的風格</span><span style="line-height:1.5">是一致的</span><span style="line-height:1.5">。</span></p>
</div>

<h3 id="選項_2_我喜歡代碼">選項 2: 我喜歡代碼</h3>

<p>我們需要更多的代碼示例!你也可以幫助建立我們的網站平臺,<a href="https://developer.mozilla.org/zh-CN/docs/Project:MDN/Kuma">Kuma</a>!</p>

<ul>
 <li class="ordinary-output target-output"><a href="/zh-CN/docs/Project:MDN/Contributing/How_to/Convert_code_samples_to_be_live_"><span class="edited">轉換</span><span class="edited">示例代碼</span><span>是</span><span class="edited">“可用的”</span></a><span>(30</span><span>分鐘)</span></li>
 <li class="ordinary-output target-output"><a href="https://kuma.readthedocs.org/en/latest/installation-vagrant.html"><span class="edited">建立一個</span><span class="edited">Kuma</span><span class="edited">的程式設計環境</span></a><span>(1</span><span>小時)</span></li>
 <li class="ordinary-output target-output"><a href="https://github.com/mozilla/kuma#readme"><span class="edited">發送你的</span><span>代碼</span><span class="edited">補丁到</span><span class="edited">Kuma</span><span class="edited">的代碼庫</span></a><span>(1</span><span>小時)</span></li>
 <li class="ordinary-output target-output"><a href="/zh-CN/demos/submit"><span class="high-light-bg">提交一個新的</span><span>演示</span></a><span>(1</span><span>小時)</span></li>
</ul>

<h3 id="選項_3_我喜歡文字和代碼">選項 3: 我喜歡文字和代碼</h3>

<p>我們有需要的技術和語言技能的任務,像寫新文章,審查技術的準確性,或調整文檔。</p>

<ul>
 <li class="ordinary-output target-output"><a href="/zh-CN/docs/Project:MDN/Contributing/How_to/Tag_JavaScript_pages"><span class="edited">標記JavaScript</span><span>網頁</span></a><span>(</span><span>5分鐘)</span></li>
 <li class="ordinary-output target-output"><a href="/zh-CN/docs/MDN/Promote"><span class="edited">推進</span><span>MDN</span><span class="edited">在你自己的網站</span></a><span>(5</span><span>分鐘)</span></li>
 <li class="ordinary-output target-output"><a href="/zh-CN/docs/Project:MDN/Contributing/How_to/Do_a_technical_review"><span>技術評論</span></a><span>(30</span><span>分鐘)</span></li>
 <li class="ordinary-output target-output"><a href="/zh-CN/docs/Project:MDN/Contributing/How_to/Update_API_page_layout"><span>更新</span><span>API</span><span>頁面配置</span></a><span>(30</span><span>分鐘)</span></li>
 <li class="ordinary-output target-output"><a href="/zh-CN/docs/MDN/Contribute/Creating_and_editing_pages#Creating_a_new_page"><span>寫一個</span><span class="edited">你熟悉內容的</span><span>新文章</span></a><span>(1小時以上</span><span>)</span></li>
</ul>

<h3 id="選項_4_我希望MDN有我的語言">選項 4: 我希望MDN有我的語言</h3>

<p>所有的當地語系化和翻譯工作是由我們的令人驚訝的MDN社區志願者做的。</p>

<ul>
 <li class="ordinary-output target-output"><a href="/zh-CN/docs/MDN/Contribute/Localize/Translating_pages"><span>翻譯</span><span class="edited">頁面</span></a><span>(2</span><span>小時)</span></li>
 <li class="ordinary-output target-output"><span>連接其它在<a href="/zh-CN/docs/Project:MDN/Localizing/Localization_projects">當地語系化項目</a>裡列出的元件</span><span>(30</span><span>分鐘)</span></li>
</ul>

<h3 id="選項_5_我發現了一些錯誤的資訊,但我不知道該怎樣修復它">選項 5: 我發現了一些錯誤的資訊,但我不知道該怎樣修復它</h3>

<p>你可以在 <a href="https://bugzilla.mozilla.org/enter_bug.cgi?product=Mozilla%20Developer%20Network">Bugzilla 上提交 bug</a>。(5分鐘)</p>

<p>注意在新建 bug 時要按照下面說的規則填寫:</p>

<table class="standard-table">
 <tbody>
  <tr>
   <td><strong>Bugzilla 頁面中的欄位名</strong></td>
   <td><strong>應該選擇或填寫的內容</strong></td>
  </tr>
  <tr>
   <td><code>product</code></td>
   <td><a href="https://bugzilla.mozilla.org/enter_bug.cgi?product=Developer+Documentation">Developer Documentation</a></td>
  </tr>
  <tr>
   <td><code>component</code></td>
   <td>[經可能選擇正確的 component,如果實在不知道選哪個,就選 "General" 好了]</td>
  </tr>
  <tr>
   <td><code>URL</code></td>
   <td>你發現問題的頁面位址</td>
  </tr>
  <tr>
   <td><code>Description</code></td>
   <td>盡可能把錯誤的資訊描述清楚,還可以附上一些連結來證實自己的說法。</td>
  </tr>
 </tbody>
</table>

<h2 id="其它你可以在MDN上做的東西">其他可以在 MDN 上做的事</h2>

<ul>
 <li class="ordinary-output target-output"><a href="/zh-CN/docs/Project:Community"><span>加入</span><span>MDN</span><span>社區</span></a><span>。</span></li>
 <li class="ordinary-output target-output"><a href="/zh-CN/profile"><span>填寫你的個人資料</span></a><span>以便其他人能</span><span>更瞭解你</span><span>。</span></li>
 <li class="ordinary-output target-output"><span>瞭解更多關於</span><a href="/zh-CN/docs/MDN/Contribute"><span class="edited">貢獻</span><span>MDN</span></a><span>。</span></li>
</ul>
還原至此版本