ci: Automatically generate a release from a tag, upload pdf version t…

…o release.

.github/workflows/deploy-gh-pages.yml

@@ -4,6 +4,8 @@ on:
   push:
     branches:
       - master
+    tags:
+      - "*"
   pull_request:
     branches:
       - master
@@ -23,6 +25,7 @@ jobs:
       - name: Build
         run: npm run build
       - name: Upload build artifacts
+        if: "!startsWith(github.ref, 'refs/tags/')"
         uses: actions/upload-artifact@v3
         with:
           name: build-output
@@ -32,6 +35,9 @@ jobs:
     name: Deploy
     runs-on: ubuntu-latest
     needs: build
+    # Only deploy non-tagged builds (otherwise we deploy twice when
+    # we tag a release).
+    if: "!startsWith(github.ref, 'refs/tags/')"
     permissions:
       contents: write
     steps:
@@ -53,7 +59,11 @@ jobs:
   pdf:
     name: Generate PDF Version
     runs-on: ubuntu-latest
+    permissions:
+      contents: write
     needs: build
+    # Generate a new release every time there's a tag.
+    if: startsWith(github.ref, 'refs/tags/')
     steps:
       - name: Download build artifacts
         uses: actions/download-artifact@v3
@@ -75,10 +85,9 @@ jobs:
           # Generate PDF
           npx docusaurus-prince-pdf -u http://localhost:1337/rust-book-abridged --output rust-book-abridged.pdf
           # Kill server
-          fuser -k 1337/tcp 
-      - name: Upload PDF Artifact
-        uses: actions/upload-artifact@v3
+          fuser -k 1337/tcp
+      - uses: ncipollo/release-action@v1
         with:
-          name: rust-book-abridged.pdf
-          path: rust-book-abridged.pdf
-          if-no-files-found: error
+          generateReleaseNotes: true
+          makeLatest: true
+          artifacts: "rust-book-abridged.pdf"

docs/ch00-intro.md

@@ -7,7 +7,7 @@ hide_title: true
 
 <div align="center">
     <h1>The Rust Book (Abridged)</h1>
-    <p>v0.2.0 - Draft</p>
+    <p>v0.2.1 - Draft</p>
     <p>By Jason Walton</p>
     <p>Based on <a href="https://doc.rust-lang.org/stable/book/">"The Rust Programming Language"</a> by Steve Klabnik and Carol Nichols.</p>
 </div>