“用户:Cuihao/Sandbox”的版本间的差异

来自中国分布式计算总站
跳转至: 导航搜索
预设分类
页面分类指南
 
(未显示2个用户的9个中间版本)
第2行: 第2行:
  
 
==大原则==
 
==大原则==
 
 
===内容定位===
 
===内容定位===
 
本 Wiki 系统的主题是'''分布式计算''',所有内容应符合这一主题。
 
本 Wiki 系统的主题是'''分布式计算''',所有内容应符合这一主题。
第22行: 第21行:
 
*'''高瞻远瞩''':要牢记,本 Wiki 人手有限。添加内容时,应考虑将来维护的便捷性。请'''使用规范的语言和 Wiki 标记'''来编辑页面,以便于他人维护;'''不要采用时效性弱的内容''',因为一个页面可能数月甚至数年都无人维护!
 
*'''高瞻远瞩''':要牢记,本 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> 语句。如果你认为很有必要使用,请通过[[#创建和编辑模板|新的模板]]实现。
  
 
===一般页面===
 
===一般页面===
第58行: 第79行:
  
 
===教程指南===
 
===教程指南===
''研究中……''
+
喵~
  
 
==页面分类指南==
 
==页面分类指南==
 +
为便于管理和查找页面,每个页面都应划分进适当的 Wiki 分类,形成一个条理清晰的索引体系。
 +
 +
本 Wiki 将分类划为两个部分:
 +
*“预设分类”由管理人员规定,自由度低,但层次更加规范有序;
 +
*“标签分类”可由编辑灵活添加,自由度高,但不利于管理。
 +
 
===预设分类===
 
===预设分类===
 
'''预设分类'''指的是由 Wiki 管理人员预先设计好的分类。其中,有些分类需要手动指定,有些则通过模板指定(如用于填写[[模板:Project]]的[[模板:App|App 系列模板]])。
 
'''预设分类'''指的是由 Wiki 管理人员预先设计好的分类。其中,有些分类需要手动指定,有些则通过模板指定(如用于填写[[模板:Project]]的[[模板:App|App 系列模板]])。
第100行: 第127行:
 
:*''<项目名> 相关文献''
 
:*''<项目名> 相关文献''
  
===主题分类===
+
===标签分类===
 +
'''标签分类'''指的是根据文章内容灵活添加的分类,类似于博客系统中的标签。所有标签分类应归入[[:分类:标签]],以便管理。
 +
 
 +
举例来讲,假设有一名为 '''foo@home''' 的项目,该项目下又有 '''foo1'''、'''foo2''' 等子项目,都创建了项目介绍页面。同时,还可能有其他关于 '''foo@home''' 的页面(如教程、优化程序等等)。为了强调这些页面之间的联系,可以统一加入一个名为 '''foo@home''' 的分类。
 +
 
 +
为了避免浪费,应当在内容共通的'''页面达到足够数量'''后再使用标签分类,请诸位编辑自行斟酌。
  
 
==模版应用指南==
 
==模版应用指南==
喵~
+
[[:分类:模板]] 下收录了本 Wiki 的全部可用模板。其中,[[:分类:元模板|元模板]]是一类特殊的模板。这些模板一般'''仅用于编写其他模板''',而不应直接在页面中使用。
 +
 
 +
模板有以下几个典型用途:
 +
* 调整文字格式和排版,提高阅读体验。
 +
* 标记页面状态。(如[[:分类:管理模板]])
 +
* 概括页面信息。
 +
 
 +
===创建和编辑模板===
 +
{{Warning|编辑修改模板时应格外小心,因为对模板的改动将会影响到所有包含该模板的页面。修改后,编辑应在主流浏览器下检查模板效果,以确保所做的修改不会对页面效果造成损害。}}
 +
 
 +
为了规范模板应用,不建议编辑自行创建和修改模板,尤其是上述后两类模板(“标记页面状态”、“概括页面信息”)。如有必要,请先使用用户页面及其子页面测试,与管理员和其他编辑讨论后再做决定。
 +
 
 +
===使用模板===
 +
====格式和排版====
 +
参见:[[:分类:格式模板]]
 +
 
 +
部分模板代替了 HTML 语句或样式表的功能,用于调整文字格式和排版。适当使用,可以改善读者的阅读体验。
 +
 
 +
常用的几个模板如下:
 +
* [[模板:Warning]]:(在教程等中)强调一段特别重要内容,如果忽略可能会对读者造成一定损失。
 +
* [[模板:Note]]:(在教程、文献等中)强调一段比较重要的内容或知识。
 +
* [[模板:Tip]]:(在教程等中)给读者提供额外的指导、建议。
 +
* [[模板:Summary]]:(在教程、文献等中)概括文意,指导读者阅读。
 +
* [[模板:Wikipedia]]:提醒用户维基百科的相关主题,可延伸阅读。
 +
 
 +
{{Note|但也请编辑不要滥用这些模板。如果用得太多,反而使页面显得混乱,且失去了强调的作用。}}
 +
 
 +
====管理模板====
 +
参见:[[:分类:管理模板]]
 +
 
 +
编辑如果发现页面或段落存在问题,又无法立即解决,应加入管理模板提醒Wiki用户或读者页面存在的问题。
 +
 
 +
目前本 Wiki 有以下几个管理模板(点击后一个链接查看所有该种类的页面):
 +
 
 +
:参数类型 <nowiki>{{模板|提出用户名|理由(可选)}}</nowiki>:
 +
:* [[模板:Update]] —— [[:分类:Update|内容过时的页面]]
 +
:* [[模板:Cleanup]] —— [[:分类:Cleanup|文本质量待改善的页面]]
 +
:* [[模板:Wikify]] —— [[:分类:Wikify|Wiki代码质量待改善的页面]]
 +
:* [[模板:Stub]] —— [[:分类:Stub|内容有待扩展的页面]]
 +
:* [[模板:Delete]] —— [[:分类:Delete|等待删除的页面]]
 +
:* [[模板:Editing]] —— [[:分类:editing|正在编辑的页面]]
 +
 
 +
:参数类型 <nowiki>{{模板|操作涉及的第二个页面|提出用户名|理由(可选)}}</nowiki>:
 +
:* [[模板:Merge]] —— [[:分类:Merge|内容待合并的页面]]
 +
:* [[模板:Move]] —— [[:分类:Move|需要移动或分割的页面]]

2013年8月12日 (一) 10:26的最新版本

编辑手册施工中……

大原则

内容定位

本 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 相关文献)。

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

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

教程指南

喵~

页面分类指南

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

本 Wiki 将分类划为两个部分:

  • “预设分类”由管理人员规定,自由度低,但层次更加规范有序;
  • “标签分类”可由编辑灵活添加,自由度高,但不利于管理。

预设分类

预设分类指的是由 Wiki 管理人员预先设计好的分类。其中,有些分类需要手动指定,有些则通过模板指定(如用于填写模板:ProjectApp 系列模板)。

所有预设分类如下表:

标签分类

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

举例来讲,假设有一名为 foo@home 的项目,该项目下又有 foo1foo2 等子项目,都创建了项目介绍页面。同时,还可能有其他关于 foo@home 的页面(如教程、优化程序等等)。为了强调这些页面之间的联系,可以统一加入一个名为 foo@home 的分类。

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

模版应用指南

分类:模板 下收录了本 Wiki 的全部可用模板。其中,元模板是一类特殊的模板。这些模板一般仅用于编写其他模板,而不应直接在页面中使用。

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

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

创建和编辑模板

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

为了规范模板应用,不建议编辑自行创建和修改模板,尤其是上述后两类模板(“标记页面状态”、“概括页面信息”)。如有必要,请先使用用户页面及其子页面测试,与管理员和其他编辑讨论后再做决定。

使用模板

格式和排版

参见:分类:格式模板

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

常用的几个模板如下:

  • 模板:Warning:(在教程等中)强调一段特别重要内容,如果忽略可能会对读者造成一定损失。
  • 模板:Note:(在教程、文献等中)强调一段比较重要的内容或知识。
  • 模板:Tip:(在教程等中)给读者提供额外的指导、建议。
  • 模板:Summary:(在教程、文献等中)概括文意,指导读者阅读。
  • 模板:Wikipedia:提醒用户维基百科的相关主题,可延伸阅读。
注意: 但也请编辑不要滥用这些模板。如果用得太多,反而使页面显得混乱,且失去了强调的作用。

管理模板

参见:分类:管理模板

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

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

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