跳转至

为维基的未来做出贡献

你是起源引擎忠实的爱好者和守护者吗?“起源维基”允许开发者们自由地发布和编辑文章,创造一个有价值的开发者社区。

撰写文章

想要在起源维基里发布文章,分享知识?没问题!

如果你不想在 Github 上费心分叉站点,直接把文章交给我吧!如果你的文章在其他平台发布过,可以将链接发给我。

准备工作

警告

切记请勿花费太多时间在准备阶段。

VSC

用于预览编辑好的网页。

打开终端并使用以下命令安装 Material for MkDocs1

pip install mkdocs-material

安装结束后即可在本地预览做好的网页,只需在VSC里打开整个文件夹并输入:

mkdocs serve 

拷贝终端给出的链接后可以在浏览器里打开预览。

保存后,服务器将自动重建站点。

Typora之类的Markdown编辑软件

用于编辑页面。

发布文章

  1. 在右上角找到本维基的存储库,分支此存储库。
  2. 在相应目录中创建一个新 markdown 文件并填写相关的 YAML 字段。
  3. 在根目录中找到mkdocs.yml文件,并且设置导航。
  4. 测试是否能正常运行不报错,预览界面。
  5. 推送你的更改,并发起一个拉取请求。

编辑文章

  1. 点击文章右上角的编辑按钮,在github页面对文章进行更改。
  2. 完成修改后提交更改。

  1. 本网站使用了 Mkdocs 作为模板,因此部分原理可参考官方维基。 

评论