Visit Mozilla.org

MDC:现在就开始

From MDC

帮助目录
列表
文档请求列表
Editing/review to do list
合并列表
指导
现在就开始
编者向导
页面命名指南
消歧义页
开始一项新的mdc本地化项目
版权和许可
参考
维基语法参考
自定义 CSS 类
自定义模板
MediaWiki 扩展
外部重定向
需要重定向

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

目录

[编辑] 介绍

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

[编辑] 基础

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

[编辑] 编辑页面

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

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

[编辑] 开始一个新的页面

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

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

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

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

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

[编辑] 页面命名向导

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

[编辑] 维基标记

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

[编辑] 维基标记参考

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

[编辑] 撰写,编辑和审阅

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

[编辑] 撰写者

MDC一直对新内容感兴趣,因此你被鼓励写任何关于当前维基涵盖的主题的新文章。新内容可以像一页的量那样简单或一本书编程指导或参考书的长度那样复杂。你贡献的新内容的量完全取决于你。

Mozilla项目的Bugzilla数据库中十分影响文档的缺陷应该使用dev-doc-needed关键字标记。这是另一个发现需要文档的项目的好方法。具有典型的是,只应该写入在源代码中检查到变化的缺陷。当需要的文档已经做了改变,dev-doc-complete关键字应该被添加到缺陷。

如果你正准备着手一个大的项目,我建议你加入MDC社区,先在那儿讨论它,以防其他人正打算开始(或已经开始)相似的项目。

参考我们的编者向导,如果你有关于维基内风格或使用的策略的问题。

[编辑] 编辑者

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

[编辑] 审阅者

技术改进和检查总是欢迎的。如果你通读了一页,发现了一个技术错误(它在代码或文本中),请自由地改正它。如果是有争议的更改,请在“讨论”页上做个注释(点击右边栏目中的“讨论”链接进入),简要的说明改动的原因。

[编辑] 编者向导

我们有一个编者向导概括说明了MDC维基的首选写作风格习惯。如果你有关于使用和风格方面的未涵盖的问题,我推荐你参考经济学家风格指南,除此之外还有芝加哥风格手册

我们一直在扩充指南,因此如果你有特别的编者向导未涵盖的问题,请把它们发送到邮件列表开发文档领导

[编辑] 转移旧的文档

MDC上一个正在进行的长期的子项目是,把当前存在的开发文档从mozilla.org网站转移到MDC维基。这个过程相当简单:

  1. 现存内容列表选择一个你想转移的文档。
  2. 参照页面命名指南,对于那些文档确定在维基中哪些页面被调用。
  3. 创建这些页面以及转移内容,尽可能使用维基标记参考标记它作为说明。
  4. 现存内容列表中删除这项。
  5. 添加这项到需要重定向列表.

如果你持续做关于此的广泛的工作,你也将:

  1. 使用我们的搜索系统搜索维基中原始文档的任何链接,然后更改那些链接以便它们指向新的维基页面。
  2. 检查原始文档的外部重定向,通过添加[[Category:Junk]]把它们放到“垃圾”目录来标记那些重定向为删除。

[编辑] 本地化MDC

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

[编辑] 现存的本地化项目

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

[编辑] 怎样开始一个新的本地化项目

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

[编辑] 解决“编辑冲突”和其它冲突

如果由于任何原因你在一个页面上遇到了“编辑冲突”,即两个或多个人连续地和重复地做改动和恢复,请尝试与第一个参与的人解决冲突。

万一没有可行的解决方案,请把它交给邮件列表(理想的)或者开发文档领导(作为最后手段)。将会在必要时咨询其它技术专家、撰写者和编辑者,他们的专业经验将用来解决问题。

[编辑] 请求删除页面

万一你偶然或者错误地在页面上创建了一个你认为应该删除的页面,通过添加[[Category:Junk]]到页面的底部把它添加到“垃圾”目录。

垃圾目录由维基管理员定期地检查,它包含的页面在评估后,如果合适就被删除。

注意:请不要从你标记为“垃圾”的页面上删除其它的内容和目录。

[编辑] 加入MDC社区

Mozilla开发中心主要是一群志愿者手工劳动的结果,我们一直很高兴帮助新的撰写者和编辑者参与进来。

[编辑] 邮件列表 / 新闻组

[编辑] IRC频道

我们在irc.mozilla.org服务器的#devmo频道也上线了: #devmo on irc.mozilla.org.

[编辑] 项目领导

MDC和开发文档由Eric Shepherd监督。