[latex3-commits] [git/LaTeX3-latex3-latex2e] split-docs: Experiment with splitting the base docs in GH Actions (5bf01620)

[Marcel Fabian Krüger]

Repository : https://github.com/latex3/latex2e
On branch  : split-docs
Link       : https://github.com/latex3/latex2e/commit/5bf0162032ac69c7535968bcdc4fa59b43968f5b

>---------------------------------------------------------------

commit 5bf0162032ac69c7535968bcdc4fa59b43968f5b
Author: Marcel Fabian Krüger <tex at 2krueger.de>
Date:   Mon Mar 13 21:54:38 2023 +0100

    Experiment with splitting the base docs in GH Actions


>---------------------------------------------------------------

5bf0162032ac69c7535968bcdc4fa59b43968f5b
 .github/workflows/main.yaml | 13 ++++++++++---
 base/build.lua              | 14 +++++++++++++-
 2 files changed, 23 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/main.yaml b/.github/workflows/main.yaml
index 82ad7fdb..1539f971 100644
--- a/.github/workflows/main.yaml
+++ b/.github/workflows/main.yaml
@@ -123,9 +123,14 @@ jobs:
     runs-on: ubuntu-20.04
     strategy:
       matrix:
-        module:
-          - base
-          - required
+        include:
+          - module: base
+            environment: LTX_DOC_COMPONENT=1
+          - module: base
+            environment: LTX_DOC_COMPONENT=2
+          - module: base
+            environment: LTX_DOC_COMPONENT=3
+          - module: required
     name: "Documentation: ${{ matrix.module }}"
     needs: texlive-cache
     steps:
@@ -141,6 +146,8 @@ jobs:
           key: ${{ needs.texlive-cache.outputs.cache_key }}
           fail-on-cache-miss: true
       - run: echo $HOME/texlive/bin/x86_64-linux >> $GITHUB_PATH
+      - if: ${{ matrix.environment }}
+        run: echo "${{ matrix.environment }}" >> $GITHUB_ENV
       - name: Run l3build
         working-directory: ${{ matrix.module }}
         run: l3build doc -q -H --show-log-on-error
diff --git a/base/build.lua b/base/build.lua
index ed4cf514..26161631 100644
--- a/base/build.lua
+++ b/base/build.lua
@@ -68,9 +68,10 @@ textfiles =
     "lppl-1-1.txt",
     "lppl-1-2.txt",
   }
-typesetfiles   =
+typesetfiles_list = {
   {
     "source2e.tex", -- Has to be first: source2e.ist creation!
+  }, {
     "alltt.dtx",
     "classes.dtx",
     "cmfonts.dtx",
@@ -102,6 +103,7 @@ typesetfiles   =
     "cyrguide.tex",
     "encguide.tex",
     "fntguide.tex",
+  }, {
     "ltnews.tex",
     "ltnews??.tex",
     "ltx3info.tex",
@@ -112,6 +114,16 @@ typesetfiles   =
     "*-doc.tex",
     "*-code.tex",
   }
+}
+local doc_component_setting = os.getenv'LTX_DOC_COMPONENT'
+if doc_component_setting then
+  typesetfiles = typesetfiles_list[math.tointeger(doc_component_setting)]
+else
+  typesetfiles = {}
+  for _, files in ipairs(typesetfiles_list) do
+    table.move(files, 1, #files, #typesetfiles + 1, typesetfiles)
+  end
+end
 
 -- Files that should be removed after running a test
 dynamicfiles = {"*.tst"}