Project:编写规范
- 这只是一份通行规范,维基管理员可以在与社区用户充分交流的情况下修改本规范,使之更加满足猎魔人中文维基的需要。
说明
本维基欢迎您。
本日志以逐渐扩展的形式引导编写规范的词条。如果您想了解本维基的内容方针,请前往Project:方针。
如果您对本规范有任何意见,欢迎留言或(最好)直接前往群里讨论。在此之前请遵守本规范编辑本维基词条。
开始编写第一个词条
了解维基
在开始编辑前,你应该了解本维基。所谓“了解”包括但不限于本维基的著作权、Project:内容方针、编辑规范(也即本文)等,你可以在这里找到相关的文档。
操作方式
请参考Wiki编辑快速指南
认领词条
本维基原著相关内容分为四大类:种族、地理、物品、历史
在创建一个词条前,请搜索相关关键词,确认是否已被创建过。
在您认领词条之后,请尽快创建该词条的空白页面,并写上{{正在施工|~~~~}}签名。推荐有多少内容放多少,务必忘记“注释来源”。词条空白状态不要超过15天。
编写内容
本维基尚处初期阶段,当引用其他CC共享协议的内容,如各大词条网站的翻译,应检查有否错误或缺漏。同时,如果你使用(包括翻译)了上述网站的内容,请不要忘记说明版权。
勇于尝试
不要害怕,也不必追求完美,你可以大胆提交你的半成品。维基是一趟探险的旅程,会有很多人来帮你完善你的词条。Nai Earendilo silme siluva tielyanna。
基础维基语法
写在前面
不要害怕,你不需要精通维基语法,甚至不需要熟悉维基语法就可以开始编辑维基。
本维基提供了可视化编辑工具,点击“编辑”按钮即可以像编辑word一样编辑啦。
如果你偏好直接编辑代码,也可以点击“编辑源代码”按钮直接编辑源代码。
小提示:即使你是源代码编辑的熟手,工具栏里的小工具也可以在很多时候帮上你的忙哦。
当然,如果帮助页面写的实在太长没耐心的话,我们准备了简单的复习: |
---|
模板:基础语法 |
高级语法
使用模板
模板属于维基语法中相对高级的部分,是指可被整体嵌入另外页面的公用内容。使用方法是{{模板名}},如果模板有参数,则写法是{{模板名|参数1|参数2|参数3...}}。如果你想修改模板,请在浏览器中输入地址http://lotr.huiji.wiki/wiki/Template:模板名。例如,模板{{需要帮助}}的地址是http://lotr.huiji.wiki/wiki/Template:需要帮助。如果你希望详细学习模板的语法,请前往MediaWiki官方网站,或在QQ群中提问。
强烈建议你学习本维基的常用模板,这不仅能帮助你写出更加规范的代码,更能提高你编写的效率。
Media Wiki
本维基基于MediaWiki,你可以继续深入的学习。
HTML
如果你熟悉HTML,你可以使用HTML达到你希望的现实效果。
例如,你可以使用<!-- 这是一段注释-->来在代码中写注释。
编写规范的词条
词条名称
译名选择
众所周知,魔戒在国内曾多次出版,各个版本之间译名多有差异。本维基采用以下版本
其他待定。全部译名请参考译名表。
同义词和英文词条
有以下几种场景:
它们有共同的特征,就是有一个主要词条,其他从属词条应该与主要词条拥有相同的内容。这种问题我们使用重定向解决,方法是保留主要词条,从属词条内容写为#重定向 [[主要词条]]。
- 提问:如果我先建立了Finwe怎么办呢?我应该建立芬威,把内容粘贴过去吗?
- 答:不。你应该在已经建立好的Finwe页面上点击“移动”,接下来按照指引,输入新词条的名字,保存即可。
- 提问:如果我已经建立了Finwe和芬威怎么办?
- 答:按照上述规范,手动修改两个页面吧……
- 提问:如果我还不知道页面的译名怎么办?
- 答:目前本维基尚处初始阶段,大量词条没有拿到译名。不过这不应该阻挡你的热情。你可以使用词条的英文名称创建词条,待今后拿到译名再移动词条。
词条名称中的标点符号
有些词条名中会出现标点符号,请遵循以下规则
- 用于消除词条歧义的括号,请使用半角括号(),例如魔戒(消歧义)、Aeglos (plant)
- 用于人名中的横线,请使用半角减号-,例如雅-菲涅尔
- 用于人名中的点,请使用这种点·(而不是•),例如“黄金大帝”亚尔·法拉松
- 用于人名中的引号,请使用全角引号,例如“黄金大帝”亚尔·法拉松
- 用于作品的名称,请不要使用书名号《》,例如埃努的大乐章、魔戒,而不是《埃努的大乐章》、《魔戒》
- 未尽事项,请参考译名表
词条信息卡(info box)
本维基使用的info box与Tolkien Gateway的在格式上略有不同。你可以参考Gateway上的info box内容,但请勿直接搬运。关于各个info box的说明,请参考其页面。
词条摘要
通常,词条的第一自然段应该是词条的摘要。它不应该被包含在一个段落(例如“==概要==”或者“==词条名==”)中。一个范例性的摘要如下,取自词条芬威:
- '''芬威'''{{En|Finwë}}是[[诺多精灵]]的第一位国王,他在[[Valar]]的召唤下带领诺多精灵从中洲迁徙到[[Valinor]]。
以下详细说明:
- 通常,词条摘要是这样开始的“'''词条名'''{{En|英文词条名}}是BlahBlah”。
- 也有的词条不适合这种开场,请变通行事。例如魔戒的版本这一词条是这样开场的:“自1954~1955首次出版以来,[[魔戒]]已经被多家出版社多次出版,拥有众多'''版本'''{{en|The Lord of the Rings editions}}。”。但以下规则不变。
- 词条名应该加粗。
- 应该提供英文链接,链接至Tolkien Gateway上的相应词条。
- 摘要不应过长,如果摘要变得很长,请考虑将其中部分内容移至下文的段落中。
词条正文
词条正文的段落
应该使用==段落一==这种语法为正文划分段落,而不是把所有内容混在在一起。可以使用多级段落,但不宜过深。
词条正文中的标点
如无特殊需要,词条正文中的标点请使用中文标点。文字之间不应该留空格。
词条中的图片
图片的版权信息
在上传图片时务必选定版权信息。如果你不确定版权信息,请参考下一小节。
获取使用图片授权
在使用图片前,你需要确保该图片没有版权纠纷。如果你无法确保,请不要使用该图片。有关图片版权的更多信息请参考著作权。
本维基已经获取一些艺术家的授权,以在本维基使用他们的某些作品,请查看Category:Evidence of permission granted by copyright holders获取详情。
如果你希望在本维基使用某位艺术家的画作但尚未获得授权,可以联系该艺术家,也可以在QQ群中询问获取授权的进度。
当你已经获得艺术家的授权,请建立或修改以下几个页面,这里以艺术家Marya Filatova为例说明。
- 创建艺术家版权信息页面,例如Project:著作权/Marya_Filatova,该页面应该包含艺术家个人信息、授权日期和范围、获取授权的用户的信息
- 创建艺术家页面,例如Marya Filatova
- 修改MediaWiki:Licenses,在“授权使用”这个小节下添加新的一行。
在此之后,你可以上传艺术家的图片了,授权协议处请选择刚刚添加的艺术家的授权。
提问:如果在此之前我已经上传了该艺术家的某些图片怎么补填版权信息?
- 答:以File:Young_Mahtan_by_Filat.jpg为例,点击“编辑源代码”,在代码中写入{{Permission|Marya Filatova}}即可。注意使用这个模板会自动将这个文件加入Category:Images by Marya Filatova,如果之前写了这段加分类的代码,可以删除了。另,如果代码中有“MsUpload”这样的内容,也请删掉。
图片的布局
为了美观,推荐把正文中的图片放在右侧。同时,不推荐在正文中插入太多图片,如果想展示多张图片请考虑使用画廊。
词条中的链接
可以使用[http://example.com 外部链接说明]和[[魔戒]]这两种语法添加外部链接和内部链接,具体语法请参考帮助文档。
习惯上,在同一个段落内多次出现一个词条名称时,只会将第一次出现处做成链接。
以下是一些小技巧:
说明 | 输入 | 效果 |
---|---|---|
指向某分类的链接 | [[:Category:分类名]] | Category:原著 |
指向英文维基百科的词条链接 | [[Wikipedia:词条名]] | Wikipedia:J. R. R. Tolkien |
指向Tolkien Gateway的词条链接 | [[engtw:词条名]] | 例如engtw:J. R. R. Tolkien |
指向One Wiki To Rule Them All的词条链接 | [[enlotr:词条名]] | 例如enlotr:J. R. R. Tolkien |
指向Thain's Book的词条链接 | [[entb:词条名]]。此处的词条名指的是Thain's Book链接中“.html”之前的那个单词。 | 例如entb:J. R. R. Tolkien |
词条中的引用
请使用{{ref}}或者<ref>...</ref>标注出处。在可能的情况下请尽量使用前者。如果你不确定出处,请标记{{请求来源}}。
通常,一个词条的最后一个段落应该是==引用与注释==,其内容通常是:
==引用与注释== {{reflist|30em}}
以上内容具体语法请参考帮助文档。
注意:{{references}}已被废弃,请使用{{reflist}}代替。
词条中的分类
请为词条添加分类以方便索引,请参考分类添加指南。语法如下[[Category:分类名]]。通常习惯把分类放在页面的比较靠后的位置,详见代码块顺序。
引用其他站点的内容
如果你引用了其他站点的文字内容,请保证你引用的内容不会引起版权纠纷。如果你无法保证这一点,请不要引用该站点的资源。关于版权的更多内容请参考著作权。
通常来讲,你可以通过如下声明引用其他站点内容,具体是否可以引用依然要向被引用的页面确认
说明 | 输入 | 示例 |
---|---|---|
引用英文维基百科 | {{EnWP|英文维基百科词条名}} | 暂缺 |
引用Thain's Book | {{EnTB|Thain's Book词条名}} | Entmoot词条声明了{{EnTB|meetings}},效果如下 模板:EnTB |
引用Tolkien Gateway | {{EnGTW|Tolkien Gateway词条名}} | 魔戒词条声明了{{EnGTW|The Lord of the Rings}},效果如下 模板:EnGTW |
引用One Wiki to Rule Them All | {{EnLOTR|英文LOTR维基词条名}} | 暂缺 |
通常来讲,你应该在页面靠近底部声明这些信息,详见代码块顺序。
词条的外语链接
代码中类似如下内容是语言链接[[de:Der Herr der Ringe]],由两部分组成:
- 冒号之前是语言,例如de代表德语,你可以在此查看本维基支持的所有外语链接。
- 冒号之后是该语言的魔戒维基对应的词条名
你可以(而非必需)从词条对应的Gateway词条或EnLOTR词条搬运语言链接(除中文之外)。通常,语言链接应该放在代码的最后,详见详见代码块顺序。
容易被混淆的词条
如有多个词条使用同一名字如娜梅莉亚,则创立一个娜梅莉亚(消歧义)(请使用英文括号),并且保持源头词条不变,如娜梅莉亚,而其他词条作出相应变更:娜梅莉亚(冰原狼)、娜梅莉亚(船)、娜梅莉亚·沙德。诸如此类。
如果你的词条名称是英文(因为暂时没拿到译名),又需要处理歧义问题,例如Aeglos,请使用英文名创建有歧义的页面和消歧义页,例如Aeglos (plant)和Aeglos (disambiguation),而不是Aeglos (植物)和Aeglos (消歧义),否则词条名称一半英文一半中文很奇怪。注意,与中文习惯不同的是,英文词条左括号之前要空一格。
如果词条本身没有歧义,但因为名称近似等其他原因可能与其他词条混淆,可以使用{{Dont confuse|message}},例如{{Dont confuse|请不要和[[临冬城]]的女仆[[杰兹(女仆)|杰兹]]混淆。}}
最佳实践
练习
你可以在沙盒中练习,不必害怕出错。
如何避免编辑冲突
按段落编辑
为避免和其他编辑者冲突,可以缩小编辑范围,只编辑一个段落。方法是点击某个段落标题旁边的“[编辑源代码]”按钮。
正在施工的词条请拉好警戒线
在进行大段编辑前,可以先拉上正在施工警戒线,方法如下:
{{正在施工|username|your comments}}
其中,comments参数可以缺省。例如:
这篇文章正在被编辑中,完成前请不要同时编辑,以免撞车。本提示有效期15天,过期请协助解除。
此路是我开,此树是我栽编辑者签名:卢斯 波顿
编辑完成后记得去掉哦。
请填写编辑摘要
编辑完成,提交之前请填写编辑摘要,以描述这一次编辑的主要内容。如果改变比较小(例如只是修改了一个错别字),可以设置为“小编辑”。
维护代码整洁
维护wikitext的整洁对后来的编辑者会有比较大的帮助,在此提出以下几点建议
代码块顺序
推荐代码块使用如下顺序:
- 需要在页面初始位置显著标明的信息,例如{{需要翻译}}、{{需要帮助}}
- 有助于消除歧义或误解的信息,例如{{See homonyms}}、{{Dont confuse}}
- info box,例如{{Infobox character}},请参考词条信息卡(info box)小节
- 词条摘要,请参考词条摘要小节
- 正文各个段落,请参考词条正文小节
- ==引用与注释==段落,请参考词条中的引用小节
- 引用其他站点的内容说明,请参考引用其他站点的内容小节
- 声明分类,请参考词条中的分类小节
- 声明{{DEFAULTSORT}},请参考词条的排序小节
- 声明外语链接,请参考词条的外语链接小节
适当的换行
在代码段落间保持适度的换行可以提高代码可读性。换行以一到两行为宜。
复用代码
如果你发现你在写大量重复的代码,请考虑把这些代码做成模板。