Codex规范:修订间差异

来自站长百科
跳转至: 导航、​ 搜索
第51行: 第51行:


==讨论==
==讨论==
===使用 "Talk" 页面===
如果发现不正确或表达清晰的内容,可使用DISCUSSION提交留言。请不要在文章页面直接添加评论。在每个页面都有一个DISCUSSION tab,你可以在此评论,提出建议或留言。谢谢合作!
*'''给文章留言''': 可点击文章的Discussion标签,在上面留言然后署名提交。
*'''给用户留言''': 可编辑 用户:谈论页面 ,并署名。用户下次登陆时就会收到留言提示。
*'''分离评论''': 在讨论页面,请在评论之间使用四个破折号---- 以把它和其它内容区分开。如果你准备讨论新话题,可点击编辑旁的"+"链接以创建新内容。
*'''记得署名''': 留言或评论后,请记得署名,并在评论末尾添加四个~。这会显示你的用户名,用户页面链接和时间戳——这对讨论页面非常有用。还可以点击编辑窗口顶端的署名图标,即右侧第二个图标。
==Codex 声音, 格式和读者==
==Codex 声音, 格式和读者==
==惯用名称==
==惯用名称==

2010年1月28日 (四) 16:58的版本

导航: 上一页 | 首页 | WordPress中文论坛 | WordPress主机 | CMS程序 | 论坛程序 | ECShop | ShopNC | PowerEasy

欢迎光临! 本篇文章简要介绍了对Codex编辑者和志愿者的建议规范。如果你有更好的改进建议,欢迎到WordPress文档邮件列表上留言。

Meta(元数据)规则

  1. 正确拼写WordPress——WordPress
  2. 保持友好态度 - 禁止进行个人攻击或其它粗鲁行为。请保持专业,礼貌和耐心。
  3. 保证发布内容正确,及时且要经常更新。
  4. 尽情编辑,合理编辑。
  5. 如果有疑问,请提出来解决,不要保持沉默。
  6. 玩得开心! :)

标准规范

新页面

我们鼓励并欢迎大家创建新的文章和页面。同时,请大家遵循以下规范。

以下是协助开发Codex需要遵循的规范:

  1. 如果Codex中存在和你想编辑内容类似的文章,请直接修改已有文章。
  2. 请在沙盒 页面进行编辑试验。
  3. 请在创建的新页面上添加Codex其它文章链接。
  4. 请确保所创建的文章是完整的,其中的链接是含有有效内容的。
  5. 文章编辑完成后,发布到Codex文档时,请给文章添加分目录和其它相关文章链接。确保自己知道具体应该给哪部分文字添加分目录链接。另外,只有在得到文档团队的#允许后才能把链接放在文档的主页面。

使用以下 "stubs"以指明文章的状态:

  • { {Stub}} : Stub 表明文章不完整,有待进一步编辑和扩展。
  • { {Draft}}:确保把这个标记放在页面顶端。由于搜索引擎会搜索所有添加页面,Draft 标记会提醒其它用户这篇文章正在编辑中,其中的信息可能并不正确,同时也能提醒他人在你编辑完成前不要插手编辑。
  • [ [Category:New page created]]:用来指明页面是新建页面,它能吸引编辑者。但除非你已准备编辑或把它从用户页面移到文档中,否则请不要使用这个标记。
  • { {Copyedit}}:Copyedit 表明文章已大体完成,但需要再次审核一下。对尚未完成的文章,请使用{ {Stub}}。

标题

Ruby

所有标题都应该使用标题字体。例如,对于标题,应该使用"Using the Links Manager", 而非"Using the links manager" 。而且,标题应该完整,不要缩写,如,应使用"Introduction to Blogs",而非"IntroToBlogs"。

关于大小写,还需要遵循 Dr. Grammar规则,"标题应大写第一个单词,最后一个单词,及中间除冠词(a, an, 和the),五个字母以下的介词(in, of, to)和连词(and, but)之外的所有单词。这个规则适用于所有标题。 (Anson, Schwegler, and Muth. The Longman Writer's Companion 240)

  1. 标题应以行为或任务为导向,它也是用户查询信息时可能会使用的搜索关键词,因此,"Using the Links Manager"比"The Links Manager"更能说明文章内容。
  2. 在标题的开头或结尾部分,在单词之间不要使用不必要的空格。尽量避免使用"-", "#", "?" 和 "+"等类似符号。
  3. 标题越短越好。
  4. 尽量避免在标题中使用介词。
  5. Codex是关于WordPress的wiki,因此,标题中应尽量包含"WordPress" 。
  6. 若不确信标题是否合适,可发邮件给文档团队以征询意见。
  7. 标题不要使用CamelCase(骆驼拼写法):Codex不使用CamelCase。所有的页面标题和标题链接都使用常规的标题字体。例如,关于Codex的页面标题应为"About Codex", 它的链接格式为:[ [About Codex]],而不是CamelCase [ [AboutCodex]].

子页面

在没有和wp文档团队讨论之前,请不要创建子页面(用户页面除外)。常用函数页面可以自主创建子页面(每个子页面描述了一种函数。)。

讨论

使用 "Talk" 页面

如果发现不正确或表达清晰的内容,可使用DISCUSSION提交留言。请不要在文章页面直接添加评论。在每个页面都有一个DISCUSSION tab,你可以在此评论,提出建议或留言。谢谢合作!

  • 给文章留言: 可点击文章的Discussion标签,在上面留言然后署名提交。
  • 给用户留言: 可编辑 用户:谈论页面 ,并署名。用户下次登陆时就会收到留言提示。
  • 分离评论: 在讨论页面,请在评论之间使用四个破折号---- 以把它和其它内容区分开。如果你准备讨论新话题,可点击编辑旁的"+"链接以创建新内容。
  • 记得署名: 留言或评论后,请记得署名,并在评论末尾添加四个~。这会显示你的用户名,用户页面链接和时间戳——这对讨论页面非常有用。还可以点击编辑窗口顶端的署名图标,即右侧第二个图标。

Codex 声音, 格式和读者

惯用名称

相关条目