docs: harden documentation integrity #119
This file contains hidden or 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: GitHub Pages | |
| on: | |
| push: | |
| branches: | |
| - master # Set a branch to deploy | |
| pull_request: | |
| jobs: | |
| deploy: | |
| name: "Deploy Capa.io Pages" | |
| runs-on: ubuntu-22.04 | |
| concurrency: | |
| group: ${{ github.workflow }}-${{ github.ref }} | |
| steps: | |
| - name: "Checkout source code" | |
| uses: actions/checkout@v7 | |
| with: | |
| submodules: recursive # Fetch the Docsy theme | |
| fetch-depth: 0 # Fetch all history for .GitInfo and .Lastmod | |
| - name: "Setup Hugo" | |
| uses: peaceiris/actions-hugo@v3 | |
| with: | |
| hugo-version: '0.145.0' | |
| extended: true | |
| - name: "Setup Node" | |
| uses: actions/setup-node@v6 | |
| with: | |
| node-version: '22' | |
| cache: 'npm' | |
| - name: "Install project dependencies" | |
| run: npm ci | |
| - name: "Install Docsy theme dependencies" | |
| run: cd themes/docsy && npm install | |
| - name: "Create Hugo module directories for Docsy" | |
| run: node themes/docsy/tools/mkdirp-hugo-mod.js themes | |
| - name: "Validate" | |
| run: npm test | |
| - name: "Build" | |
| run: hugo --gc --minify --cleanDestinationDir --destination docs | |
| - name: "Deploy" | |
| uses: peaceiris/actions-gh-pages@v4 | |
| if: ${{ github.ref == 'refs/heads/master' }} # Deploy in master branch only | |
| with: | |
| github_token: ${{ secrets.GITHUB_TOKEN }} | |
| publish_dir: ./docs |