python - 如何在*自定义目录*下的 GitHub 页面上部署 mkdocs 站点

Question

一般的想法是在一个存储库下拥有多个 mkdocs 文档站点。像这样：

- index.html # landing page
  - /product1/getting-started/
  - /product2/getting-started/

我使用此脚本.github/workflows/ci.yml在推送时部署 master

name: ci
on:
  push:
    branches:
      - master
jobs:
  deploy:
    runs-on: ubuntu-latest
  steps:
    - uses: actions/checkout@v2
    - uses: actions/setup-python@v2
      with:
        python-version: 3.x
    - run: pip install mkdocs-material
    - run: mkdocs gh-deploy --force --clean --config-file ./mkdocs.yml --site-dir ./product1

我使用这些 gh-pages 设置（用于自定义域）：

我可以通过玩配置得到的唯一结果是这个

www.example.com/getting-started/

代替 www.example.com/product1/getting-started/