Project:编者向导

3 位贡献者:

本篇编者向导说明了 Mozilla 开发者中心自己的文档风格。本文只是作为一套友好的指导方针,而非严格规则,因此您完全可以忽略这里介绍的内容。然而,如果有后来的志愿者修改了您的文章以便符合本文的仿真,希望不会造成您的惊讶或反感。

当然,本指导遵从英文 MDC wiki 的主要原则。其他语言的 wiki 完全可以(也非常欢迎)创建适合他们自己的编者向导。

首选风格向导

如果关于用法和风格转换上出现问题,我建议参考经济学家风格或者芝加哥风格的说明。

首选字典

关于拼写的问题,请参阅Answers.com。请不要使用变种的拼写(如, 推荐使用 honor ,而非 honour )。

我们会经常更新本向导,所以如果您有什么特殊的问题在本文没有找到相关答案,请发送到MDC mailing list或者project lead以便我们更新和说明。

页命名和首字母大写

  • 页面名称和章节标题应该遵循句子风格的大写标准,(只有首字母和专有名词使用大写)而不是标题风格的大写规则:
    • 正确: "A new method for creating JavaScript rollovers"
    • 错误: "A New Method for Creating JavaScript Rollovers"
以上大写规则仅适用于命名新创建的页面。我们现有的wiki内容中有大量页面不遵守以上规则, 现在请不要纠正这些错误。以后我们会按照以上规则纠正这些错误的。谢谢。 -- dria 09:20, 14 March 2006 (PST)

拉丁文缩写

注释和括号中的内容

  • 在附加说明和注释中,可能使用一些常见的拉丁文缩写(etc.,i.e.,e.g.)。请用括号把这些内容扩起来。
    • 正确: Web browsers (e.g. Firefox) can be used ...
    • 错误: Web browsers e.g. Firefox can be used ...
    • 错误: Web browsers, e.g. Firefox, can be used ...
    • 错误: Web browsers, (eg: Firefox) can be used ...

简写内容

  • 在表达一些同类内容时,请使用自然语言的表达方式,而不要使用缩写。例如:
    • 正确: ... web browsers, and so on.
    • 错误: ... web browsers, etc.
    • 正确: Web browsers such as Firefox can be used ...
    • 错误: Web browsers e.g. Firefox can be used ...

拉丁缩写与英语意义对照

Abbrev Latin English
cf. confer compare
e.g. exempli gratia for example
et al. et alii and others
etc. et cetera and so forth, and so on
i.e. id est that is, in other words
N.B. nota bene note well
P.S. post scriptum postscript

注意,在使用"e.g."和"i.e."的时候要避免混淆。

缩写和首字母缩写

首字母大写和省略内容

  • 使用全部首字母的大写形式,并去掉全部被省略内容及省略符号,包括组织名称,如"US"和"UN"。
    • 正确: XUL
    • 错误: X.U.L.; Xul

全称介绍

  • 在一篇文章中第一次用到一个缩写形式时,请在括号内标明全程的介绍。
    • 正确: "XUL (XML User Interface Language) is Mozilla's XML-based language..."
    • 错误: "XUL is Mozilla's XML-based language..."
例外
  • 只有用户不常用的缩写才要进行更多的说明。如果可以的话,当然还是提供一个有详细说明内容的链接是更好的方法。

缩写的复数形式

  • 缩写的单词在表达复数形式时,需要加一个s。
    • 正确: CD-ROMs
    • 错误: CD-ROM's

简写

  • 使用简单拼写方法是完全可以的(例如 "don't", "can't", "shouldn't")。

复数

  • 要使用英语的复数形式,而不要用拉丁或者希腊文那些形式。
    • 正确: syllabuses, octopuses
    • 错误: syllabi, octopi

连字符

  • 连字符用在前缀的最后一个元音字母之后。Hyphenate compounds in which the last letter of a prefix ending in a vowel is the same as the first letter of the root.
    • 正确: email, re-elect, co-op
    • 错误: e-mail, reelect, coop

名词和数字

The date stuff here may change.

日期

  • 日期格式应该形如:January 1, 1990。
    • 正确: February 24, 2006
    • 错误: February 24th, 2006; 24 February, 2006; 24/02/2006
  • 数字日期格式应该形如:YYYY/MM/DD。
    • 正确: 2006/02/24
    • 错误: 02/24/2006; 24/02/2006; 02/24/06

年代(十年)

  • 表达年代,如20世纪90年代,应该形如: 1990s.
    • 正确: 1990s
    • 错误: 1990's

复数和数词

  • 数字名词的复数后面也应该加 s .
    • 正确: 486s
    • 错误: 486's

逗号

  • 行文中,只在当数字长于或等于5位时使用逗号。
    • 正确: 4000; 54,000
    • 错误: 4,000; 54000

标点

连续逗号

  • 使用多个逗号的情况。如果需要表达一系列相同内容的时候,在最后的‘and’之前应该放一个逗号。
    • 正确: I will travel on trains, planes, and automobiles.
    • 错误: I will travel on trains, planes and automobiles.

拼写

  • 尽量避免变种的拼写(通假字也是错别字,要避免),英文拼写请参考Answers.com
    • 正确: localize, honor
    • 错误: localise, honour

其他资源

如果您对提升自己的写作和编辑技巧有兴趣,请访问下列资源。

文档标签和贡献者

向此页面作出贡献: teoli, alzhu, Mhoudg
最后编辑者: teoli,