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 1072102 of 開始入門 MDN

  • 版本網址代稱: MDN/Getting_started
  • 版本標題: 開始入門 MDN
  • 版本 ID: 1072102
  • 建立日期:
  • 建立者: iigmir
  • 是目前線上的版本?
  • 回應

版本內容

{{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: 給熱愛看 Code 的人

我們需要更多的代碼示例!你也可以幫助建立我們的網站平臺,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="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="/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="/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="/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="/docs/MDN/Contribute/Howto/Write_a_new_entry_in_the_Glossary">在詞彙表中加上新的詞彙</a>(15 分鐘-1 小時)</li>
 <li class="ordinary-output target-output"><a href="/zh-TW/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>
 <li class="ordinary-output target-output"><span><a href="/docs/MDN/Contribute/Howto/Write_an_article_to_help_learn_about_the_Web">撰寫幫助大眾了解 Web 的文章</a>(1 小時-3 小時)</span></li>
</ul>

<div class="note">
<p class="ordinary-output target-output"><span><strong>注意:</strong>如果您要審查或撰寫新文章,請記得先看一下<a href="/zh-TW/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></p>
</div>

<h3 id="選項_2_給熱愛看_Code_的人">選項 2: 給熱愛看 Code 的人</h3>

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

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