现在就开始

  • 版本网址缩略名: Project:现在就开始
  • 版本标题: 现在就开始
  • 版本 id: 275177
  • 创建于:
  • 创建者: Daysky
  • 是否是当前版本?
  • 评论 /* 本地化MDC */

修订内容

{{template.MDCProjectPagesTOC()}}

帮助MDC就像使用你的浏览器一样简单。 如果你之前在网上填写过表单或者在一个文本框里面写过你的博客的话,你就有了开始为MDC做贡献的所有技能。

介绍

我们鼓励您帮助撰写,编辑,审阅和翻译您在本维基中看到的任何文档。 请用合作的心态来完成您的工作,不要因为别人修改或者改进了您的贡献而觉得沮丧。 我们为了努力使得Mozilla的文档更加完善,因此我们鼓励合作意识和相互帮助。

基础

下面是在MDC维基中创建和编辑页面的简短说明。你也可以在沙箱中练习这些技巧。

编辑页面

在开始编辑页面之前,您需要创建一个维基帐号。你可以在用户登录页面填写并提交申请表格。在您创建成功一个帐号之后,您会自动登录并且可以开始编辑。

在每一个页面的右侧你会找到一个"编辑"链接。 点击这个链接您就可以开始编辑当前的页面。在那里您可以修改并且预览您的修改,然后把那些修改保存到维基当中。当您保存了您的编辑之后,您马上就会看到页面的变化。现在我编辑一下

开始一个新的页面

开始一个新页面的最简单的方法是在你的用户页面里建立一个链接,然后通过那个连接来进入新页面的“编辑”模式。

你可以通过点击维基最上方的蓝色导航栏中的你的用户名进入你的用户页面。如果你还没有在你的用户页面上添加任何的内容,你会直接进入页面的编辑模式,然后你就可以任意地添加你喜欢的东西了。

创建一个到页面的链接就想把标题写在方括号里面一样简单,像这样:[[这是一个例子]]。 当你保存的时候,那个就会变成一个链接,像这样:这是一个例子

如果这个页面不存在,链接会是红色的。如果已经存在,链接会变成蓝色。如果你想创建的页面已经存在了,你应该试着去完善已经存在了的页面。否则你需要给你的页面另外找一个名字。

当你想给你的新页面添加内容的时候,你可以单击刚才的红色链接然后就可以开始撰写了。记得点击编辑窗口下方的“保存本页”按钮来保存你的工作,尤其是你在编辑一个很长的文章的时候。

页面命名向导

更多的关于创建和命名新页面的信息请参阅命名向导.

维基标记

如果你现在点击右侧边栏的“编辑”,你会看到这个页面的内容包含了很多特殊的字符。比如“==”标记在标题的两边,“[[]]”标记在链接的两边。这是维基系统中的一种非常简单的文字标注方法。这种表及系统的好处是非常易学而且出错之后非常容易改正。

维基标记参考

我们有一个完整的维基标记参考手册来帮助你在编辑维基的时候学习这种标记语言。

撰写,编辑和审阅

下面是给作者,编辑和审阅者的一个相对较长的MDC介绍。

Writers

The MDC is always interested in new content, so you're encouraged to write new articles on whatever topics we currently cover in the wiki. New content can be as simple as a one page tip or as complex as a book-length programming guide or reference. The amount of new content you contribute is entirely up to you.

Bugs in the Mozilla project's Bugzilla database that impact documentation should be tagged with the dev-doc-needed keyword. This is another great way to find items that may require documentation. Typically, only bugs for which changes have already been checked into the source code should be written up. When the required documentation changes have been made, the dev-doc-complete keyword should be added to the bug.

If you're going to undertake a large project, I suggest you join the MDC community and discuss it there first in case someone else is planning to start (or has already started) a similar project.

Refer to our writer's guide if you have questions about style or usage policies within the wiki.

编辑器

在这个 Wiki 中欢迎复制编辑,部分改进或纠正编写风格,语法或者拼写。 请查看我们的编者向导获取更多的信息。

Reviewers

Technical improvements and review are always welcome. If you're reading through a page and spot a technical error (be it in code or text), please feel free to correct it. If it is a controversial change, make a note in the "talk" page (accessed by clicking the "Discuss" link in the right-hand column) and leave a note that outlines your reasons for the change.

