docs.yml

name: documentation

on:
  push:
    branches:    
      - 'main'
  repository_dispatch:

jobs:
  build_docs:
    name: 📚 Build documentation
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3

      - name: Checkout showdown repo
        uses: actions/checkout@v3
        with:
          repository: showdownjs/showdown
          path: repo
      
      - name: ➕ Copy website artifacts
        id: website
        run: |
          rsync -acvh ./ ./public --exclude README.md --exclude repo --delete
      
      - name: 👷 📚 Build documentation
        id: build_docs
        working-directory: ./repo
        run: |
          docker run --rm -v ${PWD}:/docs squidfunk/mkdocs-material build
          rsync -acvh ./public/ ../public/docs

      - name: 🚀 Deploy to GitHub Pages 
        if: steps.build_docs.outcome == 'success'
        uses: peaceiris/actions-gh-pages@v3
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}