Question about building

[ELEVENStudio-Main]

Can this run on GitHub Pages?

[mondeja]

Yes. See, for example, the next workflow configuration:

Serve Mkdocs docs on Github Pages

name: Github Pages

on:
  push:
    branches:
      - master
  workflow_dispatch:

jobs:
  deploy:
    name: Deploy to Github Pages
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - name: Setup Python v3.8
        uses: actions/setup-python@v2
        with:
          python-version: 3.8
      - name: Install dependencies
        run: |
          python -m pip install --upgrade pip wheel
          python -m pip install .[doc]
      - name: Build documentation
        run: python -m mkdocs build
      - name: Deploy to Github Pages
        uses: peaceiris/actions-gh-pages@v3.8.0
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          publish_dir: ./site

[Andre601]

python -m mkdocs build is imo pointless as you could just configure the repository in the mkdocs.yml and then do python -m mkdocs gh-deploy to build and deploy directly.
No need for the extra push action IMO

See the Material for MkDocs documentation

[mondeja]

IMHO, I think that is better to execute it in your CI workflow.

[ELEVENStudio-Main]

OK.Thanks.