Skip to content

Commit 09c759a

Browse files
vicperdanaCopilot
andauthored
fix: resolve mkdocs build errors from deprecated extensions (#410)
- 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>
1 parent 0fdce5d commit 09c759a

2 files changed

Lines changed: 7 additions & 8 deletions

File tree

mkdocs.yml

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,6 @@ site_author: Microsoft
66
repo_url: https://github.com/Azure/PSDocs.Azure/
77
edit_uri: blob/main/docs/
88

9-
repo_issue: https://github.com/Azure/PSDocs.Azure/issues
10-
repo_discussion: https://github.com/Azure/PSDocs.Azure/discussions
11-
129
extra_css:
1310
- assets/stylesheets/extra.css
1411

@@ -70,13 +67,14 @@ markdown_extensions:
7067
- pymdownx.highlight
7168
- pymdownx.superfences
7269
- pymdownx.pathconverter
73-
- pymdownx.tabbed
70+
- pymdownx.tabbed:
71+
alternate_style: true
7472
- pymdownx.details
7573
- mdx_truly_sane_lists
7674
- pymdownx.tasklist
7775
- pymdownx.emoji:
78-
emoji_index: !!python/name:materialx.emoji.twemoji
79-
emoji_generator: !!python/name:materialx.emoji.to_svg
76+
emoji_index: !!python/name:material.extensions.emoji.twemoji
77+
emoji_generator: !!python/name:material.extensions.emoji.to_svg
8078
- toc:
8179
permalink: '#'
8280
separator: '-'

requirements-docs.txt

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
mkdocs==1.6.1
2-
mkdocs-material==9.6.9
3-
pymdown-extensions==10.14.3
2+
mkdocs-material==9.7.6
3+
pymdown-extensions==10.21.2
4+
pygments==2.20.0
45
mike==2.1.3
56
mkdocs-simple-hooks==0.1.5
67
mkdocs-git-revision-date-plugin==0.3.2

0 commit comments

Comments
 (0)