用户:Cuihao/Sandbox：修订间差异

←上一编辑下一编辑→

2013年8月12日 (一) 10:14的版本

编辑手册施工中……

大原则

内容定位

本 Wiki 系统的主题是分布式计算，所有内容应符合这一主题。

目前，本 Wiki 主要包含以下几大类内容：

分布式计算项目的介绍
相关概念、术语的介绍
相关项目的文献资料
相关软件、工具的使用教程（非开发指南）

为便于维护，建议各位编辑专注于这几类内容的编写。对于不属于上述类别的内容，请先在论坛进行讨论，再定夺是否添加。

一般规则

参见维基百科的简要规则集。

针对本 Wiki，补充以下几点：

宁缺毋滥：编辑应注重内容的质量而非数量。与其编写一万篇内容简陋的页面，不如只取一百篇良品。这样一来保证了本 Wiki 整体品质

，二来也便于日后维护。

高瞻远瞩：要牢记，本 Wiki 人手有限。添加内容时，应考虑将来维护的便捷性。请使用规范的语言和 Wiki 标记来编辑页面，以便于他

人维护；不要采用时效性弱的内容，因为一个页面可能数月甚至数年都无人维护！

能做的事

作为一个编辑，如果你不知道该做什么，下面会给你一些指导：

完善现有页面

我们的 Wiki 里总是有很多烂尾的页面，与其创建新的，还不如改善一下这些页面的质量。

你可以做的事有：更新过期信息（分类:Update）、丰富文章内容（分类:Stub）、优化代码格式（分类:Wikify）、整理文章内容（[[:

分类:Cleanup]]）等等。

搬运论坛已翻译的文献

这项工作比较无脑，不要求你翻阅资料、编写文段。但也请按照要求认真地做。

当然，也欢迎有能力的编辑参与翻译工作。

阅读页面，打上适当的管理模板

这项工作更无脑。读一读文章，然后做出评价即可。标记上适当的管理模板，可以提醒读者和编辑页面潜在的问题。

杂项

有一些页面，如首页的新闻、竞赛信息等等，需要有人持续不断地维护。欢迎有心有力的编辑认领。

页面编辑指南

代码风格

虽然维基百科的规定已经涵盖某些内容，但因为很重要还是再说一遍。

Wiki 标记语言是对 HTML 语言的简化，兼容 HTML 语句。比如我们既可以使用 Wiki 标记 ''文字''、也可以使用 HTML 语句

<i>文字</i> 来给文字添加斜体格式。滥用 HTML 语句给页面维护带来了很大麻烦。

编辑应尽量使用已有的 Wiki 标记或模板代替 HTML 语句。如果仍不能满足需求（如下划线），可以适当使用一些简单的 HTML 语句。

请避免使用更复杂的语句，比如内嵌样式表的 <span>、<div> 语句。如果你认为很有必要使用，请通过[[#创建和

编辑模板|新的模板]]实现。

一般页面

创建页面前，请确认要添加的内容符合本站主题定位和其他规则。

对于大多数页面，源码从上往下应包含如下内容：

页面分类

除了少数特殊页面，每个页面都必须有至少一个分类。建议放在最前，便于维护。如若因空行影响页面美观，亦可置于最后。

Infobox 模版（某些页面需要）

这类模版用于归纳页面内容，或声明某些重要信息。如：对于项目介绍，此处应使用 project 模版；对于文献，此处应使用各类 doc 模版。

正文

正文由若干有层次的段落组成。请使用规范的 Wiki 语法编写正文，不要滥用难于维护的 HTML 代码。

鼓励编辑使用各类文本格式化模版，以强调重要内容或优化显示效果。

相关链接

对于和主题相关、但不适合置于本 Wiki 的扩展内容，可以放置于此，便于读者扩展阅读。

下面各段，是各类页面的特殊要求。

项目介绍

此类页面的分类由 Infobox 模版中的相应参数指定，无需显示声明。特殊的需要指定的分类有：分类:已结束项目、分类:本站推荐项目（请

