WordPress: Codex:Guidelines:修订间差异
无编辑摘要 |
无编辑摘要 |
||
第36行: | 第36行: | ||
#一旦网页创建好了,这些网页就可以运行了,而且任何链接连接到这些网页都可以运行。当一个用户点击到了一个空白的网页的时候,他们浪费了时间。'''当你有非常完整而正确的内容的时候,再创建网页。''' | #一旦网页创建好了,这些网页就可以运行了,而且任何链接连接到这些网页都可以运行。当一个用户点击到了一个空白的网页的时候,他们浪费了时间。'''当你有非常完整而正确的内容的时候,再创建网页。''' | ||
#链接一旦完成了并且移到了来自你的用户网页的文件中,链接必须制作在内容的"子"表格和新的文章上的其它的相关文件中。想一下你自己是不是不确定可以在内容子表格的哪里创建一个链接。在没有[[WordPress:Documentation team|文件小组]]的允许下,不要将一个链接放到[[WordPress:Main Page|主页]]中。 | #链接一旦完成了并且移到了来自你的用户网页的文件中,链接必须制作在内容的"子"表格和新的文章上的其它的相关文件中。想一下你自己是不是不确定可以在内容子表格的哪里创建一个链接。在没有[[WordPress:Documentation team|文件小组]]的允许下,不要将一个链接放到[[WordPress:Main Page|主页]]中。 | ||
使用以下的"stubs",类别,这些指定了一篇文章所处的状态: | 使用以下的"stubs",类别,这些指定了一篇文章所处的状态: | ||
;<nowiki>{{Stub}}</nowiki> : '''Stub'''将网页归类为'''未完成的''',需要编辑和扩充。 | ;<nowiki>{{Stub}}</nowiki> : '''Stub'''将网页归类为'''未完成的''',需要编辑和扩充。 | ||
;<nowiki>{{草稿}</nowiki> :将这个放到网页的顶上方。所有添加的网页都会被搜索引擎仔细检查。网页的顶上方的'''草稿''',会提醒他人这个网页正在进展之中,网页上的信息可能是不正确的,而且还会警醒他人在你完成这个网页之前,不要编辑这个网页。 | ;<nowiki>{{草稿}</nowiki> :将这个放到网页的顶上方。所有添加的网页都会被搜索引擎仔细检查。网页的顶上方的'''草稿''',会提醒他人这个网页正在进展之中,网页上的信息可能是不正确的,而且还会警醒他人在你完成这个网页之前,不要编辑这个网页。 | ||
;<nowiki>[[WordPress:Category:New page created|类别:创建的新的网页]]</nowiki> :将一个网页定义为新的,会引起编辑的注意。不要将网页定义为新的,除非你已经开始编辑了和/或者将文章从你的用户网页的总文件中移除出去了。 | ;<nowiki>[[WordPress:Category:New page created|类别:创建的新的网页]]</nowiki> :将一个网页定义为新的,会引起编辑的注意。不要将网页定义为新的,除非你已经开始编辑了和/或者将文章从你的用户网页的总文件中移除出去了。 | ||
;<nowiki>{{副本编辑}}</nowiki> :'''副本编辑'''指出了这篇文章需要操作,通常是需要大致的浏览和编辑。指出了文章已经完成了但是需要进一步处理。对于未完成的文章,使用<nowiki>{{Stub}}</nowiki>。 | ;<nowiki>{{副本编辑}}</nowiki> :'''副本编辑'''指出了这篇文章需要操作,通常是需要大致的浏览和编辑。指出了文章已经完成了但是需要进一步处理。对于未完成的文章,使用<nowiki>{{Stub}}</nowiki>。 | ||
=== 标题 === | === 标题 === | ||
'''新的网页的标题应该位于标题Case中。''' | '''新的网页的标题应该位于标题Case中。''' | ||
所有的标题都必须在Title Case中。例如,使用"Using the Links Manager" 而不是"Using the links manager"(注:前后意思都是使用链接管理器,但是格式不同)。这些应该是完整的标题。不是Not "IntroToBlogs" 而是 "Introduction to Blogs"(注:意思相同,都是博客介绍说明,只是后者的格式应用于标题之中) | 所有的标题都必须在Title Case中。例如,使用"Using the Links Manager" 而不是"Using the links manager"(注:前后意思都是使用链接管理器,但是格式不同)。这些应该是完整的标题。不是Not "IntroToBlogs" 而是 "Introduction to Blogs"(注:意思相同,都是博客介绍说明,只是后者的格式应用于标题之中) | ||
他们也应该遵循Dr. Grammar关于大写的规则:''"在标题中,要大写第一个单词,最后一个单词,以及中间的所有单词,除了冠词 (a, an, and the), 少于五个字母的介词 (in, of, to), 和并列连词 (and, but)。这些规则适用于长的标题,短的标题,部分标题以及你自己的文章。 "'' ''(Anson, Schwegler, 和Muth. The Longman Writer's Companion 240)'' | 他们也应该遵循Dr. Grammar关于大写的规则:''"在标题中,要大写第一个单词,最后一个单词,以及中间的所有单词,除了冠词 (a, an, and the), 少于五个字母的介词 (in, of, to), 和并列连词 (and, but)。这些规则适用于长的标题,短的标题,部分标题以及你自己的文章。 "'' ''(Anson, Schwegler, 和Muth. The Longman Writer's Companion 240)'' | ||
#标题是任何时候可能的情况下,导向的活动或者任务。因此,例如,"使用链接管理器" 比 "链接管理器"作为一个标题,更好。当用户查找信息的时候,他会使用什么样的搜素词? | #标题是任何时候可能的情况下,导向的活动或者任务。因此,例如,"使用链接管理器" 比 "链接管理器"作为一个标题,更好。当用户查找信息的时候,他会使用什么样的搜素词? | ||
#标题不应该有开头的或者拖尾的空格,或者标题的单词之间也不应该有不必要的空格。试着避免使用符号像"-", "#", "?" and "+" | #标题不应该有开头的或者拖尾的空格,或者标题的单词之间也不应该有不必要的空格。试着避免使用符号像"-", "#", "?" and "+" | ||
#标题越短越好 | #标题越短越好 | ||
#请尽量在标题中避免使用介词。 | #请尽量在标题中避免使用介词。 | ||
#Codex是完全给WordPress专用的一个wiki,因此Codex的标题中含有"WordPress"很正常。 | #Codex是完全给WordPress专用的一个wiki,因此Codex的标题中含有"WordPress"很正常。 | ||
#当对标题名称的合适性有疑问的时候,给[[WordPress:Mailing_Lists#docs|wp-docs 列表]]写邮件,寻求建议 | #当对标题名称的合适性有疑问的时候,给[[WordPress:Mailing_Lists#docs|wp-docs 列表]]写邮件,寻求建议 | ||
#不要为网页标题使用'''CamelCase''':Codex并不像其它的wikis那样,使用CamelCase。所有的网页标题和链接都应该是通常的标题case。例如,关于Codex的网页的标题应该是"关于Codex",链接的形式是:<code><nowiki>[[WordPress:About Codex|关于Codex]]</nowiki></code> 而不是 CamelCase <code><nowiki>[[WordPress:AboutCodex| AboutCodex]]</nowiki></code>. | #不要为网页标题使用'''CamelCase''':Codex并不像其它的wikis那样,使用CamelCase。所有的网页标题和链接都应该是通常的标题case。例如,关于Codex的网页的标题应该是"关于Codex",链接的形式是:<code><nowiki>[[WordPress:About Codex|关于Codex]]</nowiki></code> 而不是 CamelCase <code><nowiki>[[WordPress:AboutCodex| AboutCodex]]</nowiki></code>. | ||
===子网页=== | ===子网页=== | ||
不要创建一个网页的子网页,除非这个网页是来自你自己的用户网页,而且没有首先在wp-docs邮件列表上讨论过。 | 不要创建一个网页的子网页,除非这个网页是来自你自己的用户网页,而且没有首先在wp-docs邮件列表上讨论过。 | ||
===讨论=== | ===讨论=== | ||
'''使用 "谈话"网页''' | '''使用 "谈话"网页''' | ||
你是不是看到了一些内容,这些内容可能是不正确的,或者需要澄清?提及任何问题的最好方法是使用讨论功能。 | 你是不是看到了一些内容,这些内容可能是不正确的,或者需要澄清?提及任何问题的最好方法是使用讨论功能。 | ||
#'''留下关于文章的信息:'''要留下关于文章的信息,点击那篇文章的'''讨论'''标签,发送你的信息并且署名。 | #'''留下关于文章的信息:'''要留下关于文章的信息,点击那篇文章的'''讨论'''标签,发送你的信息并且署名。 | ||
#'''给用户留下信息:'''通过编辑用户:与用户联合的谈论网页来给用户留下一个信息。并且署名。用户下一次访问Codex并且登录的时候,就会收到一个可以看到的提示。 | #'''给用户留下信息:'''通过编辑用户:与用户联合的谈论网页来给用户留下一个信息。并且署名。用户下一次访问Codex并且登录的时候,就会收到一个可以看到的提示。 | ||
#'''分开评论:'''通过在文章中使用四个破折号<nowiki>----</nowiki>,在讨论网页的评论之间创建一个水平方向的破折号。如果你开始了一个新的谈话主题,考虑在编辑后面使用"+"链接,这会使你创建一个新的部分。 | #'''分开评论:'''通过在文章中使用四个破折号<nowiki>----</nowiki>,在讨论网页的评论之间创建一个水平方向的破折号。如果你开始了一个新的谈话主题,考虑在编辑后面使用"+"链接,这会使你创建一个新的部分。 | ||
#'''经常给你的评论签名:'''要将你的"署名"添加到一个评论上,在你的评论的后面添加上四个~s (tildes)。这个会列出你的用户名和一个链接连接到你的用户网页并且添加一个时间标记。这对讨论网页非常地有用。另一种方法是点击编辑窗口顶上方的署名图标…这是从右开始数的第二个图标。 | #'''经常给你的评论签名:'''要将你的"署名"添加到一个评论上,在你的评论的后面添加上四个~s (tildes)。这个会列出你的用户名和一个链接连接到你的用户网页并且添加一个时间标记。这对讨论网页非常地有用。另一种方法是点击编辑窗口顶上方的署名图标…这是从右开始数的第二个图标。 | ||
===Codex 声音, 样式, 和听众=== | ===Codex 声音, 样式, 和听众=== | ||
WordPress Codex的"声音"是权威的一种,但也是一个友好的谈话。Codex的样式是要在有可能的情况下,提供简单的而且便于使用的解释,在需要的情况下,提供技术建议,通过这样做来起到培训的作用。 | |||
WordPress Codex的"声音" | |||
一般来说,文章是写给'''读者'''的,带着读者经历一个阅读的过程。人称代词"我"很少用到,突出于"你点击这儿" 和 "你打开模板文件"。.这并不是关于你,这个作者,在这个决定之后做了什么,也不是关于那些帮你成功的人。这是关于用户需要做什么来使他们的WordPress站点发展并且更加快速地运行。 | 一般来说,文章是写给'''读者'''的,带着读者经历一个阅读的过程。人称代词"我"很少用到,突出于"你点击这儿" 和 "你打开模板文件"。.这并不是关于你,这个作者,在这个决定之后做了什么,也不是关于那些帮你成功的人。这是关于用户需要做什么来使他们的WordPress站点发展并且更加快速地运行。 | ||
Bullets符号和列表是用来突出那些需要略述和列出那个过程的步骤。复杂的任务被分解为一些小的步骤,来指导新手和高级用户迅速地得到解决方案。 | Bullets符号和列表是用来突出那些需要略述和列出那个过程的步骤。复杂的任务被分解为一些小的步骤,来指导新手和高级用户迅速地得到解决方案。 | ||
观众的能力和掌握HMTL, XHTML, CSS, 和PHP的技术差别很大。[[WordPress:Advanced Topics|高级主题]] 和[[WordPress:Developer Documentation|开发者文件]]是针对有经验的用户的。[[WordPress:WordPress Lessons|WordPress课程]]是针对新手的,作者使用的语言描述,让人读起来感觉作者就是一个技术支持志愿者,和用户一起坐在电脑的旁边,指导用户这个过程。Codex的其余部分是针对初学者到中等级别的用户,应该包含简单的语言,如果需要的话,有链接到[[WordPress:Glossary|术语表]]中的术语定义。 | 观众的能力和掌握HMTL, XHTML, CSS, 和PHP的技术差别很大。[[WordPress:Advanced Topics|高级主题]] 和[[WordPress:Developer Documentation|开发者文件]]是针对有经验的用户的。[[WordPress:WordPress Lessons|WordPress课程]]是针对新手的,作者使用的语言描述,让人读起来感觉作者就是一个技术支持志愿者,和用户一起坐在电脑的旁边,指导用户这个过程。Codex的其余部分是针对初学者到中等级别的用户,应该包含简单的语言,如果需要的话,有链接到[[WordPress:Glossary|术语表]]中的术语定义。 | ||
===惯例=== | ===惯例=== | ||
#'''网站例子名称:'''当你想将一个域作为一个例子的时候,你通过可以使用'''example.com''', '''example.org''' or '''example.net'''。这是经[http://www.rfc-editor.org/rfc/rfc2606.txt RFC2606]。 | #'''网站例子名称:'''当你想将一个域作为一个例子的时候,你通过可以使用'''example.com''', '''example.org''' or '''example.net'''。这是经[http://www.rfc-editor.org/rfc/rfc2606.txt RFC2606]。 | ||
#'''管理:'''主要的管理用户通常有登录<code>管理</code>。 | #'''管理:'''主要的管理用户通常有登录<code>管理</code>。 | ||
#'''在例子中使用人们的名字:'''当一个普通的,非管理员的用户或者一个人,需要一个姓名的时候,将"'''Harriet'''"用作名,"'''Smith'''"用作姓。 | #'''在例子中使用人们的名字:'''当一个普通的,非管理员的用户或者一个人,需要一个姓名的时候,将"'''Harriet'''"用作名,"'''Smith'''"用作姓。 | ||
#'''管理 面板:'''WordPress界面称作'''管理面板:'''并不是admin 面板或者 dashboard。Dashboard是管理面板上的一个面板。 | #'''管理 面板:'''WordPress界面称作'''管理面板:'''并不是admin 面板或者 dashboard。Dashboard是管理面板上的一个面板。 | ||
#'''WordPress被拼写为 WordPress:''' WordPress的拼写有两个大写字母:'''W'''ord'''P'''ress。 | #'''WordPress被拼写为 WordPress:''' WordPress的拼写有两个大写字母:'''W'''ord'''P'''ress。 | ||
=相关的= | =相关的= | ||
* [[WordPress:Codex:About|关于Codex]] | * [[WordPress:Codex:About|关于Codex]] |
2008年6月3日 (二) 11:26的版本
导航: 上一级 | WordPress | 首页 | WordPress中文论坛 | WordPress主机 | CMS程序 | 论坛程序 | ECShop | ShopNC | PowerEasy
- 欢迎!;这个网页是要略述推荐给Codex上的编辑人员和志愿者的做法。你有一个建议来改善Codex吗,请在WordPress 文件邮件列表中粘贴一个建议的内容。
Meta 规则
- 使用合适的语法来拼写WordPress 。 WordPress
- 要友好 – 没有个人的言论袭击或者粗鲁的行为。请礼貌,耐心,专业。
- 正确地发行,早一点发行并且经常发行。
- 毫不留情地编辑。
- 如果有疑问,就要问。
- 玩得开心。 :)
通常练习
新的网页
欢迎新的文章和网页。但是,要有一个过程。
如果你不是一名注册的用户,遵循这些指导: 贡献: 重要的事情先来。
如果文章刚好完成了,你可以添加这篇文章到Codex,作为一个新的网页。看看: 创建一个新的网页。
如果文章还没有完成,而且是一个粗略描述的草稿,你可能将这篇文章添加到你的用户网页上,作为一个子网页。看看 创建一个用户网页。
请为这儿创建的文章遵循Codex样式: Codex样式。
以下是一些方针用来为Codex奉献一些新的作品:
- 如果有一篇文章与你的文章相似,改善当前存在的网页。
- 使用Sandbox网页来练习样式。
- 将来自另一篇文章的链接添加到你的文章上,在文章之间形成内部链接。不要创建那些"没有页面的网页"。这些页面没有链接到其它的Codex网页的链接。
- 一旦网页创建好了,这些网页就可以运行了,而且任何链接连接到这些网页都可以运行。当一个用户点击到了一个空白的网页的时候,他们浪费了时间。当你有非常完整而正确的内容的时候,再创建网页。
- 链接一旦完成了并且移到了来自你的用户网页的文件中,链接必须制作在内容的"子"表格和新的文章上的其它的相关文件中。想一下你自己是不是不确定可以在内容子表格的哪里创建一个链接。在没有文件小组的允许下,不要将一个链接放到主页中。
使用以下的"stubs",类别,这些指定了一篇文章所处的状态:
- {{Stub}}
- Stub将网页归类为未完成的,需要编辑和扩充。
- {{草稿}
- 将这个放到网页的顶上方。所有添加的网页都会被搜索引擎仔细检查。网页的顶上方的草稿,会提醒他人这个网页正在进展之中,网页上的信息可能是不正确的,而且还会警醒他人在你完成这个网页之前,不要编辑这个网页。
- [[WordPress:Category:New page created|类别:创建的新的网页]]
- 将一个网页定义为新的,会引起编辑的注意。不要将网页定义为新的,除非你已经开始编辑了和/或者将文章从你的用户网页的总文件中移除出去了。
- {{副本编辑}}
- 副本编辑指出了这篇文章需要操作,通常是需要大致的浏览和编辑。指出了文章已经完成了但是需要进一步处理。对于未完成的文章,使用{{Stub}}。
标题
新的网页的标题应该位于标题Case中。
所有的标题都必须在Title Case中。例如,使用"Using the Links Manager" 而不是"Using the links manager"(注:前后意思都是使用链接管理器,但是格式不同)。这些应该是完整的标题。不是Not "IntroToBlogs" 而是 "Introduction to Blogs"(注:意思相同,都是博客介绍说明,只是后者的格式应用于标题之中)
他们也应该遵循Dr. Grammar关于大写的规则:"在标题中,要大写第一个单词,最后一个单词,以及中间的所有单词,除了冠词 (a, an, and the), 少于五个字母的介词 (in, of, to), 和并列连词 (and, but)。这些规则适用于长的标题,短的标题,部分标题以及你自己的文章。 " (Anson, Schwegler, 和Muth. The Longman Writer's Companion 240)
- 标题是任何时候可能的情况下,导向的活动或者任务。因此,例如,"使用链接管理器" 比 "链接管理器"作为一个标题,更好。当用户查找信息的时候,他会使用什么样的搜素词?
- 标题不应该有开头的或者拖尾的空格,或者标题的单词之间也不应该有不必要的空格。试着避免使用符号像"-", "#", "?" and "+"
- 标题越短越好
- 请尽量在标题中避免使用介词。
- Codex是完全给WordPress专用的一个wiki,因此Codex的标题中含有"WordPress"很正常。
- 当对标题名称的合适性有疑问的时候,给wp-docs 列表写邮件,寻求建议
- 不要为网页标题使用CamelCase:Codex并不像其它的wikis那样,使用CamelCase。所有的网页标题和链接都应该是通常的标题case。例如,关于Codex的网页的标题应该是"关于Codex",链接的形式是:
[[WordPress:About Codex|关于Codex]]
而不是 CamelCase[[WordPress:AboutCodex| AboutCodex]]
.
子网页
不要创建一个网页的子网页,除非这个网页是来自你自己的用户网页,而且没有首先在wp-docs邮件列表上讨论过。
讨论
使用 "谈话"网页
你是不是看到了一些内容,这些内容可能是不正确的,或者需要澄清?提及任何问题的最好方法是使用讨论功能。
- 留下关于文章的信息:要留下关于文章的信息,点击那篇文章的讨论标签,发送你的信息并且署名。
- 给用户留下信息:通过编辑用户:与用户联合的谈论网页来给用户留下一个信息。并且署名。用户下一次访问Codex并且登录的时候,就会收到一个可以看到的提示。
- 分开评论:通过在文章中使用四个破折号----,在讨论网页的评论之间创建一个水平方向的破折号。如果你开始了一个新的谈话主题,考虑在编辑后面使用"+"链接,这会使你创建一个新的部分。
- 经常给你的评论签名:要将你的"署名"添加到一个评论上,在你的评论的后面添加上四个~s (tildes)。这个会列出你的用户名和一个链接连接到你的用户网页并且添加一个时间标记。这对讨论网页非常地有用。另一种方法是点击编辑窗口顶上方的署名图标…这是从右开始数的第二个图标。
Codex 声音, 样式, 和听众
WordPress Codex的"声音"是权威的一种,但也是一个友好的谈话。Codex的样式是要在有可能的情况下,提供简单的而且便于使用的解释,在需要的情况下,提供技术建议,通过这样做来起到培训的作用。
一般来说,文章是写给读者的,带着读者经历一个阅读的过程。人称代词"我"很少用到,突出于"你点击这儿" 和 "你打开模板文件"。.这并不是关于你,这个作者,在这个决定之后做了什么,也不是关于那些帮你成功的人。这是关于用户需要做什么来使他们的WordPress站点发展并且更加快速地运行。
Bullets符号和列表是用来突出那些需要略述和列出那个过程的步骤。复杂的任务被分解为一些小的步骤,来指导新手和高级用户迅速地得到解决方案。
观众的能力和掌握HMTL, XHTML, CSS, 和PHP的技术差别很大。高级主题 和开发者文件是针对有经验的用户的。WordPress课程是针对新手的,作者使用的语言描述,让人读起来感觉作者就是一个技术支持志愿者,和用户一起坐在电脑的旁边,指导用户这个过程。Codex的其余部分是针对初学者到中等级别的用户,应该包含简单的语言,如果需要的话,有链接到术语表中的术语定义。
惯例
- 网站例子名称:当你想将一个域作为一个例子的时候,你通过可以使用example.com, example.org or example.net。这是经RFC2606。
- 管理:主要的管理用户通常有登录
管理
。
- 在例子中使用人们的名字:当一个普通的,非管理员的用户或者一个人,需要一个姓名的时候,将"Harriet"用作名,"Smith"用作姓。
- 管理 面板:WordPress界面称作管理面板:并不是admin 面板或者 dashboard。Dashboard是管理面板上的一个面板。
- WordPress被拼写为 WordPress: WordPress的拼写有两个大写字母:WordPress。