多版本控制

编写的NJet文档，支持多版本，可以直接在界面上选择对应的版本进行查看。NJet文档的多版本是通过不同的site的进行控制，每个版本对应一个site

创建新版本

  • root
    • Readme.md
    • .gitignore
    • relearn
    • hugo.toml
    • v1.0

从仓库check出来，文档目录顶层结构包括 relearn 目录，hugo.toml,以及已经创建的不同版本的文档，不同的版本每个用独立的目录，比如仓库中存在版本v1.0,则目录结构如上图

通过 new site 命令创建新版本v2.0

hugo new site v2.0

新目录结构如下：

  • root
    • Readme.md
    • .gitignore
    • relearn
    • hugo.toml
    • v1.0
    • v2.0

增加版本切换

需修改hugo.toml增加新版本信息，并把latest指向新的版本 原配置

version = 'v1.0'
[[params.versions]]
    baseURL = 'http://docs.njet.org.cn/contrib/v1.0/'
    identifier = 'v1.0'
    title = 'latest'

新配置

version = 'v2.0'
[[params.versions]]
    baseURL = 'http://docs.njet.org.cn/contrib/v1.0/'
    identifier = 'v1.0'
    title = 'v1.0'
[[params.versions]]
    baseURL = 'http://docs.njet.org.cn/contrib/v2.0/'
    identifier = 'v2.0'
    title = 'latest'