Project:Documentation
文档 | |
---|---|
准备 | |
1.什么是激战2中文wiki? | |
2.谁在运营和维护? | |
3.灰机wiki是什么? | |
4.我能做什么? | |
开始 | |
1.注册wiki账号 | |
2.源代码编辑 | |
3.大括号是什么? | |
4.如何搬运? | |
5.如何重命名页面? | |
6.如何删除页面? | |
7.如何处理编辑冲突? | |
8.讨论 | |
9.参与任务 | |
进阶 | |
1.模板的使用 | |
2.数据的调用 | |
3.撰写攻略 | |
4.管理任务 | |
高级 | |
1.功能性模板索引 | |
2.导航性模板索引 | |
3.Lua模块索引 | |
4.本站数据索引 | |
5.成为开发者 |
这是一篇关于激战2中文wiki的综合性文档。
帮助
准备
什么是激战2中文wiki?
- 「激战2中文wiki」是一个关于「激战2」游戏的百科类网站。
- 该wiki托关于「灰机wiki」。
- 该wiki是一个由「MediaWiki」驱动的wiki。
谁在运营和维护这个wiki?
- 该站点最早由玩家自发申请和建立
- 该站点在2020年由激战2的国服运营方「空中网」领养并提供支持,鼓励更多的玩家参与编辑
- 灰机的SerGawen会参与到项目中来提供技术帮助和支持
灰机wiki是什么?
- 「灰机wiki」是一个中文的「维基农场」(维基自助托管平台),创建于2015年2月。
- 目前「灰机wiki」已有超过10万注册用户,月活跃编辑人数超过7,000人。
我能做什么?
- 翻译:有大量来自arena官方英文wiki的条目亟需翻译。
- 参与管理:灰机wiki上的任何wiki都是由玩家社区自管自治的(无论是否有官方或灰机staff参与),您可以在这里扮演规划者和组织协调者的角色。
- 技术开发:灰机wiki提供了绝无仅有的开放权限和技术架构,在这里您可以自由的进行以「JavaScript」、「HTML」为主的泛前端开发,赋予wiki更强的功能属性和实用性。
- 美术设计:灰机wiki同样提供了自由的前端设计架构,无论是UI/UX还是普通的美术设计都可以高度自定义化。
开始
注册wiki账号
wiki人人皆可编辑,因此不需要下载软件,也不存在“翻译好了把文本发你”这种场景。
您可以随时点开页面进行编辑并提交保存,哪怕只是修改一个错字或者标点符号。
请使用源代码模式进行编辑
因为如下原因,请您使用「源代码编辑器」进行页面的搬运和编辑:
- arena英文wiki并未开启「可视化编辑器」功能,加之该站点使用了大量「Semantic MediaWiki」的函数,以及基本逻辑构建全部由可读性极差的wikitext构成……
- 上述代码会对「可视化编辑器」造成极大的解析压力,无法保证正常使用。
- 使用「源代码编辑器」可以更加方便新手了解和掌握MediaWiki的编辑流程。
那些大括号是什么?(wikitext)
Wiki标记语言(Wiki markup language),亦称Wiki Markup、Wikitext、wiki代码,是一种轻量级标记(Markup)语言。由三部分构成
- 样式控制:类似现在流行的Markdown语言,主要是HTML语言的简化写法。
- 逻辑运算:通过解析器函数扩展提供,现在已经被吸收成为MediaWiki的默认组件,并可以通过其他扩展增加新的函数,适用于逻辑结构简单、嵌套较少的场景,能够便捷的为编辑者提供一些格式化、判断上的便利。对于较为复杂的逻辑运算,我们推荐使用Lua模块来实现。
- HTML:wikitext支持大多数的html代码,比如
<div>
,但一些带有url的标签和css属性,会被MediaWiki拦截(防止注入),比如<a>。您可以通过获得开发者权限,在更高级的模板和功能中使用这些标签。
- 参考:h:帮助:站点CSS编辑
- 参考:h:使用CSS变量
- 参考:h:帮助:CSS样式库
- 参考:h:帮助:HTML
- 参考:h:帮助:站点JS编辑
如何搬运一篇Arena上的英文条目?
- step1
- 前往页面
- 您可以通过两种途径前往您想去的页面:
- step2:创建页面
- h:帮助:创建新页面
- 点击 [[ ]] 即可进入源代码编辑器,如果这个页面不存在,就相当于是在创建它
- step3:复制代码
- step4:提交保存
关于搬运
- 先确认页面是否存在
对于MediaWiki来说,页面是严格按照“页面名”匹配的,一字之差即是两个不同的页面,请先确认你要搬运的页面是否已经存在于其他译名中,比如,当您要搬运“队伍”时,先确认是否存在叫做“小队”的页面。
- 并非什么页面都需要搬运
游戏页面是通过技术手段批量创建生成的,比如物品、技能,这类页面请先和管理员确认之后再决定是否搬运。
- 模板代码如何处理
对于使用花括号括起来的内容,以及各种被代码着色的部分,要酌情处理,一般来说,加粗的部分表示模板的key,不能随便修改,非加粗的部分即为模板的参数内容,有些可以修改,比如描述性的文字,有些是作为key-value的查询依据,最好不要修改。具体来说请先联系管理员之后再决定是否翻译。
如何使用自动翻译功能?
在源代码编辑器下,点击自动翻译按钮(如图),会对指定的链接文字、有匹配规则的正则表达式和文本进行替换
- 参考:h:帮助:自动翻译
- 注意,翻译需要在MediaWiki:Huiji-translation-pairs页面中进行配置,配置方法参考上面的帮助文档链接。
如何重命名一个页面?
MediaWiki的机制下面没有「重命名」,只需要将页面「移动即可」(可能需要管理员权限)
- 参考:h:帮助:移动页面
如何删除一个页面?
只有管理员以上权限的用户才可以删除一个页面。
- 请注意,如果将页面内容无端清空,可能会被认为是恶意编辑,请参考:h:帮助:恶意编辑
如何处理编辑冲突?
任何对页面的在线编辑都有可能触发“编辑冲突”
- 请参考:h:帮助:编辑冲突
但请不需要过度担心,以下方法可以避免99.99%的编辑冲突:
- 按照项目规划进行翻译、修改工作,事前与其他编辑合理分工,协调工作。
- 尽量减短占用页面编辑的时间,可以编辑几十~一百字就进行保存,这样可以有效防止长期占用编辑导致的冲突。
翻译的讨论
关于翻译的事宜,原则上按照空中网的国服译名,
- 对于外服译名,可以进行重定向处理,请参考:h:帮助:重定向
- 对于国服译名,请参考:术语、MediaWiki:Huiji-translation-pairs
- 对于民间黑化:请参考:简称
参与一个任务
进阶
模板的使用
数据的调用
- API:底层数据由arena官方API获得,
- 通过本地python脚本处理成为符合灰机mongoDB数据标准的Data文件上传到站点入库,参考:h:帮助:MongoDB支持
- 站点逻辑层:一方面尽可能的支持arena官方英文wiki的模板和代码,另一方面将尽可能多的数据同步到mongoDB架构,通过query实现数据的互联和查询。
- 搜索器
- CustomSearch:物品搜索
- AchievementSearch:成就搜索
- RecipeSearch:配方搜索
- 项目大纲
撰写攻略
- step1
前往首页 在攻略部分点击添加攻略按钮
- step2
输入要撰写的攻略的标题,点击创建或编辑
注意:
- 如果该攻略不存在则进入创建攻略界面(全新),此时撰写将生成全新的攻略页面
- 如果该攻略已存在则进入修改攻略界面(有内容),此时撰写将覆盖原有页面,请编辑前确认是否要覆盖
- step3
按照提示进行输入
- 关联概念需要从列表中选择,多次选择可以添加多个概念
- 标签可以手动输入,支持多个标签
- step4
撰写完成后,点击保存页面即可完成
- 如果需要修改该攻略,跳转回step2步骤,输入要修改的攻略的标题即可,点击创建或编辑
管理任务
如果您对当前的任务设计和管理方式有更多想法,可以加入我们的项目组,进行商讨并提出您的建议。