Build website #29
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 website | |
| on: | |
| workflow_call: | |
| workflow_dispatch: | |
| jobs: | |
| build-docs: | |
| name: Build docs (${{ matrix.kind }}) | |
| runs-on: ubuntu-latest | |
| strategy: | |
| matrix: | |
| kind: [internal, public] | |
| steps: | |
| - name: Checkout | |
| uses: actions/checkout@v4 | |
| with: | |
| repository: time-rs/time | |
| - name: Cache cargo output | |
| uses: Swatinem/rust-cache@v2 | |
| - name: Install toolchain | |
| uses: dtolnay/rust-toolchain@nightly | |
| - name: Generate documentation | |
| run: cargo doc -p time --all-features ${{ matrix.kind == 'internal' && '--document-private-items' || '' }} | |
| env: | |
| RUSTDOCFLAGS: --cfg __time_03_docs ${{ matrix.kind == 'internal' && '--document-hidden-items' || '' }} -Zunstable-options --generate-link-to-definition | |
| - name: Upload artifact | |
| uses: actions/upload-artifact@v4 | |
| id: docs-upload | |
| with: | |
| name: ${{ matrix.kind }}-docs | |
| path: target/doc/ | |
| retention-days: 1 | |
| if-no-files-found: error | |
| compression-level: 9 | |
| build-book: | |
| name: Build book | |
| runs-on: ubuntu-latest | |
| steps: | |
| - name: Checkout | |
| uses: actions/checkout@v4 | |
| with: | |
| repository: time-rs/book | |
| - name: Check for typos | |
| uses: crate-ci/typos@master | |
| - name: Install mdbook | |
| uses: taiki-e/install-action@mdbook | |
| - name: Build diagrams | |
| run: | | |
| pip install -r diagrams/requirements.txt | |
| mkdir src/diagrams | |
| python diagrams/diagrams.py | |
| - name: Build book | |
| run: mdbook build | |
| - name: Upload artifact | |
| uses: actions/upload-artifact@v4 | |
| id: book-upload | |
| with: | |
| name: book | |
| path: book/ | |
| retention-days: 1 | |
| if-no-files-found: error | |
| compression-level: 9 | |
| deploy: | |
| name: Deploy | |
| runs-on: ubuntu-latest | |
| needs: [build-docs, build-book] | |
| permissions: | |
| pages: write | |
| id-token: write | |
| environment: | |
| name: github-pages | |
| url: ${{ steps.deployment.outputs.page_url }} | |
| steps: | |
| - name: Checkout | |
| uses: actions/checkout@v4 | |
| with: | |
| sparse-checkout: | | |
| website | |
| - name: Download internal docs | |
| uses: actions/download-artifact@v4 | |
| with: | |
| name: internal-docs | |
| path: website/internal-api | |
| - name: Download public docs | |
| uses: actions/download-artifact@v4 | |
| with: | |
| name: public-docs | |
| path: website/api | |
| - name: Download book | |
| uses: actions/download-artifact@v4 | |
| with: | |
| name: book | |
| path: website/book | |
| - name: Upload website | |
| uses: actions/upload-pages-artifact@v3 | |
| with: | |
| path: website | |
| - name: Deploy | |
| id: deployment | |
| uses: actions/deploy-pages@v4 | |
| - name: Delete artifacts | |
| uses: geekyeggo/delete-artifact@v4 | |
| with: | |
| name: | | |
| internal-docs | |
| public-docs | |
| book | |
| github-pages | |
| failOnError: false | |
| if: always() | |
| continue-on-error: true |