feat: add an option to select texlive version directly

Author: zydou

.dockerignore

@@ -7,18 +7,24 @@ on:
   workflow_dispatch:
 jobs:
   test:
+    strategy:
+      fail-fast: false
+      matrix:
+        texlive_version: [2020, 2021, 2022, latest]
     runs-on: ubuntu-latest
     steps:
       - name: Set up Git repository
         uses: actions/checkout@v3
       - name: Compile basic LaTeX document
         uses: ./
         with:
+          texlive_version: ${{ matrix.texlive_version }}
           root_file: test.tex
           working_directory: test/
       - name: Compile LaTeX document with pre/post compile actions
         uses: ./
         with:
+          texlive_version: ${{ matrix.texlive_version }}
           root_file: test.tex
           working_directory: test/
           pre_compile: |
@@ -28,55 +34,64 @@ jobs:
       - name: Compile multiple LaTeX documents
         uses: ./
         with:
+          texlive_version: ${{ matrix.texlive_version }}
           root_file: |
             file1.tex
             file2.tex
           working_directory: test/
       - name: Compile multiple LaTeX documents using glob
         uses: ./
         with:
+          texlive_version: ${{ matrix.texlive_version }}
           root_file: "glob_test*.tex"
           glob_root_file: true
           working_directory: test/
       - name: Compile multiple LaTeX documents in different directories
         uses: ./
         with:
+          texlive_version: ${{ matrix.texlive_version }}
           root_file: "subdir*/main.tex"
           glob_root_file: true
           working_directory: test/
           work_in_root_file_dir: true
       - name: Compile multiple LaTeX documents in different directories using extended glob
         uses: ./
         with:
+          texlive_version: ${{ matrix.texlive_version }}
           root_file: "extglob/!(subdir3)_glob/*.tex"
           glob_root_file: true
           working_directory: test/
           work_in_root_file_dir: true
       - name: Compile multiple LaTeX documents in different directories using glob star
         uses: ./
         with:
+          texlive_version: ${{ matrix.texlive_version }}
           root_file: "globstar/**/*.tex"
           glob_root_file: true
           working_directory: test/
           work_in_root_file_dir: true
       - name: Compile LaTeX document with math symbols
         uses: ./
         with:
+          texlive_version: ${{ matrix.texlive_version }}
           root_file: math.tex
           working_directory: test/
       - name: Compile LaTeX document with biblatex/biber
         uses: ./
         with:
+          texlive_version: ${{ matrix.texlive_version }}
           root_file: biblatex.tex
           working_directory: test/
       - name: Compile LaTeX document with eps figure
         uses: ./
         with:
+          texlive_version: ${{ matrix.texlive_version }}
           root_file: eps.tex
           working_directory: test/
       - name: Compile LaTeX document with minted and lualatex
         uses: ./
         with:
+          texlive_version: ${{ matrix.texlive_version }}
           root_file: minted.tex
           working_directory: test/
           latexmk_shell_escape: true
@@ -87,20 +102,23 @@ jobs:
       - name: Compile LaTeX document with extra_fonts
         uses: ./
         with:
+          texlive_version: ${{ matrix.texlive_version }}
           root_file: extra_fonts.tex
           working_directory: test/
           latexmk_use_xelatex: true
           extra_fonts: "./../DoulosSIL-Regular.ttf"
       - name: Compile LaTeX document with arara and graphviz
         uses: ./
         with:
+          texlive_version: ${{ matrix.texlive_version }}
           root_file: graphviz.tex
           working_directory: test/
           compiler: arara
           args: "--verbose"
       - name: Compile LaTeX document with continue_on_error
         uses: ./
         with:
+          texlive_version: ${{ matrix.texlive_version }}
           root_file: |
             error.tex
             not_error.tex

.github/workflows/test.yml

