move all build steps from CI to Makefile and i18n.sh

Signed-off-by: Daniel Maslowski <info@orangecms.org>

Author: orangecms

.github/workflows/gh-pages.yml

@@ -6,10 +6,6 @@ on:
       - main
   pull_request:
 
-env:
-  # Update the language picker in theme/js/language-picker.js to link new languages.
-  LANGUAGES: zh-TW
-
 jobs:
   deploy:
     runs-on: ubuntu-24.04
@@ -38,22 +34,7 @@ jobs:
         run: make prepare_i18n
 
       - name: Build
-        # linkcheck causes ouput files to end up in html/, so move them to root
-        run: |
-          mdbook build
-          mv book/html/* book/
-
-      - name: Build all translations
-        run: |
-          for po_lang in ${{ env.LANGUAGES }}; do
-            echo "::group::Building $po_lang translation"
-            MDBOOK_BOOK__LANGUAGE=$po_lang \
-            MDBOOK_OUTPUT__HTML__SITE_URL=/linuxboot-book/$po_lang/ \
-            mdbook build -d book/$po_lang
-            rsync -a book/$po_lang/html/ book/$po_lang/
-            rm -r book/$po_lang/html/
-            echo "::endgroup::"
-          done
+        run: make build
 
       - name: Deploy
         uses: peaceiris/actions-gh-pages@v3

Makefile

@@ -1,4 +1,11 @@
-build:
+build: book i18n
+	# linkcheck causes output files to end up in html/, so move them to root
+	mv book/html/* book/
+
+i18n:
+	bash i18n.sh
+
+book:
 	mdbook build
 
 run:

README.md

@@ -38,6 +38,16 @@ From the root directory of the repository run `mdl /src/example.md` and `vale
 src/example.md`. Add words that trigger false positive spelling errors to
 `ci/vale/styles/config/vocabularies/LinuxBoot/accept.txt`.
 
+## I18n
+
+Translations are in [`po/`](po/). They are built with [`i18n.sh`](i18n.sh).
+Until there is a native mdBook plugin, see the [`Makefile`](Makefile) for how
+the translations are integrated.
+
+Note that `make run` / `mdbook serve` do not integrate the translations at this
+point. The `make build` target will build everything into `book/`, which you
+can then statically serve.
+
 ## Acknowledgments
 
 In alphabetical order:

i18n.sh

@@ -0,0 +1,14 @@
+#!/bin/sh
+
+# Update the language picker in theme/js/language-picker.js to add new languages.
+LANGUAGES=zh-TW
+
+for po_lang in ${LANGUAGES}; do
+  echo "::group::Building $po_lang translation"
+  MDBOOK_BOOK__LANGUAGE=$po_lang \
+  MDBOOK_OUTPUT__HTML__SITE_URL=/linuxboot-book/$po_lang/ \
+  mdbook build -d book/$po_lang
+  # NOTE: This is crucial. Put the files in the right place.
+  rsync -a book/$po_lang/html/ book/$po_lang/
+  echo "::endgroup::"
+done