Broken docs

[woile]

Description

The docs now look like AI slop:

• confusing, I cannot find the settings
• wrong formatting
• wrong titles on the sidebar

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 bump page:

Desired behavior

Make it user friendly

Screenshots

No response

Environment

website

[ttw225]

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).

[woile]

Thanks, I'll try this out