Skip to content

Bump fileCacheEntryVersion in transform.ToMathΒ #15267

Closed

Description

@jmooring

In ec52e63 we bumped KaTeX from 0.16.21 to 0.18.4. This produces different output.

I ran into this when testing the docs site, specifically the chem example.

Activity

  1. added this to the v0.166.0 milestone on Sep 1, 2026
  2. jmooring commented on Sep 1, 2026

    @jmooring
    MemberAuthor

    For the release notes...

    When upgrading to Hugo v0.166.0, sites using transform.ToMath with the output option set to html or htmlAndMathml must update the KaTeX stylesheet referenced in their template(s) to version 0.18.4 or higher. Using older CSS versions like 0.16.21 will cause certain mathematical or chemical expressions to render incorrectly.

    Example update:

    - <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.16.21/dist/katex.min.css">
    + <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.18.4/dist/katex.min.css">

    See these examples:

  3. jmooring commented on Sep 1, 2026

    @jmooring
    MemberAuthor

    And note to future self about documentation:

    Do not ever update the KaTeX CSS version references in transform.ToMath examples unless we change the underlying engine.

    EDIT: Added a section to the documentation contribution guide describing this requirement.

  4. self-assigned this
    on Sep 1, 2026
  5. added a commit that references this issue on Sep 1, 2026
    8d88b8b
  6. github-actions commented on Sep 23, 2026

    @github-actions

    This issue has been automatically locked since there has not been any recent activity after it was closed. Please open a new issue for related bugs.

  7. locked as resolved and limited conversation to collaborators on Sep 23, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Type

No type

Projects

No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions