Блог

Общая идея заключается в том, чтобы иметь несколько сайтов документации mkdocs в одном репозитории. Вот так:

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

Я использую этот скрипт .github/workflows/ci.yml для развертывания master на push

 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/