Writer's guide

We have a writer's guide outlining preferred writing style practices for the MDC wiki. If you have questions about usage and style that aren't covered there, I recommend referring to the Economist style guide or, failing that, the Chicago Manual of Style.

We will be expanding the guide over time, so if you have specific questions that aren't covered by the writer's guide, please send them to the MDC mailing list or developer documentation lead.

Migrating old documentation

One longer ongoing subproject at the MDC is to migrate all currently existing developer documentation from the mozilla.org web site into the MDC wiki. The procedure is fairly simple:

  1. Pick a document you would like to migrate from the existing content list.
  2. Refer to the page naming guide and decide what the page or pages for that document should be called in the wiki.
  3. Create those pages and migrate the content, marking it up as best you can using the wiki markup reference as a guide.
  4. Delete the item from the existing content list.
  5. Add the item to the needs redirect list.

If you're keen on doing a comprehensive job on this, you'll also:

  1. Use our search system to search for any links to the original document in the wiki, then change those links so they point at the new wiki page.
  2. Check for external redirects to the original document, and flag those redirects for deletion by putting them in the "Junk" category by adding [[Category:Junk]].

本地化MDC

如果你对帮助翻译MDC维基的任何文档到其它语言感兴趣,只需简单地访问相关语言的维基和创建或编辑页面。

现存的本地化项目

当前MDC有以下语言的维基: Català, 中文(简体), Deutsch, English, Français, Italiano, 日本語, Nederlands, Polski, Português, Español, 한국어, 中文(正體), Русский.

怎样开始一个新的本地化项目

如果你愿意开始一个语言的新的我们的维基当前不存在的本地化项目,请阅读本地化项目页面,跟着说明做。

Resolving "edit wars" or other conflicts

If for whatever reason you end up in an "edit war" on a page, where two or more people are continually and repeatedly making and reverting changes, please try to resolve the conflict with the people involved first.

Should no resolution be possible, please bring it to the attention of either (ideally) the MDC mailing list or (as a last resort) the developer documentation lead. Other technical experts, writers, and editors will be consulted as required, and their expertise will be used to resolve the problem.

Requesting page deletions

Should you create a page by accident or stumble across a page you think should be deleted, add it to the "Junk" category, by adding [[Category:Junk]] to the bottom of the page.

The Junk category is checked periodically by wiki administrators and the pages it contains are evaluated and deleted when appropriate.

Note: Please do not delete other content or categories from the pages you flag as "Junk".

Joining the MDC community

The Mozilla Developer Center is largely the handiwork of a group of volunteers, and we're always happy to help new writers and editors get involved.

Mailing list / newsgroup

  • View MDC forums...

{{template.DiscussionList("dev-mdc", "mozilla.dev.mdc")}}

IRC channel

We also hang out on the irc.mozilla.org server in the #devmo channel: #devmo on irc.mozilla.org.

Project lead

The MDC and developer documentation is overseen by Eric Shepherd.

{{ wiki.languages( { "fr": "Project:fr/Pour_commencer", "ja": "Project:ja/Getting_started", "pl": "Project:pl/Na_pocz\u0105tek", "pt": "Project:pt/Como_come\u00e7ar", "en": "Project:en/Getting_started" } ) }}

修订版来源

