当使用/ docs作为Github页面的源时,如何将存储库设置为根?

时间:2017-09-12 23:10:16

标签: github-pages

如果我将我的githubpages repo设置为<username>.github.io,则根目录中的任何内容都会显示在<username>.github.io

但是我想使用/docs功能,所以我可以在项目的根目录中有一个静态站点生成器,输出到/docs文件夹

所以docs

- have a /docs folder in the root of the repository
- not follow the repository naming scheme <username>.github.io or <orgname>.github.io

所以,我重命名我的回购,“等等”

但现在没有任何内容显示在<username>.github.io,页面位于<username>.github.io/blah

所以在使用/docs时如何将repo设置为网站<username>.github.io的根?

2 个答案:

答案 0 :(得分:0)

在联系github支持后,事实证明您无法(目前)使用其他使用<username>.github.io的方法

答案 1 :(得分:0)

我发现了同样的问题。 经过数小时的尝试,我发现:

  1. 如果您使用名为“ .github.io”或“ .github.com”的存储库,则只能使用其预先提供的文件结构,这意味着您无法选择github-页面服务。

  2. 如果将存储库重命名为与自动服务模式(.github.io | ... com)不匹配的其他名称,则可以选择源。

  3. 如果是案例[2],则需要在/ docs文件夹下添加一个名为'.nojekyll'的空文件,并将所有文件(包括CNAME和index.html)以及资产文件(图像,css等, )。

ref:https://www.docslikecode.com/articles/github-pages-python-sphinx/