文档维护
本文档维护在 go-eagle/go-eagle.org 仓库中,采用 docusaurus 作为文档系统。仓库内容更新后,会自动触发 Github Actions 对文档进行生成和部署。
添加/修改文档
首先 fork 文档仓库,并 clone 到本地。
然后在docs目录中的对应子目录下可以添加或修改相应的文档。文档格式为 Markdown,并支持一些扩展的语法,具体支持的语法请参考 Docusaurus: Markdown Features
注意下列事项:
- 文档正文的子标题请使用二级或更低等级的标题,即
##
或###
等,避免使用一级标题。 - 对于文档内其它页面可以直接通过类似 markdown link 相对路径的方式 进行引用
- 如果添加了新的文档,请按照后文的说明进行侧边栏的修改,以便文档能够展示在侧边栏中。
提交到Github后,向源仓库master
分支发起 Pull Request, 等待维护团队合并。
修改侧边栏
侧边栏的条目维护在文件 sidebars.js 中,如果需要修改侧边栏,请编辑此文件。
将docs
下面的目录名和文档 id 填入 json 中。
该文件的具体配置方法请参考 Docusaurus: Sidebar
文档翻译
如果您要维护多语言翻译,请将文档仓库 clone 到本地。
在i18n
目录下的对应语言目录,如英文版本在i18n/en/docusaurus-plugin-content-docs/current
可以找到或创建与docs
目录对应的文件,注意 id 要与docs
中对应文件的 id 相同。进行相应的文档翻译后提交即可。
具体文档翻译功能的扩展使用,请参考 Docusaurus: i18n - Using git