Merge pull request #1457 from kernelkit/web

.github/actions/setup-mkdocs/action.yml

@@ -0,0 +1,20 @@
+name: 'Setup MkDocs'
+description: "Install MkDocs and the plugins required to build the Infix User's Guide (post-build.sh bundles it into WebUI images)."
+
+# Mirrors the dependency set in .github/workflows/docs.yml.  Kept in-repo
+# (rather than an external action) so any checkout of a commit needing
+# docs-in-image can reproduce it without an out-of-tree dependency.
+runs:
+  using: composite
+  steps:
+    - name: Install MkDocs and plugins
+      shell: bash
+      run: |
+        command -v pipx >/dev/null 2>&1 || python3 -m pip install --user pipx
+        python3 -m pipx install --force mkdocs
+        python3 -m pipx inject mkdocs \
+          mkdocs-material pymdown-extensions mkdocs-callouts mike mkdocs-to-pdf mkdocs-glightbox
+        # Make the pipx-installed mkdocs visible to later steps (the build,
+        # where post-build.sh invokes it).
+        python3 -m pipx environment --value PIPX_BIN_DIR >> "$GITHUB_PATH" 2>/dev/null \
+          || echo "$HOME/.local/bin" >> "$GITHUB_PATH"

.github/workflows/build-release.yml

@@ -45,6 +45,9 @@ jobs:
           target: ${{ matrix.target }}
           enabled: ${{ inputs.use_cache }}
 
+      # WebUI images bundle the mkdocs User's Guide via post-build.sh.
+      - uses: ./.github/actions/setup-mkdocs
+
       - name: Configure & Build
         env:
           INFIX_RELEASE: ${{ steps.vars.outputs.ver }}

.github/workflows/build.yml

@@ -124,6 +124,9 @@ jobs:
         with:
           target: ${{ env.TARGET }}
 
+      # WebUI images bundle the mkdocs User's Guide via post-build.sh.
+      - uses: ./.github/actions/setup-mkdocs
+
       - name: Configure ${{ env.TARGET }}
         run: |
           make ${{ env.TARGET }}_defconfig