From 7179316367325108c5431617404a4eb92e919595 Mon Sep 17 00:00:00 2001
From: David Goodwin <david@zx.net.nz>
Date: Thu, 28 Nov 2024 20:51:23 +1300
Subject: [PATCH] Generate the distribution versions of the manual

---
 .github/workflows/build.yml | 70 ++++++++++++++++++++++++++++++++++---
 1 file changed, 66 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
index 51be28bd..8c650ef7 100644
--- a/.github/workflows/build.yml
+++ b/.github/workflows/build.yml
@@ -2111,9 +2111,16 @@ jobs:
           popd
         shell: bash
 
-  # Build the manual. A built version of Kermit 95 with REXX support is required
-  # to do this, so we can't do it until after the Build-VisualCxx job has
-  # completed as all the x86 builds have REXX support included
+
+  ##############################################################################
+  # Build the Kermit 95 Manual                                                 #
+  ##############################################################################
+  # A built version of Kermit 95 with REXX support is required to do this, so
+  # we can't do it until after the Build-VisualCxx job has completed as all
+  # the x86 builds have REXX support included
+
+  # This version is for publishing on the internet. HTML files end in .html,
+  # and index.html is the front page of the manual
   Build-Manual-Web:
     runs-on: windows-latest
     # We need at least one artifact from the Build-VisualCxx step but Github
@@ -2134,6 +2141,61 @@ jobs:
       - name: Upload artifact
         uses: actions/upload-artifact@v4
         with:
-          name: k95-manual-web-dev
+          name: k95-manual-web
+          path: ${{ github.workspace }}\dist\docs\manual
+          retention-days: 1
+
+  # This is the normal version for distribution with the application. HTML
+  # files end in .htm, index.htm is the front page of the K95 documentation,
+  # and k95manual.htm is the front page of the manual
+  Build-Manual-Dist:
+    runs-on: windows-latest
+    # We need at least one artifact from the Build-VisualCxx step but Github
+    needs: Build-VisualCxx
+    steps:
+      - uses: actions/checkout@v4
+      - name: Fetch K95
+        uses: actions/download-artifact@v4
+        with:
+          name: k95-vc14.2-x86
+          path: ${{ github.workspace }}\dist
+      - name: Prepare Documentation
+        run: |
+          set root=${{ github.workspace }}
+          call mkdocs.bat /D
+        shell: cmd
+        working-directory: ${{ github.workspace }}\doc
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: k95-manual-dist
+          path: ${{ github.workspace }}\dist\docs\manual
+          retention-days: 1
+
+  # This is a version for distribution with Kermit 95 for vintage PCs. It's the
+  # same as the normal version above, but doesn't use https:// links. Files
+  # end in .htm, index.htm is the front page of the K95 documentation, and
+  # k95manual.htm is the front page of the manual
+  Build-Manual-Dist-Vintage:
+    runs-on: windows-latest
+    # We need at least one artifact from the Build-VisualCxx step but Github
+    needs: Build-VisualCxx
+    steps:
+      - uses: actions/checkout@v4
+      - name: Fetch K95
+        uses: actions/download-artifact@v4
+        with:
+          name: k95-vc14.2-x86
+          path: ${{ github.workspace }}\dist
+      - name: Prepare Documentation
+        run: |
+          set root=${{ github.workspace }}
+          call mkdocs.bat /D /I
+        shell: cmd
+        working-directory: ${{ github.workspace }}\doc
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: k95-manual-dist-vintage
           path: ${{ github.workspace }}\dist\docs\manual
           retention-days: 1
\ No newline at end of file