GitLabPages，使用Sphinx生成的文档

我想在GitLab页面上托管用Sphinx生成的静态页面。内置index.html文件位于：

project/docs/build/html

.gitlab-ci.yml部署页面的外观如何 ？我有类似的东西，它不起作用：

pages:
  stage: deploy
  script:
  - echo 'Nothing to do...'
 artifacts:
 paths:
 - docs/build/html
 only:
 - master

小智.. 7

根据.gitlab-ci.yml的文档，该pages作业具有必须遵循的特殊规则：

任何静态内容都必须放在public/目录下

artifactspublic/必须定义目录路径

因此，.gitlab-ci.yml您给出的示例如下所示：

pages:
  stage: deploy
  script:
    - mv docs/build/html/ public/
  artifacts:
    paths:
    - public
  only:
  - master

当然，如果您html出于某种原因不想移动文件夹，则可以复制它。

为了进一步参考，在您最初发布此问题的时间附近推送了一个sphinxGitLab Pages 的示例项目。

根据.gitlab-ci.yml的文档，该pages作业具有必须遵循的特殊规则：

任何静态内容都必须放在public/目录下

artifactspublic/必须定义目录路径

因此，.gitlab-ci.yml您给出的示例如下所示：

pages:
  stage: deploy
  script:
    - mv docs/build/html/ public/
  artifacts:
    paths:
    - public
  only:
  - master

当然，如果您html出于某种原因不想移动文件夹，则可以复制它。

为了进一步参考，在您最初发布此问题的时间附近推送了一个sphinxGitLab Pages 的示例项目。