# Sample workflow for building and deploying a mdbook site to GitHub Pages # # To get started with mdbook see: https://rust-lang.github.io/mdBook/index.html # name: Deploy mdbook site to Pages on: # Runs on pushes targeting the default branch push: branches: [$default-branch] # Allows you to run this workflow manually from the Actions tab workflow_dispatch: # Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages permissions: contents: read pages: write id-token: write # Allow one concurrent deployment concurrency: group: "pages" cancel-in-progress: true jobs: # This workflow contains a single job called "build" build: env: MDBOOK_VERSION : 0.4.21 # The type of runner that the job will run on runs-on: ubuntu-latest # Steps represent a sequence of tasks that will be executed as part of the job steps: # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it - uses: actions/checkout@v3 # Runs a single command using the runners shell - name: install mdbook run: | curl --proto '=https' --tlsv1.2 https://sh.rustup.rs -sSf -y | sh rustup update cargo install --version ${MDBOOK_VERSION} mdbook - name: Setup Pages id: pages uses: actions/configure-pages@v1 - name: Build with mdbook run: mdbook build - name: Upload artifact uses: actions/upload-pages-artifact@v1 with: path: ./book deploy: environment: name: github-pages url: ${{ steps.deployment.outputs.page_url }} runs-on: ubuntu-latest needs: build steps: - name: Deploy to GitHub Pages id: deployment uses: actions/deploy-pages@v1