Skip to content

浏览数:0

如何开始协作 LoM-wiki

💡 注意

此处提供编辑 wiki 相关的基础知识,
有关游戏数据查找,请至其他页面。

写在学习之前

你不用全部学完,也可以开始贡献你的力量。

你不用很厉害才能开始,但你开始了就会慢慢变得厉害。

第一步 - 创建 Github 帐户

本站创建于 Github 上,仰赖 Github Page 的便利性,实现长期 wiki 站点架设

也因此,如果想要编辑本站文档,需要持有 Github 帐户。

  • 请至 http://github.com 创建帐户,需要输入 用户名 / 信箱 / 密码
  • 填写完送出后,会有帐号方案选择,请选择 free(免费)
  • 之后到信箱收验证信,到此帐户创建完毕
如果要求必须绑定二阶段验证

请在手机安装 Authenticator
https://github.com/settings/security 这个页面,
选择 Authenticator app,按照指示完成绑定动作。

第二步 - 获得协作权限(非必要)

选择以下任一步骤

提供你创建 Github 的信箱
由我这边打开协作权限

有没有权限差异在于

  • 可以从文档下方的 在 Github 上编辑此页面 进行调整
  • 更新文档的操作不需要经过验证
  • 可以验证来自非协作者的提交

第三步 - 编辑文档

💡 欢迎补充

编辑文档有很多方式,可能有缺漏,欢迎在留言处提供。

💡 注意

跳过第二点的话,编辑文档的提交需要等待审查

在 Github 中直接编辑

透过文档下方的 在 Github 上编辑此页面 进行调整

操作示意图

可以点击图片放大

使用 Github 原生的文档编辑器进行调整,
左上是模式切换,预设Edit编辑模式,
Preview 可以在存盘前,预先查看修改后的结果。

操作示意图2

都完成后点击右上角的Commit changes
弹出的窗口也点击Commit changes,完成单文档的编辑。


本地编辑

💡 注意

此条例预设面向 Git 小白
使用方法偏向土法炼钢,
提供手把手的 GUI 操作,

原本就有一定 Git 知识的开发人员
请按照习惯的方式进行本地作业。

点击本站右上的图标,跳转至项目首页

💡 注意

此处务必将左侧的该段文字保存记下,
示意图中是 'Mr-Smilin 测试'
我们称呼他C纪录,之后会用到

点击绿色的Code按钮,Download ZIP
将本 wiki 整包下载至电脑内,
找个方便开发的地方整理好,进行解压缩。

进入项目的 docs 文件夹,所有的 wiki 编辑都在此处增改

  • 目录下的 .md 档对应 wiki 条例,可从网站网址寻找对应名称
    网址示意图

  • en 文件夹内存放英文版本的同名 wiki 文件,维护时可协助添加修改
  • public 存放静态资源,例如需要上传图档,请将图档按照 public/images/{md文件分类}/{md文件名}/{图档}.{扩展名}的形式摆放
  • .vitepress 为本项目的设置档,请务必在阅读设置档项目说明后再进行调整

调整完毕后回到 Github

💡 注意

上传前要确认C纪录是否跟你下载时是同一段文字
如果不同,需确认要上传的文件是否刚好有人进行编辑&更新
否则会覆盖到其他人的改动,或是产生冲突!

点进对应的路径
例如编辑文本,那就是点进docs文件夹

示意图

目录相同后,点击右上角的 Add file
选择 Upload files,将修改的文档拖入画面

Add files via upload 的框简单打一下修改了甚么,
之后 Commit changes

网站反应变更约需 1~3 分钟的作业时间。

到此土法炼钢的本地编辑完成。