如何在* custom目录*下的GitHub Pages上部署mkdocs网站

编程问答 2022-08-13

问题描述

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

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

我使用此脚本.github/workflows/ci.yml在推送​​上部署主服务器

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页设置（用于“自定义”域）：

enter image description here

我只能通过配置来获得结果

www.example.com/getting-started/

而不是 www.example.com/product1/getting-started/

解决方法

暂无找到可以解决该程序问题的有效方法，小编努力寻找整理中！

如果你已经找到好的解决方法，欢迎将解决方案带上本链接一起发送给小编。

小编邮箱:dio#foxmail.com (将#修改为@）

custom-domaingithub-pagesmkdocspython