来自 docs 和 jekyll 源文件夹配置的 GitHub 页面答案

【问题标题】：GitHub pages serving from docs and jekyll source folder config来自 docs 和 jekyll 源文件夹配置的 GitHub 页面
【发布时间】：2016-12-17 18:54:36
【问题描述】：

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

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

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

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

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

source: output

如果我在本地的docs 文件夹中运行jekyll serve，那效果很好。但是推送到 GitHub 后，页面仍然以/output 前缀提供服务。

显然 GitHub 覆盖了 source 选项。有没有办法解决这个问题？

【问题讨论】：

没有。这个问题不值得投反对票。它清楚地说明了 Jekyll / gh 页面设置的日益复杂。

标签： github jekyll github-pages

【解决方案1】：

Jekyll 的文档是否不清楚。是的。

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

可用选项为 (doc)：

gh-pages 分支
主分支
主分支/docs文件夹
禁用 GitHub 页面。

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

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

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

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

【讨论】：