This repository is based on Debian 12.x Bookworm (slim) with Python 3.14.

Docker Hub: https://hub.docker.com/r/pytooling/miktex

• MikTeX original containers do not provide installations based on Debian.
• MikTeX original containers are infrequently updated (>1 year).
• MikTeX original containers aren't smaller (less download time).
• Prepare MiKTeX with Unicode support (pyTooling.sty).
• pyTooling has control over preinstalled commonly used LaTeX packages (amsfonts/amsmath, babel, hyperref, longtables, ...)
• pyTooling can derive specific images for e.g.Doxygen, Pandoc, Sphinx, ...

docker image run --rm -it -v $(pwd):/latex pytooling/miktex:latest

  MiKTeX:
    name: 📓 Translate to PDF
    runs-on: 'ubuntu-24.04'
    container:
      image: pytooling/miktex:latest
    steps:
      - name: ⏬ Checkout repository
        uses: actions/checkout@v6

      - name: 📓 Compile 'latex/document.tex'
        run: |
          set -o pipefail
          
          cd ./latex
          chown -R latex:latex .
          sudo -u latex latexmk \
            --lualatex \
            --interaction=nonstopmode \
            --file-line-error \
            --halt-on-error \
            document.tex | filter.latexmk.sh
          
          ls -lAh *.pdf

      - name: 📤 Upload 'document-pdf' artifact
        uses: pyTooling/upload-artifact@v7
        with:
          name: document-pdf
          working-directory: latex
          path: document.pdf
          if-no-files-found: error
          retention-days: 1

Installed additional tools are:

• curl
• MikTeX
  • Preinstalled packages: Common.list
• Perl
• Python 3.14
• sudo
• tree

• Cabin
• DejaVu
• Latin Modern (LM)
• Libertinus (optimized Linux Libertine for LuaLaTeX)
• URW Type Foundy
  • URW Bookman (ITC Bookman clone)
  • Nimbus Sans (Helvetica clone)
  • Nimbus Roman (Times New Roman clone)
  • Palladio -> Palatino
• Noto (No Tofu)

planned, see #12

planned, see #11

MiKTeX:

• Common package list: Common.list
• Sphinx specific package list: Sphinx.list

Additional Debian Packages: Sphinx.packages

• nodejs: Sphinx.npm
  • Mermaid

This Docker Image build receipt and all it's accompanying configuration and script files (source code) are licensed under The MIT License if not mentioned otherwise within the respective file.

SPDX-License-Identifier: MIT