diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml index 40c46056..359036f1 100644 --- a/.github/workflows/docs.yml +++ b/.github/workflows/docs.yml @@ -2,15 +2,31 @@ name: docs on: push: branches: - - docs - main + tags: + - v* jobs: deploy: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 + with: + fetch-depth: 0 - uses: actions/setup-python@v4 with: python-version: 3.x - - run: pip install mkdocs-material - - run: mkdocs gh-deploy --force + + - name: install tools + - run: pip install mkdocs-material mike + + - name: Setup doc deploy + run: | + git config --local user.email "github-actions[bot]@users.noreply.github.com" + git config --local user.name "github-actions[bot]" + + - name: Deploy version for tag/branch + run: mike deploy --push --update-aliases ${GITHUB_REF_NAME} + - name: Deploy latest version for tag only + if: ${{ github.ref != 'refs/heads/main' }} + run: mike deploy --push --update-aliases latest + - run: mike set-default --push latest diff --git a/mkdocs.yml b/mkdocs.yml index 3efa8337..e8398d32 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -3,10 +3,11 @@ site_description: blocky Documentation theme: name: material palette: - # scheme: slate primary: teal accent: teal extra: + version: + provider: mike social: - icon: fontawesome/brands/github link: https://github.com/0xERR0R/blocky