starred/mkdocs-material
1
0
Fork 0
mirror of https://github.com/squidfunk/mkdocs-material.git synced 2026-03-31 06:33:51 -04:00
Code Issues Packages Projects Releases Wiki Activity

Updated MkDocs 2.0 warning message

Browse Source
This commit is contained in:
squidfunk
2026-03-03 20:46:49 +01:00
parent fdf40c096f
commit 4ae913c05f
2 changed files with 26 additions and 14 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
material/plugins/__init__.py
View File

@@ -26,13 +26,19 @@ from sys import stderr
if not getenv("NO_MKDOCS_2_WARNING"):
print(
"\n"
f"{Fore.RED} │ ⚠ WARNING – MkDocs 2.0 is incompatible with Material for MkDocs{Style.RESET_ALL}\n"
f"{Fore.RED} │ {Style.RESET_ALL}\n"
f"{Fore.RED} │ {Style.RESET_ALL} MkDocs 1.x is unmaintained. We recommend switching to Zensical, our\n"
f"{Fore.RED} │ {Style.RESET_ALL} new static site generator, as soon as possible. We're providing an\n"
f"{Fore.RED} │ {Style.RESET_ALL} analysis of the situation in this article:\n"
f"{Fore.RED} │ {Style.RESET_ALL} \n"
f"{Fore.RED} │ {Style.RESET_ALL} \033[4mhttps://squidfunk.github.io/mkdocs-material/blog/2026/02/18/mkdocs-2.0/{Style.RESET_ALL}\n"
f"{Fore.RED} │ ⚠ WARNING – MkDocs 2.0 is incompatible with Material for MkDocs{Style.RESET_ALL}\n"
f"{Fore.RED} │{Style.RESET_ALL}\n"
f"{Fore.RED} │{Style.RESET_ALL} MkDocs 2.0 introduces backward-incompatible changes:\n"
f"{Fore.RED} │{Style.RESET_ALL}\n"
f"{Fore.RED} │ × {Style.RESET_ALL}All plugins will stop working – the plugin system has been removed\n"
f"{Fore.RED} │ × {Style.RESET_ALL}All theme overrides will break – the theming system has been rewritten\n"
f"{Fore.RED} │ × {Style.RESET_ALL}No migration path exists – existing projects cannot be upgraded\n"
f"{Fore.RED} │ × {Style.RESET_ALL}Closed contribution model – community members can't report bugs\n"
f"{Fore.RED} │ × {Style.RESET_ALL}Currently unlicensed – unsuitable for production use\n"
f"{Fore.RED} │{Style.RESET_ALL}\n"
f"{Fore.RED} │{Style.RESET_ALL} Our full analysis:\n"
f"{Fore.RED} │{Style.RESET_ALL}\n"
f"{Fore.RED} │{Style.RESET_ALL} \033[4mhttps://squidfunk.github.io/mkdocs-material/blog/2026/02/18/mkdocs-2.0/{Style.RESET_ALL}\n"
f"{Style.RESET_ALL}",
file=stderr
)

20
src/plugins/__init__.py
View File

@@ -26,13 +26,19 @@ from sys import stderr
if not getenv("NO_MKDOCS_2_WARNING"):
print(
"\n"
f"{Fore.RED} │ ⚠ WARNING – MkDocs 2.0 is incompatible with Material for MkDocs{Style.RESET_ALL}\n"
f"{Fore.RED} │ {Style.RESET_ALL}\n"
f"{Fore.RED} │ {Style.RESET_ALL} MkDocs 1.x is unmaintained. We recommend switching to Zensical, our\n"
f"{Fore.RED} │ {Style.RESET_ALL} new static site generator, as soon as possible. We're providing an\n"
f"{Fore.RED} │ {Style.RESET_ALL} analysis of the situation in this article:\n"
f"{Fore.RED} │ {Style.RESET_ALL} \n"
f"{Fore.RED} │ {Style.RESET_ALL} \033[4mhttps://squidfunk.github.io/mkdocs-material/blog/2026/02/18/mkdocs-2.0/{Style.RESET_ALL}\n"
f"{Fore.RED} │ ⚠ WARNING – MkDocs 2.0 is incompatible with Material for MkDocs{Style.RESET_ALL}\n"
f"{Fore.RED} │{Style.RESET_ALL}\n"
f"{Fore.RED} │{Style.RESET_ALL} MkDocs 2.0 introduces backward-incompatible changes:\n"
f"{Fore.RED} │{Style.RESET_ALL}\n"
f"{Fore.RED} │ × {Style.RESET_ALL}All plugins will stop working – the plugin system has been removed\n"
f"{Fore.RED} │ × {Style.RESET_ALL}All theme overrides will break – the theming system has been rewritten\n"
f"{Fore.RED} │ × {Style.RESET_ALL}No migration path exists – existing projects cannot be upgraded\n"
f"{Fore.RED} │ × {Style.RESET_ALL}Closed contribution model – community members can't report bugs\n"
f"{Fore.RED} │ × {Style.RESET_ALL}Currently unlicensed – unsuitable for production use\n"
f"{Fore.RED} │{Style.RESET_ALL}\n"
f"{Fore.RED} │{Style.RESET_ALL} Our full analysis:\n"
f"{Fore.RED} │{Style.RESET_ALL}\n"
f"{Fore.RED} │{Style.RESET_ALL} \033[4mhttps://squidfunk.github.io/mkdocs-material/blog/2026/02/18/mkdocs-2.0/{Style.RESET_ALL}\n"
f"{Style.RESET_ALL}",
file=stderr
)