Jekyll 创建版本化文档归档

Jekyll 创建版本化文档归档,jekyll,Jekyll,我正在为一个开源项目重建一个API文档站点,我们希望在这里保存以前版本的存档。我想知道如何配置Jekyll以生成正确的层次结构 在当前的/docs文件夹中,我们有以下目录布局(我们希望以某种方式在Jekyll中重用): 每当我们发布一个新版本时,当前文件夹就会被复制到一个新文件夹中(比如v4)。每个文件夹的内容如下所示: introduction.md testing.md api-foo.md api-bar.md 我希望这些可以在urldomain.com/v3/testing/,doma

我正在为一个开源项目重建一个API文档站点,我们希望在这里保存以前版本的存档。我想知道如何配置Jekyll以生成正确的层次结构

在当前的
/docs
文件夹中,我们有以下目录布局(我们希望以某种方式在Jekyll中重用):

每当我们发布一个新版本时,
当前
文件夹就会被复制到一个新文件夹中(比如
v4
)。每个文件夹的内容如下所示:

introduction.md
testing.md
api-foo.md
api-bar.md

我希望这些可以在url
domain.com/v3/testing/
domain.com/current/testing/
,等等下获得。我认为我可能可以使用集合来实现这一点,每个版本有一个集合。为此,我看到自己自动更新了_config.yml作为a)的一部分,但我不确定如何从这里开始,或者使用集合进行更新是否是一种错误的方法……

这是一个太简短的更新,没有真正的质量,但我想我会提到,我们最终在Sinon项目中解决了这个问题。在GitHub sinonjs/sinon上查看repo,查看docs文件夹以及从package.json调用的脚本

您可以通过编辑并添加内容和链接来改进此答案

introduction.md
testing.md
api-foo.md
api-bar.md