从文档和 jekyll 源文件夹配置提供服务的 GitHub 页面

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 分支
• 主分支
• master 分支 /docs 文件夹
• 禁用 GitHub 页面。

前三个选项定义您的根发布文件夹。

Github 页面使用此根文件夹来生成您的网站。您无法source覆盖_config.yml.

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

- project
| - _docs
| | content
| | files
| | tools
|
| - docs << output here