Skip to content

Publish Book

Publish Book #235

Workflow file for this run

---
name: Publish Book
on:
# Manually trigger workflow
workflow_dispatch:
# Run work flow conditional on linter workflow success
workflow_run:
workflows:
- "MegaLinter"
paths:
- "docs/**"
- "includes/**"
- "overrides/**"
- "mkdocs.yaml"
branches:
- main
types:
- completed
permissions:
contents: write
jobs:
publish-book:
name: MkDocs Publish
runs-on: ubuntu-latest
steps:
- run: echo "🚀 Job automatically triggered by ${{ github.event_name }}"
- run: echo "🐧 Job running on ${{ runner.os }} server"
- run: echo "🐙 Using ${{ github.ref }} branch from ${{ github.repository }} repository"
- name: Checkout Code
uses: actions/checkout@v4
with:
fetch-depth: 0
sparse-checkout: |
docs
includes
overrides
- run: echo "🐙 ${{ github.repository }} repository sparse-checkout to the CI runner."
- name: Setup Python
uses: actions/setup-python@v5
with:
python-version: 3.x
- name: Cache
uses: actions/cache@v4
with:
key: ${{ github.ref }}
path: .cache
- run: pip install mkdocs-material mkdocs-callouts mkdocs-glightbox mkdocs-git-revision-date-localized-plugin mkdocs-redirects pillow cairosvg
- run: mkdocs gh-deploy --force
- run: echo "🐙 ."
# Summary and status
- run: echo "🎨 MkDocs Publish Book workflow completed"
- run: echo "🍏 Job status is ${{ job.status }}."