GitHub页面服务于docs和jekyll源文件夹配置

Question

标准F＃的文档（在ProjectScaffold之后）具有以下结构

- project
| - docs
| | content
| | files
| | output
| | tools

生成的文档会保存到output，然后将其推送到gh-pages分支。

最近，GitHub改变了提供页面工作的方式，现在您可以直接从docs分支提供master文件夹。问题是我希望提供的实际文件夹是docs/output。

Jekyll有一个source配置，允许我在本地执行此操作。我的docs/_config.yml只是：

source: output

如果我在本地jekyll serve文件夹中运行docs，该工作正常。但在推送到GitHub后，页面仍然以/output前缀提供。

显然GitHub覆盖了source选项。无论如何这可以解决吗？

Answer 1

Jekyll的文件不清楚。是。

新github页面发布分支/文件夹：

可用选项为（doc）：

• gh-pages branch
• master branch
• master branch / docs文件夹
• 禁用GitHub页面。

三个第一个选项定义根发布文件夹。

Github页面使用此根文件夹生成您的站点。 You cannot override source key in your _config.yml

您可以将来源存储在_docs文件夹中并输出到docs

中

{{1}}