俄罗斯方块中文维基:编写规范
一起探索特别有趣的方块思想! |
欢迎来到俄罗斯方块中文维基,本站点专注于收录俄罗斯方块的相关内容,包括但不限于游戏、机制、技巧、公司、人物、活动等。
本条目将介绍本站点中编写条目的大多通用性规范,以便编者参考。
首先,想必你已经通过 Project:关于了解了本维基的概况,如果没有,还请您花点时间浏览该条目。
此外,本维基属于 MediaWiki 站点,采用和一般网站不同的著作权形式,详请参阅 Project:版权。
阅读完以上两个条目,我们就开始介绍条目的编写规范吧。
写在前面:最重要的是勇于尝试。维基是一趟探险的旅程。不要害怕,也不必追求完美,你可以随时大胆提交你的半成品,在之后由自己或其他人继续改进。所有条目都不是一蹴而就,而是逐渐完善而成的。
基本原则
语言
俄罗斯方块中文维基使用简体中文。
使用繁体中文的编辑者可使用翻译工具进行初步的繁简转换。但是请注意术语的使用,简繁中文环境有很多方块术语有细微差别。
如果搬运其他语言的内容,请自己将其翻译。如果暂时无法做到,请挂上 {{需要翻译}} 模板以记录,留待以后或其他编辑者翻译。
维基化
维基是公共的百科全书,与其他类型的文字不同。
- 请尽量保证行文语气较为正式,符合中文语法,正确使用标点符号。请避免强烈的个人风格、个人偏好的与大众不同的用词、存在错字的网络用语等。
- 当然,作为游戏维基,我们不需要公文般的绝对正式与一丝不苟,可以存在一些轻松的内容。但是,请自己把握程度,避免过多的轻佻文字与玩笑。
- 请绝对避免行文中出现编辑者个人的情感好恶、价值判断。
- 但是,如果玩家社区中存在群体性的、成规模的情感倾向与价值判断,也可以以客观的语气叙述这方面的事实。
- 请务必避免使用机器翻译工具进行大段落的翻译。
- 请进一步尽自己所能减少不符合中文语法的翻译腔。例如行文中大段的从句,或者将昵称放在人物的姓与名之间等。
创建页面
在创建一个页面前,请在本站搜索相关关键词,确认是否已被创建过。如果你知道一个事物的不同称呼、名字的不同格式、不同语言的名字,最好都搜索一遍。
在确认需要的页面不存在之后,就可以放心地创建页面了。方法是在搜索框搜索要创建的标题,由于其不存在,网站会给出创建页面链接,点击就可以创建空白新页面。
一个页面的完成可能需要多次、甚至长时间的编辑。为了避免产生编辑冲突,请挂上 {{正在施工|~~~~}} 的模板,其中波浪线可以提供编辑者个人签名。虽然如此,但请尽量保证编辑工期不超过15天。挖坑不填不是好文明!
除了自己根据已有知识撰写之外,你还可以搬运、翻译、整理其他网站的内容,前提是它们使用 CC 共享协议,请不要搬运声明使用 Copyright 的网站内容。因此,搬运条目主要可能的来源是外文维基。如果你选择搬运翻译外文维基条目,那么请阅读 Project:搬运指南。主要需要注意的内容是:务必在条目顶部使用搬运模板说明来源、以及检查条目本身质量与搬运的必要性。同样地,即使只是引用其他网站的文字内容,也需要保证不会引起版权纠纷。如果无法保证这一点,就不要引用该网站的资源。关于版权的更多内容请参考 Project:版权,Project:可搬运性则总结了一些含有俄罗斯方块游戏信息的网站的可搬运性。
条目结构
一个完整的条目[注 1]按顺序包括下列组成部分:
- 顶注
- 信息框
- 导言
- 正文
- 注释
- 参考资料
- 参见
- 外部链接
- 导航框
- 分类标签
根据情况不同,并非所有条目都必须包含所有的内容,但包含的内容应遵循上述顺序。各部分内容的格式要求将在下文各小节中详述。
顶注
顶注是置于页面最顶部、所有正文内容之上的提示性文字,用于介绍条目的整体情况,通常以 {{mbox}} 消息框的形式出现。根据经验,大部分条目都会或多或少用到一些顶注,但这并非必须拥有的部分。
绝大多数条目都只会用到几种共通的顶注,因此都已经被制成模板。这里列出常用的模板及推荐的顺序:
- 较为迫切的、可能明显影响条目质量与阅读体验的维护性情况:{{正在施工}}、{{需要翻译}}
- 消除歧义与误解,与相近名称条目作区分:{{about}}、{{not}}
- 如果是翻译搬运条目,内容的来源:{{HD搬运}}、{{Tetris Wiki搬运}}
- 较为常规的维护性情况:{{需要帮助}}、{{需要扩展}}、{{需要校对}}
其中第一类模板仅作为临时性通知,应当尽量快地编辑完善和及时撤除,尽量减少其出现。编辑者可以在消息框分类中查阅所有已存在的模板,也可以直接用空白消息框自行输入备注内容。
信息框
{{infobox}} 信息框是位于页面右侧的表格,列举了条目主题的一些核心要素,以便读者快速了解基本信息。只要条目主题的类型有对应的信息框模板,就要使用信息框。
编辑者可以在信息框分类中查阅所有已存在的模板,并根据情况尽量多填写参数。
导言
导言,或称为序言,是条目的介绍和摘要,简要描述条目主题的最重要信息与独特性。导言是条目的必要组成部分。
导言的写法通常应当符合以下要求:
- 将页面标题自然地包括在第一自然段的第一句话中,并将其加粗;通常以「页面标题是什么什么……」的判断句形式写出。
- 长度适中,避免过于细节和冗长的内容;通常不应超过四个自然段。
- 作为超脱出正文各章节的文字,导言不应该被包含在一个章节中,即不应该为导言创建章节标题。
正文
正文是条目最主要的主体部分,显然也是条目的必要组成部分。
正文的写法通常应当符合以下要求:
- 应当按照自然的逻辑顺序来给正文划分不同的章节段落,而不是把所有内容都混在一起。
- 推荐编辑者在撰写某个条目时,多阅读同类型条目的结构和章节划分方式,和其他同类型条目保持一致会提升阅读体验方便查找信息。
- 推荐使用2个和3个等号来创建章节(二级标题)和小节(三级标题)。不可以使用1个等号的一级标题,因为页面标题就是一级标题;不建议使用多个等号的过于深层的标题,强烈建议至多使用4个等号(四级标题),因为过于深层的标题会显示得不够明显,难以辨认。
- 每一章节也可以视情况在最顶部放置顶注,只需要在大多数模板中加入 {{|section=yes}} 参数。
- 不同章节的内容量有相对的差距是正常现象。但是,如果一个条目的某个章节列举了绝对意义上过于丰富的数据或者细节,内容量明显畸多,那么可以考虑为其创建单独条目,并在两个条目间注明链接。
注释
注释是为避免影响正文而使用特殊方法标注的解释性文字。注释需要根据情况使用,并非必须拥有的部分。
如果编辑者认为某些地方需要插入说明性文字、不适合放在正文的文字、名词解释、罕见特殊情况说明等各种内容,但不希望在正文中加入过多的括注影响观感和阅读体验,就可以插入注释。
在正文中插入注释的方法是 <ref group="注">注释内容</ref>。
一旦使用了注释,就需要在正文之后创建名为注释的章节(二级标题),然后使用 {{reflist|group=注}} 模板来放置注释。正文注释也可以根据需要使用其他的 group 或 name 参数,但需要记得在后续创建对应的 reflist。
参考资料
参考资料,或称为引用,是正文内容的原始来源与可信度的保障。对绝大多数条目而言,参考资料都是强烈建议拥有并尽可能增加的部分。
对游戏、公司、人物、事件等客观内容的描述,援引玩家的外部研究内容、独特新颖创作,都需要尽量标注参考资料。相对的,常识、共识性的内容,或者根据上下文完全可以得出的内容与结论,不需要附参考资料。对我们俄罗斯方块中文维基这样的游戏维基而言,一些常见、公认的游戏理解也不需要标注参考资料。
在正文中插入参考资料的方法是 <ref>引用内容</ref>。如果适用的话,建议使用 {{cite web}} 模板,推荐至少按顺序填写 {{cite web|url=|title=|author=|website=|date=|access-date=}} 参数,更多参数与具体顺序请见该模板的说明文档。如果一些内容的确需要参考资料但不确定出处,则需要使用 {{请求来源}} 模板。
一旦使用了参考资料,就需要在正文之后创建名为参考资料的章节(二级标题),然后使用 {{reflist}} 模板来放置参考资料。
参见
参见是列出与本条目可能相关的、读者可能有兴趣阅读的其他条目。对大多数条目而言,参见都是非必须但常见的部分。
注意,参见章节所列出的应当是「条目」,存在于本维基、其他方块维基、或其他 MediaWiki 内。有关联且不属于参考资料的外部网页则需要置于外部链接章节。
应当列举出数个有关的条目,但需要控制数量,不得过多。
建议使用无序列表(*)的方式列出参见条目。如果有需要,可以在列出条目之后加简短介绍。
外部链接
外部链接,简称外链,是列出与本条目相关的其他网页。对大多数条目而言,参见都是非必须但常见的部分。
与本条目相关,但既不属于参考资料也不属于维基内条目,因此无法列入以上两章节的网页,可以在外链章节中列举。根据经验,外链通常包括条目主题的官方网站、在其他社交媒体的账号链接、展示游戏内容或技巧的视频投稿等等。
同样地,建议使用无序列表列举网页,数量以三到五个为宜,可以加简短介绍。
导航框
{{navbox}} 导航框是当条目属于一个有内在逻辑联系的分类时可以选择创建的表格。如果条目被一个已存在的导航框包含,则通常需要在条目最后列出该导航框。
不需要专门为导航框创建章节标题,只需要将导航框模板写在所有章节的最后即可。
编辑者可以在导航框分类中查阅所有已存在的模板。
分类标签
分类标签是条目的性质与分类。分类标签是条目的必要组成部分。
添加分类可以方便条目被索引和查找。所有条目都有适合的对应分类。此外,对于不同类型的条目,建议查看同分类条目的惯例,确定使用哪些等级的分类标签:有些类型的条目只需要添加最细分的一个分类标签,有些类型则适合同时添加上级分类与本级分类。
不需要专门为分类标签创建章节标题,只需要将分类写在整个条目的最后即可。
可通过 [[Category:分类名]] 或 [[分类:分类名]] 给一个条目添加分类;为格式整齐起见,同一条目中,请不要混合使用这两种列举方式。
写法规范
标点符号的使用
一般来说,词条名称中使用的是英文的标点符号,如:
- 用于人名中的横线,请使用半角减号-,例如雅-菲涅尔
- 用于人名中的点,请使用这种点·(而不是•),例如阿列克谢·帕基特诺夫
- 用于人名中的引号,请使用全角引号,例如“黄金大帝”亚尔·法拉松
如无特殊需要,词条正文中的标点请使用中文标点。中文之间不必保留标点,中文与拉丁字母或中文与数字之间是否保留空格由译者决定,但一篇条目中应保持一致。
空格的使用
为了排版美观,俄罗斯方块中文维基要求,一般情况下汉字与拉丁字母和数字之间留一空格,例子如下:
- DT Cannon -> DT 炮(
DT炮) - Regular T-Spin Single Setups -> 常规 T1 的构造(
常规T1的构造) - Mr. T-Spin's STD -> Mr. T-Spin 的 STD(
Mr. T-Spin的STD)
一些较短的条目名有时可不遵守上述规则。
特殊字体的使用
文字内容中的重要部分可通过加粗的形式体现。
不推荐编者使用斜体。为符合英文的标点规范,外网通常会将游戏名、玩家名等专有名字以斜体标出,但这不符合中文的规范与习惯,因此在搬运时需消除这些斜体格式。
图片的使用
图片的版权信息
在上传图片时务必注意源图片的版权信息,并在上传时时注明。
如果你不确定版权信息,请参阅Project:图片使用规范。
图片的布局
这篇文章需要改进。你可以帮助俄罗斯方块中文维基进行编辑。 编辑者签名:需要在某处说明如何使用画廊。 |
为了美观,推荐把正文中的图片放在右侧。同时,出于美观考虑,不推荐在正文中插入太多图片。
场地表示
俄罗斯方块中文维基使用 pfstart 等模板来表示俄罗斯方块游戏中的场地。
内外部链接
可以使用 [http://example.com 外部链接说明] 和 [[方块]]这两种语法添加外部链接和内部链接。习惯上,在同一个段落内多次出现一个词条名称时,只需在首次出现时附上链接。
以下是一些小技巧:
说明 | 输入 | 效果 |
---|---|---|
指向某分类的链接 | [[:Category:分类名]] | Category:游戏列表 |
指向其他跨维基站点(如英文维基百科)的词条链接 | [[Wikipedia:词条名]] | Wikipedia:Tetris |
页面重定向
- 参见:Project:命名规范
可使用#重定向 [[主要词条]],让读者在进入一个条目时,自动跳转到另一个条目。 重定向通常用于以下几种场景:
- 一个事物的英文称呼应重定向至其更广为接受的中文称呼:Donation -> 捐赠
- 对于两个中文称呼,应将较少人使用的称呼重定向至另一个:分形堆叠 -> 双剑
- 在全称符合命名规范的前提下,简称应重定向至全称:信天翁 -> 信天翁特别型
- 不规范的大小写使用,应重定向至规范的:Tetr.io -> TETR.IO
消歧义页的核心名称本身须重定向至对应的消歧义页,以便站内用户输入这个关键词搜索时能够跳转到消歧义页。
当这种核心名称出现在另一个条目的内部链接中时,它就不该指向消歧义页了,而是要精确地指向它真正所指的那个页面。
错误用例:[[重力]](相当于没有消歧义)
正确用例:[[降落#重力|重力]](指明了是方块的降落重力,而不是消行的重力)
基础技术
基础维基语法
本站在2023年2月10日关闭了可视化编辑功能,只能使用源代码编辑。但请不必担心,源代码编辑并非一门复杂的功课,可以方便地搜索到相关教程。
基础常用语法会出现在条目编辑框上方的「帮助」中,足以应付大部分情况。简单了解之后,你就可以使用「编辑源代码」按钮直接编辑源代码了。
你也可以将页面的所有文档复制到本地,通过本地编辑器(如 Visual Studio Code)进行编辑,以体验更好的语法高亮。
使用模板
模板属于维基语法中相对高级的部分,是指可被整体嵌入另外页面的公用内容。使用方法是 {{模板名}},如果模板有参数,则写法是 {{模板名|参数1|参数2|参数3...}}。如果你想修改模板,请在顶部的搜索框中输入 Template:模板名 或 模板:模板名,或者直接替换任意页面地址栏中的页面标题。
如果你希望详细学习模板的语法,请查阅 MediaWiki 官网给出的教程。
Mediawiki
本维基基于 MediaWiki,你可以继续深入地学习。
HTML
如果你熟悉 HTML,你可以使用 HTML 达到你希望的现实效果。
例如,你可以使用 <!-- 这是一段注释 --> 来在代码中写注释。
最佳实践
练习
你可以在Project:沙盒中练习,不必害怕出错。
按段落编辑
为避免和其他编辑者冲突,可以缩小编辑范围,只编辑一个段落。方法是点击某个段落标题旁边的 [编辑] 按钮。
请填写编辑摘要
编辑完成,提交之前请填写编辑摘要,以描述这一次编辑的主要内容。如果改变比较小(例如只是修改了一个错别字),可以设置为「小编辑」。
维护代码整洁
维护 wikitext 的整洁对后来的编辑者会有比较大的帮助。例如,在代码段落间保持适度的换行可以提高代码可读性。换行以一到两行为宜。
复用代码
如果你发现你在写大量重复的代码,请考虑把这些代码做成模板。
注释
- ↑ 这里指游戏、机制、技术、人物、公司等常规的「内容」条目,使用主命名空间(标题前没有特殊前缀)。列表、模板、站务等特殊页面,使用其他命名空间的,可以视情况决定结构,但建议与其他同类页面保持一致。博客则可以由作者自行任意决定。