勿随意使用）。

另外，如有必要，可以添加适当的主题分类（一般是与页面同名的分类，详见#页面分类指南）。

项目文献

项目文献的来源多为外文资料，请先在论坛的翻译任务交流区请求翻译。一般情况下，本 Wiki 不

接受纯外语内容。

分类需要自行指定，请到分类:文献中查看可用的分类。一般需指定两种分类：一是学科分类（必须，如分类:生物学和医学相关文献），二是

项目分类（可选，如分类:Cels@Home 相关文献）。

应当在正文前添加下列模版之一：

模板:Doc/translate：适用于从论坛“翻译任务交流区”转移过来的已翻译文献。
模板:Doc/reship：适用于从其他网站转载的文献。

正文部分，请尽量遵循原文格式。对于原文的图片，应导入 Wiki 并置于适当位置。

教程指南

喵~

页面分类指南

为便于管理和查找页面，每个页面都应划分进适当的 Wiki 分类，形成一个条理清晰的索引体系。

本 Wiki 将分类划为两个部分：“预设分类”由管理人员规定，自由度低，但层次更加规范有序；“标签分类”可由编辑灵活添加，自由度高，但不利于

管理。

预设分类

预设分类指的是由 Wiki 管理人员预先设计好的分类。其中，有些分类需要手动指定，有些则通过模板指定（如用于填写模板:Project的[[模

板:App|App 系列模板]]）。

所有预设分类如下表：

分类:项目分类：按项目平台

分类:项目分类：按研究方向

分类:分类:文献

标签分类

标签分类指的是根据文章内容灵活添加的分类，类似于博客系统中的标签。所有标签分类应归入分类:标签，以便管理。

举例来讲，假设有一名为 foo@home 的项目，该项目下又有 foo1、foo2 等子项目，都创建了项目介绍页面。同时，还可能有其他关

于 foo@home 的页面（如教程、优化程序等等）。为了强调这些页面之间的联系，可以统一加入一个名为 foo@home 的分类。

为了避免浪费，应当在内容共通的页面达到足够数量后再使用标签分类，请诸位编辑自行斟酌。

模版应用指南

分类:模板下收录了本 Wiki 的全部可用模板。其中，元模板是一类特殊的模板。这些模板一般仅用于编写其他模板，而

不应直接在页面中使用。

模板有以下几个典型用途：

调整文字格式和排版，提高阅读体验。
标记页面状态。（如分类:管理模板）
概括页面信息。

创建和编辑模板

警告： 编辑修改模板时应格外小心，因为对模板的改动将会影响到所有包含该模板的页面。修改后，编辑应在主流浏览器下检查模板效果，以确保所做的修改不会对页面效果造成损害。

为了规范模板应用，不建议编辑自行创建和修改模板，尤其是上述后两类模板（“标记页面状态”、“概括页面信息”）。如有必要，请先使用用户页面

及其子页面测试，与管理员和其他编辑讨论后再做决定。

使用模板

=格式和排版

参见：分类:格式模板

部分模板代替了 HTML 语句或样式表的功能，用于调整文字格式和排版。适当使用，可以改善读者的阅读体验。

常用的几个模板如下：

模板:Warning：（在教程等中）强调一段特别重要内容，如果忽略可能会对读者造成一定损失。
模板:Note：（在教程、文献等中）强调一段比较重要的内容或知识。
模板:Tip：（在教程等中）给读者提供额外的指导、建议。
模板:Summary：（在教程、文献等中）概括文意，指导读者阅读。
模板:Wikipedia：提醒用户维基百科的相关主题，可延伸阅读。

但也请编辑不要滥用这些模板。如果用得太多，反而使页面显得混乱，且失去了强调的作用。

管理模板

参见：分类:管理模板

编辑如果发现页面或段落存在问题，又无法立即解决，应加入管理模板提醒Wiki用户或读者页面存在的问题。

目前本 Wiki 有以下几个管理模板（点击后一个链接查看所有该种类的页面）：

