Merge pull request #1050 from synfinatic/builds-for-forks #84
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
name: Build/Publish Docs on main | |
on: | |
push: | |
branches: | |
- main | |
paths: | |
- '.github/**' | |
- 'docs/**' | |
- 'mkdocs.yml' | |
tags-ignore: ['**'] | |
permissions: | |
contents: write | |
jobs: | |
deploy: | |
runs-on: ubuntu-latest | |
steps: | |
- uses: actions/checkout@v4 | |
with: | |
fetch-depth: 0 | |
- uses: actions/setup-python@v5 | |
with: | |
python-version: 3.11.6 | |
- name: Install Dependencies | |
run: | | |
pip install -r docs/requirements.txt | |
- name: Setup Docs Deploy | |
run: | | |
git config --global user.name "Docs Deploy" | |
git config --global user.email "docs.deploy@synfin.net" | |
- name: Build Docs Website | |
run: mike deploy --config-file mkdocs.yml --push develop | |
# name: Update Docs | |
# on: | |
# push: | |
# branches: | |
# - main | |
# paths: | |
# - '.github/**' | |
# - 'docs/**' | |
# - 'mkdocs.yml' | |
# jobs: | |
# build: | |
# name: Deploy docs | |
# runs-on: ubuntu-latest | |
# steps: | |
# - name: Checkout main | |
# uses: actions/checkout@v4 | |
# | |
# - name: Deploy docs | |
# uses: synfinatic/mkdocs-deploy-gh-pages@bump-mkdocs | |
# # mhausenblas/mkdocs-deploy-gh-pages@master is an old version of mkdocs, so using my own | |
# # Or use mhausenblas/mkdocs-deploy-gh-pages@nomaterial to build without the mkdocs-material theme | |
# env: | |
# GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} | |
# # CUSTOM_DOMAIN: optionaldomain.com | |
# CONFIG_FILE: mkdocs.yml | |
# # EXTRA_PACKAGES: build-base | |
# # GITHUB_DOMAIN: github.myenterprise.com | |
# REQUIREMENTS: docs/requirements.txt |