我需要托管我项目的多个版本(比如1.0,2.0和3.0)的文档,并且所有这些都是活动(文档)分支,我们将继续对所有这些进行改进。 为此可以使用GitHub页面吗?
感谢您的任何帮助。
答案 0 :(得分:1)
使用Github Actions以及您选择的静态站点生成器(SSG),例如VuePress,Gatsby,Jekyll等是可行的。
以最简单的形式,创建GH动作以生成分支/发行版的静态站点文件夹,然后将该文件夹推送到GH页面所指向的分支中相应的文件夹,例如 gh-pages 。分支/发行版之一应推入根目录。 GitHub Pages Deploy Action可能会有所帮助。在指向匹配文件夹的静态网站中添加版本下拉列表。
示例:
答案 1 :(得分:0)
这是关于如何在(gh-pages)分支回购中构建文档,而不是关于GitHub页面。
您有不同的组织示例,例如:
但是这个想法仍然是一样的:你需要在gh-pages分支中组织你的文件夹,因为你需要代表你需要的东西(这里是你的项目每个标签的一组文件)
答案 2 :(得分:0)
您可以看看gh-pages-multi。
这是我编写的一个小nodejs工具,用于将不同版本的文档推送到gh-pages分支的子目录中。它还会生成一个index.html文件,列出这些子目录。
如果要自动构建和推送文档,可以很容易地集成到CI工作流程中。
还请注意“ --no-history”选项,如果您的文档包含一些内置文件或二进制资产,该选项将防止git repo膨胀。
答案 3 :(得分:0)
这些其他答案使事情变得过于复杂。正如@jhpratt 在评论中所建议的那样,您只需将与您要部署的站点版本相对应的代码复制到您部署到 gh-pages 的目录中的目录(标记为例如 v1.0
)。然后您可以使用 https://your-name.github.io/your-repo/v1.0/
访问该版本。
当然,根据您正在构建的网站类型,您可能需要担心每个版本的 <base href="...">
标签内容等,但无论如何您都需要担心这个标签因为 github 页面不会部署到 url 根目录。