参数类型 {{模板|提出用户名|理由(可选)}}：

参数类型 {{模板|操作涉及的第二个页面|提出用户名|理由(可选)}}：

模板:Merge —— 内容待合并的页面
模板:Move —— 需要移动或分割的页面

@@ 第2行： / 第2行： @@
 ==大原则==
 ===内容定位===
 本 Wiki 系统的主题是'''分布式计算'''，所有内容应符合这一主题。
@@ 第19行： / 第18行： @@
 针对本 Wiki，补充以下几点：
-*'''宁缺毋滥'''：编辑应'''注重内容的质量而非数量'''。与其编写一万篇内容简陋的页面，不如只取一百篇良品。这样一来保证了本 Wiki 整体品质，二来也便于日后维护。
+*'''宁缺毋滥'''：编辑应'''注重内容的质量而非数量'''。与其编写一万篇内容简陋的页面，不如只取一百篇良品。这样一来保证了本 Wiki 整体品质
-*'''高瞻远瞩'''：要牢记，本 Wiki 人手有限。添加内容时，应考虑将来维护的便捷性。请'''使用规范的语言和 Wiki 标记'''来编辑页面，以便于他人维护；'''不要采用时效性弱的内容'''，因为一个页面可能数月甚至数年都无人维护！
-*'''避免重复'''：一些科学类的内容，应使用形如<nowiki>[[Wikipedia:zh:xxx]]</nowiki>的跨维基链接链接到维基百科。同时当你想要创建页面时，记得先搜索页面标题，发现目标页面时你可以留下一个重定向。
+，二来也便于日后维护。
+*'''高瞻远瞩'''：要牢记，本 Wiki 人手有限。添加内容时，应考虑将来维护的便捷性。请'''使用规范的语言和 Wiki 标记'''来编辑页面，以便于他
+人维护；'''不要采用时效性弱的内容'''，因为一个页面可能数月甚至数年都无人维护！
+==能做的事==
+作为一个编辑，如果你不知道该做什么，下面会给你一些指导：
+* 完善现有页面
+我们的 Wiki 里总是有很多烂尾的页面，与其创建新的，还不如改善一下这些页面的质量。
+你可以做的事有：更新过期信息（[[:分类:Update]]）、丰富文章内容（[[:分类:Stub]]）、优化代码格式（[[:分类:Wikify]]）、整理文章内容（[[:
+分类:Cleanup]]）等等。
+* [[#项目文献|搬运论坛已翻译的文献]]
+这项工作比较无脑，不要求你翻阅资料、编写文段。但也请按照要求认真地做。
+当然，也欢迎有能力的编辑参与翻译工作。
+* 阅读页面，打上适当的[[#管理模板|管理模板]]
+这项工作更无脑。读一读文章，然后做出评价即可。标记上适当的管理模板，可以提醒读者和编辑页面潜在的问题。
+* 杂项
+有一些页面，如首页的新闻、[[项目竞赛日程|竞赛信息]]等等，需要有人持续不断地维护。欢迎有心有力的编辑认领。
 ==页面编辑指南==
+===代码风格===
+虽然维基百科的规定已经涵盖某些内容，但因为很重要还是再说一遍。
+Wiki 标记语言是对 HTML 语言的简化，兼容 HTML 语句。比如我们既可以使用 Wiki 标记 <nowiki>''文字''</nowiki>、也可以使用 HTML 语句
+<nowiki><i>文字</i></nowiki> 来给文字添加斜体格式。滥用 HTML 语句给页面维护带来了很大麻烦。
+编辑应尽量使用已有的 Wiki 标记或模板代替 HTML 语句。如果仍不能满足需求（如下划线），可以适当使用一些简单的 HTML 语句。
+请避免使用更复杂的语句，比如内嵌样式表的 <nowiki><span></nowiki>、<nowiki><div></nowiki> 语句。如果你认为很有必要使用，请通过[[#创建和
+编辑模板|新的模板]]实现。
 ===一般页面===
@@ 第42行： / 第73行： @@
 ===项目介绍===
-此类页面的分类由 Infobox 模版中的相应参数指定，无需显示声明。特殊的需要指定的分类有：[[:分类:已结束项目]]、[[:分类:本站推荐项目]]（请勿随意使用）。
+此类页面的分类由 Infobox 模版中的相应参数指定，无需显示声明。特殊的需要指定的分类有：[[:分类:已结束项目]]、[[:分类:本站推荐项目]]（请
+勿随意使用）。
 另外，如有必要，可以添加适当的主题分类（一般是与页面同名的分类，详见[[#页面分类指南]]）。
 ===项目文献===
-项目文献的来源多为外文资料，请先在论坛的[http://www.equn.com/forum/forum-45-1.html 翻译任务交流区]请求翻译。一般情况下，本 Wiki '''不接受纯外语内容'''。
+项目文献的来源多为外文资料，请先在论坛的[http://www.equn.com/forum/forum-45-1.html 翻译任务交流区]请求翻译。一般情况下，本 Wiki '''不
-分类需要自行指定，请到[[:分类:文献]]中查看可用的分类。一般需指定两种分类：一是学科分类（必须，如[[:分类:生物学和医学相关文献]]），二是项目分类（可选，如[[:分类:Cels@Home 相关文献]]）。
+接受纯外语内容'''。
+分类需要自行指定，请到[[:分类:文献]]中查看可用的分类。一般需指定两种分类：一是学科分类（必须，如[[:分类:生物学和医学相关文献]]），二是
+项目分类（可选，如[[:分类:Cels@Home 相关文献]]）。
 应当在正文前添加下列模版之一：
@@ 第58行： / 第95行： @@
 ===教程指南===
-''研究中……''
+喵~
-{{Warning|下面是Arthur乱搞的！}}
-教程指南我看就……一步一步来……（废话
+==页面分类指南==
+为便于管理和查找页面，每个页面都应划分进适当的 Wiki 分类，形成一个条理清晰的索引体系。
-可怕的是某些<s>小白</s>初级用户……………………我们认为一步就好的东西对于他们………………………………{{Black|啊啊啊啊啊啊啊啊啊啊啊啊啊}}--[[User:Arthur200000|<span style="color:#2299FF">Arthur</span>]][[User Talk:Arthur200000|<span style="color:#7777FF">200000</span>]] 2013年7月18日 (四) 18:12 (EDT)
+本 Wiki 将分类划为两个部分：“预设分类”由管理人员规定，自由度低，但层次更加规范有序；“标签分类”可由编辑灵活添加，自由度高，但不利于
+管理。
-==页面分类指南==
-Arthur200000注：某些页面分类用了丧心病狂的中文冒号（：），而不是常用的“:"……
 ===预设分类===
-'''预设分类'''指的是由 Wiki 管理人员预先设计好的分类。其中，有些分类需要手动指定，有些则通过模板指定（如用于填写[[模板:Project]]的[[模板:App|App 系列模板]]）。
+'''预设分类'''指的是由 Wiki 管理人员预先设计好的分类。其中，有些分类需要手动指定，有些则通过模板指定（如用于填写[[模板:Project]]的[[模
+板:App|App 系列模板]]）。
 所有预设分类如下表：
@@ 第108行： / 第148行： @@
 '''标签分类'''指的是根据文章内容灵活添加的分类，类似于博客系统中的标签。所有标签分类应归入[[:分类:标签]]，以便管理。
-举例来讲，假设有一名为 '''foo@home''' 的项目，该项目下又有 '''foo1'''、'''foo2''' 等子项目，都创建了项目介绍页面。同时，还可能有其他关于 '''foo@home''' 的页面（如教程、优化程序等等）。为了强调这些页面之间的联系，可以统一加入一个名为 '''foo@home''' 的分类。
+举例来讲，假设有一名为 '''foo@home''' 的项目，该项目下又有 '''foo1'''、'''foo2''' 等子项目，都创建了项目介绍页面。同时，还可能有其他关
+于 '''foo@home''' 的页面（如教程、优化程序等等）。为了强调这些页面之间的联系，可以统一加入一个名为 '''foo@home''' 的分类。
 为了避免浪费，应当在内容共通的'''页面达到足够数量'''后再使用标签分类，请诸位编辑自行斟酌。
 ==模版应用指南==
-喵~
+[[:分类:模板]] 下收录了本 Wiki 的全部可用模板。其中，[[:分类:元模板|元模板]]是一类特殊的模板。这些模板一般'''仅用于编写其他模板'''，而
-{{Warning|又是Arthur乱搞！}}
-模板的基♂本应用方式是加入一段代码：
+不应直接在页面中使用。
-<pre>{{模板名}}</pre>
-某些有参数的傲娇模板是这样的:
+模板有以下几个典型用途：
-<pre>{{模板名|1|2|3……}}</pre>
+* 调整文字格式和排版，提高阅读体验。
-更傲娇的：
+* 标记页面状态。（如[[:分类:管理模板]]）
-<pre>{{模板名
+* 概括页面信息。
-|futa=yes
-|……   }}</pre>
+===创建和编辑模板===
-啊啊啊不是要这个！
+{{Warning|编辑修改模板时应格外小心，因为对模板的改动将会影响到所有包含该模板的页面。修改后，编辑应在主流浏览器下检查模板效果，以确保所
-----
-啊什么代码的模板文档都有写对吧…… （啊不过文档君没有说box模板不能带"?"
+做的修改不会对页面效果造成损害。}}
+为了规范模板应用，不建议编辑自行创建和修改模板，尤其是上述后两类模板（“标记页面状态”、“概括页面信息”）。如有必要，请先使用用户页面
+及其子页面测试，与管理员和其他编辑讨论后再做决定。
+===使用模板===
+====格式和排版===
+参见：[[:分类:格式模板]]
+部分模板代替了 HTML 语句或样式表的功能，用于调整文字格式和排版。适当使用，可以改善读者的阅读体验。
+常用的几个模板如下：
+* [[模板:Warning]]：（在教程等中）强调一段特别重要内容，如果忽略可能会对读者造成一定损失。
+* [[模板:Note]]：（在教程、文献等中）强调一段比较重要的内容或知识。
+* [[模板:Tip]]：（在教程等中）给读者提供额外的指导、建议。
+* [[模板:Summary]]：（在教程、文献等中）概括文意，指导读者阅读。
+* [[模板:Wikipedia]]：提醒用户维基百科的相关主题，可延伸阅读。
+但也请编辑不要滥用这些模板。如果用得太多，反而使页面显得混乱，且失去了强调的作用。
+====管理模板====
+参见：[[:分类:管理模板]]
+编辑如果发现页面或段落存在问题，又无法立即解决，应加入管理模板提醒Wiki用户或读者页面存在的问题。
+目前本 Wiki 有以下几个管理模板（点击后一个链接查看所有该种类的页面）：
+参数类型 <nowiki>{{模板|提出用户名|理由(可选)}}</nowiki>：
+* [[模板:Update]] —— [[:分类:Update|内容过时的页面]]
+* [[模板:Cleanup]] —— [[:分类:Cleanup|文本质量待改善的页面]]
+* [[模板:Wikify]] —— [[:分类:Wikify|Wiki代码质量待改善的页面]]
+* [[模板:Stub]] —— [[:分类:Stub|内容有待扩展的页面]]
+* [[模板:Delete]] —— [[:分类:Delete|等待删除的页面]]
+* [[模板:Editing]] —— [[:分类:editing|正在编辑的页面]]
-啊反正用了记得预览啊预览……
+参数类型 <nowiki>{{模板|操作涉及的第二个页面|提出用户名|理由(可选)}}</nowiki>：
+* [[模板:Merge]] —— [[:分类:Merge|内容待合并的页面]]
+* [[模板:Move]] —— [[:分类:Move|需要移动或分割的页面]]