@@ -35,25 +35,54 @@ inputs:
     description: Instruct latexmk to use LuaLaTeX
   latexmk_use_xelatex:
     description: Instruct latexmk to use XeLaTeX
+  texlive_version:
+    description: The version of TeX Live to be used
+    default: latest
+
 runs:
-  using: docker
-  image: Dockerfile
-  args:
-    - ${{ inputs.root_file }}
-    - ${{ inputs.glob_root_file }}
-    - ${{ inputs.working_directory }}
-    - ${{ inputs.work_in_root_file_dir }}
-    - ${{ inputs.continue_on_error }}
-    - ${{ inputs.compiler }}
-    - ${{ inputs.args }}
-    - ${{ inputs.extra_packages }}
-    - ${{ inputs.extra_system_packages }}
-    - ${{ inputs.extra_fonts }}
-    - ${{ inputs.pre_compile }}
-    - ${{ inputs.post_compile }}
-    - ${{ inputs.latexmk_shell_escape }}
-    - ${{ inputs.latexmk_use_lualatex }}
-    - ${{ inputs.latexmk_use_xelatex }}
+  using: composite
+  steps:
+    - shell: bash
+      name: Choose pinned texlive docker tag
+      run: |
+        if [[ "${{ inputs.texlive_version }}" == "2020" ]]; then
+        echo "texlive_version=20210301" >> "${GITHUB_ENV}"
+        elif [[ "${{ inputs.texlive_version }}" == "2021" ]]; then
+        echo "texlive_version=20220201" >> "${GITHUB_ENV}"
+        elif [[ "${{ inputs.texlive_version }}" == "2022" ]]; then
+        echo "texlive_version=20230301" >> "${GITHUB_ENV}"
+        elif [[ "${{ inputs.texlive_version }}" == "latest" ]]; then
+        echo "texlive_version=latest" >> "${GITHUB_ENV}"
+        else
+        echo "TeX Live version ${{ inputs.texlive_version }} is not supported."
+        echo "The currently supported versions are 2020, 2021, 2022, and latest."
+        exit 1
+        fi
+    - shell: bash
+      run: >
+        docker run --rm
+        -v "${PWD}":/github/workspace
+        -v "${GITHUB_ACTION_PATH}/entrypoint.sh":/entrypoint.sh
+        -w /github/workspace
+        --entrypoint "/entrypoint.sh"
+        ghcr.io/xu-cheng/texlive-full:${{ env.texlive_version }}
+        "${{ inputs.root_file }}"
+        "${{ inputs.glob_root_file }}"
+        "${{ inputs.working_directory }}"
+        "${{ inputs.work_in_root_file_dir }}"
+        "${{ inputs.continue_on_error }}"
+        "${{ inputs.compiler }}"
+        "${{ inputs.args }}"
+        "${{ inputs.extra_packages }}"
+        "${{ inputs.extra_system_packages }}"
+        "${{ inputs.extra_fonts }}"
+        "${{ inputs.pre_compile }}"
+        "${{ inputs.post_compile }}"
+        "${{ inputs.latexmk_shell_escape }}"
+        "${{ inputs.latexmk_use_lualatex }}"
+        "${{ inputs.latexmk_use_xelatex }}"
+        "${{ env.texinputs }}"
+
 branding:
   icon: book
   color: blue

Dockerfile

@@ -31,13 +31,19 @@ post_compile="${12}"
 latexmk_shell_escape="${13}"
 latexmk_use_lualatex="${14}"
 latexmk_use_xelatex="${15}"
+env_texinputs="${16}"
 
 # install git on old images
 if ! command -v git &>/dev/null; then
   apk --no-cache add git
 fi
 git config --system --add safe.directory /github/workspace
 
+# setup user-defined environment variables
+if [[ -n "$env_texinputs" ]]; then
+  export TEXINPUTS="$env_texinputs"
+fi
+
 if [[ -z "$root_file" ]]; then
   error "Input 'root_file' is missing."
 fi