Repository navigation
Broken docs #1922
Description
Activity
Root cause: pygments==2.20.0 regressed HtmlFormatter so that when filename is None, it calls html.escape() on None and crashes with AttributeError: 'NoneType' object has no attribute 'replace'.
In our MkDocs stack, pymdownx.highlight ends up passing filename=None in the common case (no fence title), so the highlight step fails; pymdownx.superfences then doesn’t replace the fence, and the remaining text is parsed as normal Markdown — which is why ```bash and lines starting with # show up as plain text / headings.
Upstream:
- Issue: mkdocs build fails in HtmlFormatter with 'NoneType' object has no attribute 'replace' pygments/pygments#3076
- Fix (merged): Fix #3076 - Handle None object before HTML escaping pygments/pygments#3078 (targeted for Pygments 2.20.1)
Possible mitigation until a Pygments release with the fix is available: pin pygments<2.20 for the docs build (similar approach: jj-vcs/jj#9233).
Reacted by Wei Lee and Tim HsiungThanks, I'll try this out
Reacted by Peter and Wei Lee
Description
The docs now look like AI slop:
Steps to reproduce
Navigate to this for example:
https://commitizen-tools.github.io/commitizen/config/version_provider/
Current behavior
Missing headers:
Wrong markdown usage:
version_provider is nowhere to be found in
bump, it's isolated under:https://commitizen-tools.github.io/commitizen/config/version_provider/
users cannto discover it
All the titles in
bumppage:Desired behavior
Make it user friendly
Screenshots
No response
Environment
website