Skip to content

Print MiKTeX's own logs when a document fails - #33

Merged
Paebbels merged 1 commit into
devfrom
claude/capture-miktex-log
Sep 17, 2026
Merged

Paebbels merged 1 commit into
devfrom
claude/capture-miktex-log

Conversation

@pytooling-claude

Copy link
Copy Markdown

Changes

  • A failed document compilation prints MiKTeX's own logs. When lualatex aborts it writes no document.log at all and points at /latex/.miktex/texmfs/data/miktex/log/lualatex.log instead:

    Sorry, but lualatex did not succeed.
    The log file hopefully contains the information to get MiKTeX going again:
      /latex/.miktex/texmfs/data/miktex/log/lualatex.log
    

    The container was removed with that file, so the reason was never visible and every occurrence read as "MiKTeX instability". An if: failure() step in the Document and Sphinx check jobs now groups the user and admin logs into the job output.

Bug Fixes

  • The Specific job's outputs no longer carry literal quotes. Its tee "${GITHUB_OUTPUT}" <<EOF block wrote specific_image="<ns>/<name>:<tag>", and a heredoc does not strip quotes - so the quotes were part of the value and rendered in step names as Login and push '"pytooling/miktex:sphinx-dev"' to Docker Hub. It worked only because every use was interpolated into a shell command, which stripped them again; a container: image: reference or an API call would have got a name that does not resolve. The MiKTeX job's own block already wrote its values unquoted.

Related Issues and Pull-Requests

  • Follows Upgrade the base image to Debian 13 Trixie #32 (Debian 13 Trixie).
  • The abort this makes diagnosable has now been seen five times in two days, across dev, a release tag and the Trixie branch, always in a single font family while its siblings passed in the same run - so it is environmental rather than a defect in a document. The logs should say which resource was missing.

A lualatex abort writes no 'document.log', and names
'/latex/.miktex/texmfs/data/miktex/log/lualatex.log' as the file holding the
reason. The container is removed with it, so the cause was never visible.

Also drops the literal quotes from the 'Specific' job's outputs: a heredoc
writing '$GITHUB_OUTPUT' does not strip them, so the quotes were part of the
value and showed up in step names.

Co-Authored-By: Patrick Lehmann <Paebbels@gmail.com>
@pytooling-claude pytooling-claude Bot added CI Pipeline Related to the CI pipeline MiKTeX Relatex to the MiKTeX distribution. labels Sep 17, 2026
@Paebbels
Paebbels merged commit 6431802 into dev Sep 17, 2026
11 of 13 checks passed
@Paebbels
Paebbels deleted the claude/capture-miktex-log branch September 17, 2026 06:41
@pytooling-claude pytooling-claude Bot mentioned this pull request Sep 17, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CI Pipeline Related to the CI pipeline MiKTeX Relatex to the MiKTeX distribution.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants