Apply changes from freerange #5
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
| # | |
| # This GitHub Actions workflow builds and deploys the re-frame documentation website hosted on GitHub Pages at: | |
| # https://day8.github.io/re-frame/ | |
| # | |
| # More about the build process are documented at | |
| # https://github.com/day8/re-frame/blob/feature/mkdocs/docs/developer-notes.md | |
| name: docs | |
| on: | |
| push: | |
| branches: 'master' | |
| jobs: | |
| # The ns-to-markdown job generates API documentation from the source code and uploads that as an artifact. | |
| ns-to-markdown: | |
| name: re-frame.core Markdown | |
| runs-on: ubuntu-20.04 | |
| container: | |
| # Source: https://github.com/day8/dockerfiles-for-dev-ci-images | |
| image: ghcr.io/day8/chrome-56:2 | |
| credentials: | |
| username: ${{ github.actor }} | |
| password: ${{ secrets.GITHUB_TOKEN }} | |
| steps: | |
| - name: Checkout Current Branch | |
| uses: actions/checkout@v2 | |
| with: | |
| fetch-depth: 0 | |
| - run: git config --system --add safe.directory /__w/re-frame/re-frame | |
| - name: Build re-frame.core Documentation | |
| working-directory: docs | |
| # Source: https://github.com/day8/re-frame/blob/master/docs/src/ns_to_markdown.clj | |
| run: clojure -m ns-to-markdown ../src/re_frame/core.cljc > api-re-frame.core.md | |
| - name: Build re-frame.alpha Documentation | |
| working-directory: docs | |
| # Source: https://github.com/day8/re-frame/blob/master/docs/src/ns_to_markdown.clj | |
| run: clojure -m ns-to-markdown ../src/re_frame/alpha.cljc > api-re-frame.alpha.md | |
| - name: Upload re-frame.core Documentation Artifact | |
| uses: actions/upload-artifact@v2 | |
| with: | |
| name: api-re-frame.core.md | |
| path: docs/api-re-frame.core.md | |
| - name: Upload re-frame.alpha Documentation Artifact | |
| uses: actions/upload-artifact@v2 | |
| with: | |
| name: api-re-frame.alpha.md | |
| path: docs/api-re-frame.alpha.md | |
| # This job builds the re-frame :docs app and uploads it as an artifact. | |
| # The app renders code blocks for the reader reader to edit & evaluate. | |
| re-frame-docs-app: | |
| name: Re-frame Docs App | |
| runs-on: ubuntu-20.04 | |
| container: | |
| image: ghcr.io/day8/dockerfile-for-dev-ci-image/dev-ci:1 | |
| credentials: | |
| username: ${{ github.actor }} | |
| password: ${{ secrets.GITHUB_TOKEN }} | |
| steps: | |
| - name: Checkout Current Branch | |
| uses: actions/checkout@v2 | |
| - run: git config --system --add safe.directory /__w/re-frame/re-frame | |
| - name: Maven cache | |
| id: maven-cache | |
| uses: actions/cache@v1 | |
| with: | |
| path: /root/.m2/repository | |
| key: ${{ runner.os }}-maven-${{ hashFiles('project.clj', '.github/workflows/**') }} | |
| restore-keys: | | |
| ${{ runner.os }}-maven- | |
| - name: Install node packages | |
| run: | | |
| npm install | |
| - name: Run lein docs | |
| if: steps.maven-cache.outputs.cache-hit != 'true' | |
| env: | |
| CLOJARS_USERNAME: ${{ secrets.CLOJARS_USERNAME }} | |
| CLOJARS_TOKEN: ${{ secrets.CLOJARS_TOKEN }} | |
| GITHUB_USERNAME: ${{ github.actor }} | |
| GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} | |
| run: | | |
| lein docs | |
| - name: Run lein -o docs | |
| if: steps.maven-cache.outputs.cache-hit == 'true' | |
| env: | |
| CLOJARS_USERNAME: ${{ secrets.CLOJARS_USERNAME }} | |
| CLOJARS_TOKEN: ${{ secrets.CLOJARS_TOKEN }} | |
| GITHUB_USERNAME: ${{ github.actor }} | |
| GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} | |
| run: | | |
| lein -o docs | |
| - name: Create re-frame-docs App Artifact | |
| working-directory: docs | |
| run: | | |
| tar Jcf re-frame-docs-app.tar.xz js | |
| - name: Upload re-frame-docs App Artifact | |
| uses: actions/upload-artifact@v2 | |
| with: | |
| name: re-frame-docs-app | |
| path: docs/re-frame-docs-app.tar.xz | |
| # MkDocs is the actual static site generator. It downloads the api-re-frame.core.md and docs app artifacts, | |
| # then generates additional files based on configuration and markdown. | |
| mkdocs: | |
| name: MkDocs | |
| needs: | |
| - ns-to-markdown | |
| - re-frame-docs-app | |
| runs-on: ubuntu-22.04 | |
| container: | |
| image: "squidfunk/mkdocs-material:5.5.9" | |
| steps: | |
| - name: Checkout Current Branch | |
| uses: actions/checkout@v2 | |
| - run: git config --system --add safe.directory /__w/re-frame/re-frame | |
| - name: Download api-re-frame.core.md Artifact | |
| uses: actions/download-artifact@v2 | |
| with: | |
| name: api-re-frame.core.md | |
| path: docs | |
| - name: Download api-re-frame.alpha.md Artifact | |
| uses: actions/download-artifact@v2 | |
| with: | |
| name: api-re-frame.alpha.md | |
| path: docs | |
| - name: Download re-frame-docs App Artifact | |
| uses: actions/download-artifact@v2 | |
| with: | |
| name: re-frame-docs-app | |
| path: docs | |
| - name: Extract re-frame-docs App Artifact | |
| working-directory: docs | |
| run: tar Jxf re-frame-docs-app.tar.xz | |
| - name: Build MkDocs Documentation | |
| run: mkdocs build | |
| - name: Create MkDocs Artifact | |
| run: tar zcf mkdocs.tar.gz site/ | |
| - name: Upload MkDocs Artifact | |
| uses: actions/upload-artifact@v1 | |
| with: | |
| name: mkdocs | |
| path: mkdocs.tar.gz | |
| # The GitHub Pages job downloads the final MkDocs artifact and commits it to the gh-pages branch for deployment. | |
| github-pages: | |
| name: GitHub Pages | |
| needs: mkdocs | |
| runs-on: ubuntu-20.04 | |
| steps: | |
| - name: Checkout GitHub Pages Branch | |
| uses: actions/checkout@v2 | |
| with: | |
| ref: "gh-pages" | |
| path: "gh-pages" | |
| - name: Download MkDocs Artifact | |
| uses: actions/download-artifact@v1 | |
| with: | |
| name: mkdocs | |
| - name: Extract MkDocs Artifact | |
| run: | | |
| tar zxf mkdocs/mkdocs.tar.gz | |
| rm -rf gh-pages/* | |
| cp -Rv site/* gh-pages/ | |
| - name: Commit | |
| working-directory: ./gh-pages | |
| run: | | |
| git config --local user.email "[email protected]" | |
| git config --local user.name "GitHub Action" | |
| git add -A | |
| git commit -m "Update docs" | |
| - name: Push | |
| working-directory: ./gh-pages | |
| run: | | |
| REMOTE="https://${GITHUB_ACTOR}:${GITHUB_TOKEN}@github.com/${GITHUB_REPOSITORY}.git" | |
| git push "${REMOTE}" HEAD:gh-pages |