<p>
{{template.MDCProjectPagesTOC()}}
</p><p>帮助MDC就像使用你的浏览器一样简单。 如果你之前在网上填写过表单或者在一个文本框里面写过你的博客的话,你就有了开始为MDC做贡献的所有技能。
</p>
<h3 name=".E4.BB.8B.E7.BB.8D"> 介绍 </h3>
<p><b>我们鼓励您帮助撰写,编辑,审阅和翻译您在本维基中看到的任何文档。</b>  请用合作的心态来完成您的工作,不要因为别人修改或者改进了您的贡献而觉得沮丧。  我们为了努力使得Mozilla的文档更加完善,因此我们鼓励合作意识和相互帮助。
</p>
<h3 name=".E5.9F.BA.E7.A1.80"> 基础 </h3>
<p>下面是在MDC维基中创建和编辑页面的简短说明。你也可以在<a href="cn/%e6%b2%99%e7%ae%b1">沙箱</a>中练习这些技巧。
</p>
<h4 name=".E7.BC.96.E8.BE.91.E9.A1.B5.E9.9D.A2"> 编辑页面 </h4>
<p>在开始编辑页面之前,您需要创建一个维基帐号。你可以在<a href="Special:Userlogin">用户登录</a>页面填写并提交申请表格。在您创建成功一个帐号之后,您会自动登录并且可以开始编辑。
</p><p>在每一个页面的右侧你会找到一个"编辑"链接。 点击这个链接您就可以开始编辑当前的页面。在那里您可以修改并且预览您的修改,然后把那些修改保存到维基当中。当您保存了您的编辑之后,您马上就会看到页面的变化。<a href="cn/%e7%8e%b0%e5%9c%a8%e6%88%91%e7%bc%96%e8%be%91%e4%b8%80%e4%b8%8b">现在我编辑一下</a>
</p>
<h4 name=".E5.BC.80.E5.A7.8B.E4.B8.80.E4.B8.AA.E6.96.B0.E7.9A.84.E9.A1.B5.E9.9D.A2"> 开始一个新的页面 </h4>
<p>开始一个新页面的最简单的方法是在你的用户页面里建立一个链接,然后通过那个连接来进入新页面的“编辑”模式。
</p><p>你可以通过点击维基最上方的蓝色导航栏中的你的用户名进入你的用户页面。如果你还没有在你的用户页面上添加任何的内容,你会直接进入页面的编辑模式,然后你就可以任意地添加你喜欢的东西了。
</p><p>创建一个到页面的链接就想把标题写在方括号里面一样简单,像这样:<code><span class="plain">[[这是一个例子]]</span></code>。  当你保存的时候,那个就会变成一个链接,像这样:<a href="cn/%e8%bf%99%e6%98%af%e4%b8%80%e4%b8%aa%e4%be%8b%e5%ad%90">这是一个例子</a>。
</p><p>如果这个页面不存在,链接会是红色的。如果已经存在,链接会变成蓝色。如果你想创建的页面已经存在了,你应该试着去完善已经存在了的页面。否则你需要给你的页面另外找一个名字。
</p><p>当你想给你的新页面添加内容的时候,你可以单击刚才的红色链接然后就可以开始撰写了。记得点击编辑窗口下方的“保存本页”按钮来保存你的工作,尤其是你在编辑一个很长的文章的时候。
</p>
<h5 name=".E9.A1.B5.E9.9D.A2.E5.91.BD.E5.90.8D.E5.90.91.E5.AF.BC"> 页面命名向导 </h5>
<p>更多的关于创建和命名新页面的信息请参阅<a href="Project:cn/Page_Naming_Guide">命名向导</a>.
</p>
<h4 name=".E7.BB.B4.E5.9F.BA.E6.A0.87.E8.AE.B0"> 维基标记 </h4>
<p>如果你现在点击右侧边栏的“编辑”,你会看到这个页面的内容包含了很多特殊的字符。比如“==”标记在标题的两边,“[[]]”标记在链接的两边。这是维基系统中的一种非常简单的文字标注方法。这种表及系统的好处是非常易学而且出错之后非常容易改正。
</p>
<h5 name=".E7.BB.B4.E5.9F.BA.E6.A0.87.E8.AE.B0.E5.8F.82.E8.80.83"> 维基标记参考 </h5>
<p>我们有一个完整的<a href="Project:cn/Wiki_Markup_Reference">维基标记参考手册</a>来帮助你在编辑维基的时候学习这种标记语言。
</p>
<h3 name=".E6.92.B0.E5.86.99.EF.BC.8C.E7.BC.96.E8.BE.91.E5.92.8C.E5.AE.A1.E9.98.85"> 撰写,编辑和审阅 </h3>
<p>下面是给作者,编辑和审阅者的一个相对较长的MDC介绍。
</p>
<h4 name="Writers"> Writers </h4>
<p>The MDC is always interested in new content, so you're encouraged to write new articles on whatever <a href="Special:Tags?tag=All_Categories&amp;language=zh-cn">topics</a> we currently cover in the wiki. New content can be as simple as a one page tip or as complex as a book-length programming guide or reference.  The amount of new content you contribute is entirely up to you.
</p><p>Bugs in the Mozilla project's <a class="external" href="http://bugzilla.mozilla.org">Bugzilla database</a> that impact documentation should be tagged with the <code>dev-doc-needed</code> keyword.  This is another great way to find items that may require documentation. Typically, only bugs for which changes have already been checked into the source code should be written up. When the required documentation changes have been made, the <code>dev-doc-complete</code> keyword should be added to the bug.
</p><p>If you're going to undertake a large project, I suggest you join the <a href="Project:cn/Getting_started#Joining_the_MDC_community">MDC community</a> and discuss it there first in case someone else is planning to start (or has already started) a similar project.
</p><p>Refer to our <a href="Project:cn/Writer's_guide">writer's guide</a> if you have questions about style or usage policies within the wiki.
</p>
<h4 name=".E7.BC.96.E8.BE.91.E5.99.A8"> 编辑器 </h4>
<p>在这个 Wiki 中欢迎复制编辑,部分改进或纠正编写风格,语法或者拼写。  请查看我们的<a href="Project:cn/Writer's_guide">编者向导</a>获取更多的信息。
</p>
<h4 name="Reviewers"> Reviewers </h4>
<p>Technical improvements and review are always welcome. If you're reading through a page and spot a technical error (be it in code or text), please feel free to correct it.  If it is a controversial change, make a note in the "talk" page (accessed by clicking the "Discuss" link in the right-hand column) and leave a note that outlines your reasons for the change.
</p>
<h4 name="Writer.27s_guide"> Writer's guide </h4>
<p>We have a <a href="Project:cn/Writer's_guide">writer's guide</a> outlining preferred writing style practices for the MDC wiki.  If you have questions about usage and style that aren't covered there, I recommend referring to the <a class="external" href="http://www.economist.com/research/StyleGuide/">Economist style guide</a> or, failing that, the <a class="external" href="http://www.amazon.com/gp/product/0226104036/">Chicago Manual of Style</a>.
</p><p>We will be expanding the guide over time, so if you have specific questions that aren't covered by the <a href="Project:cn/Writer's_guide">writer's guide</a>, please send them to the <a href="Project:cn/Community">MDC mailing list</a> or <a href="User:Sheppy">developer documentation lead</a>.
</p>
<h3 name="Migrating_old_documentation"> Migrating old documentation </h3>
<p>One longer ongoing subproject at the MDC is to migrate all currently existing developer documentation from the <a class="external" href="http://www.mozilla.org">mozilla.org</a> web site into the MDC wiki.  The procedure is fairly simple:
</p>
<ol><li> Pick a document you would like to migrate from the <a href="Project:cn/Existing_Content">existing content</a> list.
</li><li> Refer to the <a href="Project:cn/Page_Naming_Guide">page naming guide</a> and decide what the page or pages for that document should be called in the wiki.
</li><li> Create those pages and migrate the content, marking it up as best you can using the <a href="Project:cn/Wiki_Markup_Reference">wiki markup reference</a> as a guide.
</li><li> Delete the item from the <a href="Project:cn/Existing_Content">existing content</a> list.
</li><li> Add the item to the <a href="Project:cn/Needs_Redirect">needs redirect</a> list.
</li></ol>
<p>If you're keen on doing a comprehensive job on this, you'll also:
</p>
<ol><li> Use <a class="external" href="http://search.developer.mozilla.org">our search system</a> to search for any links to the original document in the wiki, then change those links so they point at the new wiki page.
</li><li> Check for <a href="Project:cn/External_Redirects">external redirects</a> to the original document, and flag those redirects for deletion by putting them in the "Junk" category by adding <code><span class="plain">[[Category:Junk]]</span></code>.
</li></ol>
<h3 name=".E6.9C.AC.E5.9C.B0.E5.8C.96MDC"> 本地化MDC </h3>
<p>如果你对帮助翻译MDC维基的任何文档到其它语言感兴趣,只需简单地访问相关语言的维基和创建或编辑页面。
</p>
<h4 name=".E7.8E.B0.E5.AD.98.E7.9A.84.E6.9C.AC.E5.9C.B0.E5.8C.96.E9.A1.B9.E7.9B.AE"> 现存的本地化项目 </h4>
<p>当前MDC有以下语言的维基:
<a class="external" href="http://developer.mozilla.org/ca/docs/">Català</a>,
<a class="external" href="http://developer.mozilla.org/cn/docs/">中文(简体)</a>,
<a class="external" href="http://developer.mozilla.org/de/docs/">Deutsch</a>,
<a class="external" href="http://developer.mozilla.org/en/docs/">English</a>,
<a class="external" href="http://developer.mozilla.org/fr/docs/">Français</a>,
<a class="external" href="http://developer.mozilla.org/it/docs/">Italiano</a>,
<a class="external" href="http://developer.mozilla.org/ja/docs/">日本語</a>,
<a class="external" href="http://developer.mozilla.org/nl/docs/">Nederlands</a>,
<a class="external" href="http://developer.mozilla.org/pl/docs/">Polski</a>,
<a class="external" href="http://developer.mozilla.org/pt/docs/">Português</a>,
<a class="external" href="http://developer.mozilla.org/es/docs/">Español</a>,
<a class="external" href="http://developer.mozilla.org/ko/docs/">한국어</a>,
<a class="external" href="http://developer.mozilla.org/zh_tw/docs/">中文(正體)</a>,
<a class="external" href="http://developer.mozilla.org/ru/docs/">Русский</a>.
</p>
<h4 name=".E6.80.8E.E6.A0.B7.E5.BC.80.E5.A7.8B.E4.B8.80.E4.B8.AA.E6.96.B0.E7.9A.84.E6.9C.AC.E5.9C.B0.E5.8C.96.E9.A1.B9.E7.9B.AE"> 怎样开始一个新的本地化项目 </h4>
<p>如果你愿意开始一个语言的新的我们的维基当前不存在的本地化项目,请阅读<a href="Project:cn/%e6%9c%ac%e5%9c%b0%e5%8c%96%e9%a1%b9%e7%9b%ae">本地化项目</a>页面,跟着说明做。
</p>
<h3 name="Resolving_.22edit_wars.22_or_other_conflicts"> Resolving "edit wars" or other conflicts </h3>
<p>If for whatever reason you end up in an "edit war" on a page, where two or more people are continually and repeatedly making and reverting changes, please try to resolve the conflict with the people involved first.  
</p><p>Should no resolution be possible, please bring it to the attention of either (ideally) the <a href="Project:cn/Community">MDC mailing list</a> or (as a last resort) the <a href="User:Sheppy">developer documentation lead</a>.  Other technical experts, writers, and editors will be consulted as required, and their expertise will be used to resolve the problem.
</p>
<h3 name="Requesting_page_deletions"> Requesting page deletions </h3>
<p>Should you create a page by accident or stumble across a page you think should be deleted, add it to the "Junk" category, by adding <code><span class="plain">[[Category:Junk]]</span></code> to the bottom of the page.
</p><p>The <a href="Special:Tags?tag=Junk&amp;language=zh-cn">Junk category</a> is checked periodically by wiki administrators and the pages it contains are evaluated and deleted when appropriate.
</p><p><b>Note</b>: Please do not delete other content or categories from the pages you flag as "Junk".
</p>
<h3 name="Joining_the_MDC_community"> Joining the MDC community </h3>
<p>The Mozilla Developer Center is largely the handiwork of a group of volunteers, and we're always happy to help new writers and editors get involved.
</p>
<h4 name="Mailing_list_.2F_newsgroup"> Mailing list / newsgroup </h4>
<ul><li> View MDC forums...
</li></ul>
<p>{{template.DiscussionList("dev-mdc", "mozilla.dev.mdc")}}
</p>
<h4 name="IRC_channel"> IRC channel </h4>
<p>We also hang out on the irc.mozilla.org server in the #devmo channel: <a class="external" href="irc://irc.mozilla.org/devmo">#devmo on irc.mozilla.org</a>.
</p>
<h4 name="Project_lead"> Project lead </h4>
<p>The MDC and developer documentation is overseen by <a class="external" href="mailto:eshepherd@mozilla.com">Eric Shepherd</a>.
</p>{{ wiki.languages( { "fr": "Project:fr/Pour_commencer", "ja": "Project:ja/Getting_started", "pl": "Project:pl/Na_pocz\u0105tek", "pt": "Project:pt/Como_come\u00e7ar", "en": "Project:en/Getting_started" } ) }}
恢复到这个版本