Skip to content

fix: resolve mkdocs build errors from deprecated extensions#410

Merged
vicperdana merged 1 commit into
mainfrom
fix/mkdocs-deprecations
Apr 22, 2026
Merged

fix: resolve mkdocs build errors from deprecated extensions#410
vicperdana merged 1 commit into
mainfrom
fix/mkdocs-deprecations

Conversation

@vicperdana
Copy link
Copy Markdown
Contributor

The Docs workflow is crashing on creating-your-pipeline.md with:

AttributeError: 'NoneType' object has no attribute 'replace'

Plus multiple deprecation warnings about materialx.emoji.

Fixes

Issue Fix
materialx.emoji.twemoji deprecated material.extensions.emoji.twemoji
pymdownx.tabbed crash (NoneType in highlight formatter) Add alternate_style: true (required in pymdownx 10.x)
pygments 2.20.0 breaking change Pin pygments>=2.19,<2.20 in requirements
repo_issue/repo_discussion warnings Remove unrecognised config keys

Verified

mkdocs build succeeds locally with pinned dependencies (clean venv, zero errors).

@vicperdana vicperdana requested a review from a team as a code owner April 21, 2026 04:42
@vicperdana vicperdana requested a review from BernieWhite April 21, 2026 05:00
Comment thread requirements-docs.txt Outdated
- Update emoji extension from materialx.emoji to material.extensions.emoji
  (materialx is deprecated since mkdocs-material 9.4)
- Add alternate_style: true to pymdownx.tabbed (required in pymdownx 10.x)
- Pin pygments<2.20 to avoid NoneType crash in highlight formatter
- Remove unrecognised repo_issue/repo_discussion config keys

Verified: mkdocs build succeeds locally with pinned dependencies.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@vicperdana vicperdana force-pushed the fix/mkdocs-deprecations branch from 1639ca7 to 419b3af Compare April 22, 2026 03:17
@vicperdana vicperdana merged commit 09c759a into main Apr 22, 2026
6 checks passed
@vicperdana vicperdana deleted the fix/mkdocs-deprecations branch April 22, 2026 03:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants