From 529a05f363bc9c6e5edc4d007d49a3a0b578639f Mon Sep 17 00:00:00 2001 From: Xianpeng Shen Date: Sat, 14 Nov 2026 19:49:15 +0000 Subject: [PATCH 1/2] Add an "Is MkDocs still maintained?" page and retitle the comparison People who wonder whether MkDocs is dead, or what to use instead, search for exactly that. Answer it on one page: the state of MkDocs 1.x and 2.0, whether a site stops building, Material's end of life, the alternatives and what MkDocs NG promises, each with dated, sourced facts. Retitle the comparison page "MkDocs Alternatives Compared" (nav: "MkDocs Alternatives"), update its latest-release row, and link both pages from the home page. --- docs/about/comparison.md | 24 ++-- docs/index.md | 4 +- docs/user-guide/README.md | 5 + docs/user-guide/is-mkdocs-still-maintained.md | 114 ++++++++++++++++++ docs/user-guide/material-end-of-life.md | 6 +- mkdocs.yml | 4 +- 6 files changed, 144 insertions(+), 13 deletions(-) create mode 100644 docs/user-guide/is-mkdocs-still-maintained.md diff --git a/docs/about/comparison.md b/docs/about/comparison.md index 69c7902b..cc2dab4f 100644 --- a/docs/about/comparison.md +++ b/docs/about/comparison.md @@ -1,16 +1,22 @@ -# MkDocs NG and Its Alternatives +--- +description: "MkDocs NG, ProperDocs, Zensical, MkDocs 1.6 and MkDocs 2.0 compared: which ones run your plugins and themes, how fast they build, and which one to use." +--- + +# MkDocs Alternatives Compared -How MkDocs NG relates to the other tools that build MkDocs sites. +MkDocs NG, ProperDocs, Zensical and upstream MkDocs, side by side. --- -Since upstream MkDocs 1.x stopped being developed, several projects have -offered a way forward for existing MkDocs sites. This page compares them on -what matters when you already have a site: whether it keeps building -unchanged, and whether your plugins keep running. +Since upstream MkDocs 1.x stopped being developed (see +[Is MkDocs Still Maintained?](../user-guide/is-mkdocs-still-maintained.md)), +several projects have offered a way forward for existing MkDocs sites. This +page compares them on what matters when you already have a site: whether it +keeps building unchanged, and whether your plugins keep running. -Facts on this page were checked on 2026-11-01 against each project's PyPI -release history, documentation and source code; see [Sources](#sources). +Facts on this page were checked on 2026-11-01, and release versions on +2026-11-14, against each project's PyPI release history, documentation and +source code; see [Sources](#sources). Build times were measured on 2026-11-04. Projects change quickly, so check their documentation for the current state. If something here is wrong or out of date, please @@ -21,7 +27,7 @@ If something here is wrong or out of date, please   | MkDocs NG | MkDocs 1.6 | MkDocs 2.0 pre-releases | ProperDocs | Zensical --- | --- | --- | --- | --- | --- What it is | Maintained fork of MkDocs 1.x | Last upstream 1.x release | Upstream rewrite | Fork of MkDocs 1.6 | New generator by the Material for MkDocs team -Latest release | 1.11.0 (2026-11-04) | 1.6.1 (2024-08-30) | 2.0.dev6 (2026-09-15) | 1.6.7 (2026-03-20) | 0.0.74 (2026-10-30) +Latest release | 1.11.2 (2026-11-11) | 1.6.1 (2024-08-30) | 2.0.dev6 (2026-09-15) | 1.6.7 (2026-03-20) | 0.1.1 (2026-11-10) PyPI package | `mkdocs-ng` | `mkdocs` | `mkdocs` (`--pre`) | `properdocs` | `zensical` Command | `mkdocs` | `mkdocs` | `mkdocs` | `properdocs` | `zensical` Configuration | `mkdocs.yml` | `mkdocs.yml` | None; refuses to run when `mkdocs.yml` exists | `properdocs.yml`, falls back to `mkdocs.yml` | `mkdocs.yml` or `zensical.toml` diff --git a/docs/index.md b/docs/index.md index 205fd0c7..4d40e250 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1,7 +1,7 @@ --- template: landing.html title: MkDocs NG -description: Write Markdown. Ship docs. The maintained MkDocs that keeps your plugins working. +description: "Write Markdown. Ship docs. MkDocs NG is the maintained fork of MkDocs 1.x: same mkdocs command, same mkdocs.yml, and your plugins and themes keep working." hero: eyebrow: "MkDocs NG" title: "Write Markdown.
*Ship docs.*" @@ -77,7 +77,7 @@ sections: reverse: true eyebrow: Already on MkDocs? title: Switching is a package change. - text: "MkDocs NG keeps the `mkdocs` command, imports and configuration. Your plugins and themes keep working, and bugs that stayed open upstream are fixed. See [how it compares](about/comparison/) to the alternatives." + text: "MkDocs NG keeps the `mkdocs` command, imports and configuration. Your plugins and themes keep working, and bugs that stayed open upstream are fixed. Wondering [whether MkDocs is still maintained](user-guide/is-mkdocs-still-maintained/)? See [how MkDocs NG compares](about/comparison/) to the alternatives." actions: - {text: Switching to MkDocs NG, link: user-guide/migrating/, primary: true} - {text: Fixed upstream issues, link: about/fixed-upstream-issues/} diff --git a/docs/user-guide/README.md b/docs/user-guide/README.md index c2250492..be12f998 100644 --- a/docs/user-guide/README.md +++ b/docs/user-guide/README.md @@ -1,3 +1,7 @@ +--- +description: "The MkDocs NG user guide: installing, writing, theming, configuring and deploying your documentation." +--- + # User Guide Building Documentation with MkDocs @@ -10,6 +14,7 @@ page listed below, or use the *next* and *previous* buttons in the navigation bar at the top of the page to move through the documentation in order. - [Installation](installation.md) +- [Is MkDocs Still Maintained?](is-mkdocs-still-maintained.md) - [Switching to MkDocs NG](migrating.md) - [Material for MkDocs End of Life](material-end-of-life.md) - [Writing Your Docs](writing-your-docs.md) diff --git a/docs/user-guide/is-mkdocs-still-maintained.md b/docs/user-guide/is-mkdocs-still-maintained.md new file mode 100644 index 00000000..8c3c6c57 --- /dev/null +++ b/docs/user-guide/is-mkdocs-still-maintained.md @@ -0,0 +1,114 @@ +--- +description: "Upstream MkDocs 1.x has had no release since August 2024, and MkDocs 2.0 is an incompatible rewrite. What that means for your site, and the maintained ways to keep it building." +--- + +# Is MkDocs Still Maintained? + +The state of MkDocs today, and what it means for your site. + +--- + +Short answer: **upstream MkDocs 1.x is no longer developed.** Its last release +is 1.6.1, from 2024-08-30. Upstream work moved to MkDocs 2.0, a rewrite that +can't build existing sites. Your site keeps building on 1.6.1 for now, and +[MkDocs NG](#what-is-mkdocs-ng) continues 1.x with the same `mkdocs` command, +`mkdocs.yml`, plugins and themes. + +Facts on this page were checked on 2026-11-14 against the PyPI release history +and documentation of each project; see [Sources](#sources). If something here +is wrong or out of date, please [open an issue]. + +## What is the state of MkDocs 1.x? + +There has been no release of MkDocs 1.x since 1.6.1 on 2024-08-30. +`pip install mkdocs` still installs it, and sites, plugins and themes built +for it keep working. Bugs reported since then stay unfixed, and 1.6.1 declares +support for Python 3.8 to 3.12 only. Many of the bugs that stayed open +upstream are listed, with their fixes, in +[Fixed Upstream Issues](../about/fixed-upstream-issues.md). + +## What is MkDocs 2.0? + +MkDocs 2.0 is a rewrite, published as pre-releases of the `mkdocs` package +since 2026-08-28; the latest is 2.0.dev6, from 2026-09-15. It has no +configuration file, plugins or themes: it builds a folder of Markdown files +with one Jinja template, and stops with an error when it finds a +`mkdocs.yml`. Existing sites can't be built with it. + +Because these are pre-releases, `pip install mkdocs` doesn't install them. +`pip install --pre mkdocs` and `uv --prerelease allow` do, so avoid those in +the environment you build your site in. + +## Will my site stop building? + +Not today. With `mkdocs` pinned below 2.0, for example `mkdocs<2`, your site +keeps building as it does now. What it doesn't get on 1.6.1 is fixes: for +bugs, for new Python versions, and for new versions of Python-Markdown, Jinja +and the other libraries it uses. The longer a site stays on 1.6.1, the more +likely one of those breaks it. + +## Is Material for MkDocs still maintained? + +Material for MkDocs is in maintenance mode, with critical fixes and security +updates until its end of life on 2027-05-05. Its team now develops Zensical. +[Material for MkDocs End of Life](material-end-of-life.md) lists your options, +including MkDocs NG Material, which keeps the `material` theme maintained +after that date. + +## What are the alternatives to MkDocs? + +For an existing MkDocs site, these are the ways forward: + +Project | What it is | Runs MkDocs plugins | Latest release +--- | --- | --- | --- +[MkDocs NG](#what-is-mkdocs-ng) | Maintained fork of MkDocs 1.x, same `mkdocs` command | Yes | 1.11.2 (2026-11-11) +[ProperDocs] | Fork of MkDocs 1.6, with its own `properdocs` command | Yes | 1.6.7 (2026-03-20) +[Zensical] | New generator from the team behind Material for MkDocs | No; reimplements about 30 popular plugins | 0.1.1 (2026-11-10) +MkDocs 1.6.1 | The last upstream 1.x release | Yes | 1.6.1 (2024-08-30) + +[MkDocs Alternatives Compared](../about/comparison.md) compares them in detail, +with build times, and says which one suits which site. + +## What is MkDocs NG? + +MkDocs NG is a maintained fork of MkDocs 1.x, published on PyPI as +`mkdocs-ng`. It keeps the `mkdocs` command, `mkdocs.yml`, `import mkdocs` and +the plugin and theme APIs, so switching is a package change: + +```bash +pip install mkdocs-ng +``` + +* **Your plugins keep working.** Every change is tested by building sites + with around 30 popular plugins, themes and Markdown extensions. +* **Regular releases.** Nine releases since April 2026, the latest on + 2026-11-11; see the [release notes](../about/release-notes.md). +* **A dated support promise.** MkDocs NG 1.x gets bug, security and + compatibility fixes until at least 2028-12-31; see + [Versioning and support](../about/release-notes.md#versioning-and-support). +* **Current Python.** It supports Python 3.10 to 3.15. +* **Open governance.** Who maintains it, how decisions are made and what + happens if a maintainer steps away is written down in + [Governance](../about/governance.md). + +To try it on your site before you change anything, see +[Switching to MkDocs NG](migrating.md#try-it-first). Switching back is the +same one-line change. + +## Sources + +* PyPI release history: + [mkdocs](https://pypi.org/project/mkdocs/#history), + [mkdocs-ng](https://pypi.org/project/mkdocs-ng/#history), + [properdocs](https://pypi.org/project/properdocs/#history), + [zensical](https://pypi.org/project/zensical/#history). +* MkDocs 2.0: the [package description](https://pypi.org/project/mkdocs/2.0.dev6/) + and the source code of 2.0.dev6. +* Material for MkDocs maintenance: + [upcoming changes](https://zensical.org/upcoming-changes/#material-for-mkdocs). +* Zensical: + [MkDocs plugin support](https://zensical.org/docs/compatibility/mkdocs/plugins/). + +[open an issue]: https://github.com/mkdocs-ng/mkdocs/issues +[ProperDocs]: https://properdocs.org/ +[Zensical]: https://zensical.org/ diff --git a/docs/user-guide/material-end-of-life.md b/docs/user-guide/material-end-of-life.md index 1c226467..151d40bd 100644 --- a/docs/user-guide/material-end-of-life.md +++ b/docs/user-guide/material-end-of-life.md @@ -1,3 +1,7 @@ +--- +description: "Material for MkDocs reaches end of life on 2027-05-05. Your options: MkDocs NG Material, Zensical, MaterialX or Sumi, and who each one suits." +--- + # Material for MkDocs End of Life Your options when Material for MkDocs stops being maintained. @@ -127,7 +131,7 @@ Your site needs no changes. dependencies). * MkDocs NG Material: [documentation][ng-material] and [PyPI page][ng-material-pypi]. -* [MkDocs NG and its alternatives](../about/comparison.md) compares the +* [MkDocs Alternatives Compared](../about/comparison.md) compares the build tools. [open an issue]: https://github.com/mkdocs-ng/mkdocs/issues diff --git a/mkdocs.yml b/mkdocs.yml index 81042683..7ad0e9f9 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -11,6 +11,8 @@ theme: logo: img/logo.svg logo_dark: img/logo-dark.svg favicon: img/favicon.svg + # Shown when a page is shared on social media. + social_image: img/social.png # Brand blue; docs/css/extra.css sets a lighter blue for the dark palette. accent: "#0061fe" @@ -22,7 +24,7 @@ nav: - About: - Release Notes: about/release-notes.md - Fixed Upstream Issues: about/fixed-upstream-issues.md - - Comparison: about/comparison.md + - MkDocs Alternatives: about/comparison.md - Contributing: about/contributing.md - Governance: about/governance.md - License: about/license.md From 82ee801e9ad740cdee5fe792220f0fde8c49d8bd Mon Sep 17 00:00:00 2001 From: Xianpeng Shen Date: Sat, 14 Nov 2026 19:49:15 +0000 Subject: [PATCH 2/2] Give every docs page a description, a social image and a robots.txt Every page had the same meta description (site_description), so search results and llms.txt showed one generic line for all of them. Each page now has its own description in front matter, which Sumi uses for the meta, Open Graph and Twitter tags and llms_txt for its page list. Also: * docs/robots.txt points crawlers at the sitemap (robots.txt was a 404). * theme.social_image: link previews get the MkDocs NG card instead of none. * The Markdown copies of Governance and Contributing held only a snippet line; docs/hooks.py now inlines included .md files so llms.txt has their text. * README leads with what MkDocs NG is and why it exists, links the new page, and links the catalog, Sumi and NG Material sites instead of their repos. * pyproject.toml gets keywords for PyPI search. --- README.md | 24 ++++++++++++++-------- docs/about/contributing.md | 4 ++++ docs/about/fixed-upstream-issues.md | 4 ++++ docs/about/governance.md | 4 ++++ docs/about/license.md | 4 ++++ docs/about/release-notes.md | 4 ++++ docs/dev-guide/README.md | 4 ++++ docs/dev-guide/api.md | 4 ++++ docs/dev-guide/plugins.md | 4 ++++ docs/dev-guide/themes.md | 4 ++++ docs/dev-guide/translations.md | 4 ++++ docs/getting-started.md | 4 ++++ docs/hooks.py | 14 +++++++++++++ docs/img/social.png | Bin 0 -> 75869 bytes docs/robots.txt | 4 ++++ docs/user-guide/choosing-your-theme.md | 4 ++++ docs/user-guide/cli.md | 4 ++++ docs/user-guide/configuration.md | 4 ++++ docs/user-guide/customizing-your-theme.md | 4 ++++ docs/user-guide/deploying-your-docs.md | 4 ++++ docs/user-guide/installation.md | 4 ++++ docs/user-guide/localizing-your-theme.md | 4 ++++ docs/user-guide/migrating.md | 4 ++++ docs/user-guide/multi-language-sites.md | 4 ++++ docs/user-guide/python-api.md | 4 ++++ docs/user-guide/versioned-docs.md | 4 ++++ docs/user-guide/writing-your-docs.md | 4 ++++ mkdocs/tests/docs_hooks_tests.py | 10 +++++++++ pyproject.toml | 9 ++++++++ 29 files changed, 145 insertions(+), 8 deletions(-) create mode 100644 docs/img/social.png create mode 100644 docs/robots.txt diff --git a/README.md b/README.md index 94a47e0b..e2050b70 100644 --- a/README.md +++ b/README.md @@ -30,9 +30,16 @@ Documentation · Switching from MkDocs · Release notes · - Plugin catalog + Plugin catalog

+**MkDocs NG** is the maintained fork of [MkDocs][mkdocs/mkdocs] 1.x. Upstream +MkDocs has had no 1.x release since August 2024, and its 2.0 rewrite can't +build existing sites. MkDocs NG keeps the `mkdocs` command, `mkdocs.yml`, +plugins and themes working, with bug, security and compatibility fixes until at +least 2028-12-31. See [Is MkDocs still maintained?][is-maintained] and +[MkDocs alternatives compared][comparison]. + MkDocs is a **fast**, **simple**, and **downright gorgeous** static site generator that's geared towards building project documentation. Documentation source files are written in Markdown and configured with a single YAML @@ -55,9 +62,8 @@ third-party themes, plugins, and Markdown extensions.

> [!NOTE] -> **MkDocs NG** is a maintained fork of [mkdocs/mkdocs], published on PyPI as -> `mkdocs-ng` while keeping the `mkdocs` command, imports and configuration -> unchanged — a drop-in replacement. +> **MkDocs NG** is published on PyPI as `mkdocs-ng` while keeping the `mkdocs` +> command, imports and configuration unchanged — a drop-in replacement. > > Highlights beyond the last upstream release: Python 3.10–3.15 support, > built-in `llms.txt` and per-page Markdown output for LLMs and coding agents, @@ -118,7 +124,8 @@ first, but they are still welcome in [Discussions]. - [Fixed Upstream Issues][fixed-upstream] - [Switching to MkDocs NG][migrating] - [Governance and how long 1.x is supported][governance] -- [Comparison with upstream MkDocs 2.0, ProperDocs and Zensical][comparison] +- [Is MkDocs still maintained?][is-maintained] +- [MkDocs alternatives compared: MkDocs NG, MkDocs 2.0, ProperDocs and Zensical][comparison] - [Catalog of third-party plugins, themes and recipes][catalog] - [Sumi][sumi], a local-first documentation theme from the MkDocs NG project - [MkDocs NG Material][ng-material], Material for MkDocs maintained for MkDocs NG @@ -145,12 +152,13 @@ discussion forums are expected to follow the [PyPA Code of Conduct]. [plugins-install]: https://mkdocs-ng.org/user-guide/installation/#plugins-themes-and-the-mkdocs-package [migrating]: https://mkdocs-ng.org/user-guide/migrating/ [comparison]: https://mkdocs-ng.org/about/comparison/ +[is-maintained]: https://mkdocs-ng.org/user-guide/is-mkdocs-still-maintained/ [governance]: https://mkdocs-ng.org/about/governance/ [Contributing Guide]: https://mkdocs-ng.org/about/contributing/ [PyPA Code of Conduct]: https://www.pypa.io/en/latest/code-of-conduct/ -[catalog]: https://github.com/mkdocs-ng/catalog -[sumi]: https://github.com/mkdocs-ng/mkdocs-sumi -[ng-material]: https://github.com/mkdocs-ng/mkdocs-material +[catalog]: https://catalog.mkdocs-ng.org/ +[sumi]: https://sumi.mkdocs-ng.org/ +[ng-material]: https://material.mkdocs-ng.org/ ## License diff --git a/docs/about/contributing.md b/docs/about/contributing.md index 0c7bc9cb..2d9dd81d 100644 --- a/docs/about/contributing.md +++ b/docs/about/contributing.md @@ -1 +1,5 @@ +--- +description: "How to report bugs, propose changes and send pull requests to MkDocs NG, the maintained fork of MkDocs 1.x." +--- + --8<-- ".github/CONTRIBUTING.md" diff --git a/docs/about/fixed-upstream-issues.md b/docs/about/fixed-upstream-issues.md index fe5ec114..e8d39e96 100644 --- a/docs/about/fixed-upstream-issues.md +++ b/docs/about/fixed-upstream-issues.md @@ -1,3 +1,7 @@ +--- +description: "Long-standing upstream MkDocs bugs that are fixed in MkDocs NG, with the release that fixed each one. Upgrading is a one-line change." +--- + # Upstream Issues Fixed in MkDocs NG MkDocs NG is a maintained fork of [mkdocs/mkdocs], which is no longer under diff --git a/docs/about/governance.md b/docs/about/governance.md index 246f1ae1..c09827c0 100644 --- a/docs/about/governance.md +++ b/docs/about/governance.md @@ -1 +1,5 @@ +--- +description: "Who maintains MkDocs NG, how decisions are made, how releases are published and what happens if a maintainer steps away." +--- + --8<-- ".github/GOVERNANCE.md" diff --git a/docs/about/license.md b/docs/about/license.md index 44546d3c..4cd88d1a 100644 --- a/docs/about/license.md +++ b/docs/about/license.md @@ -1,3 +1,7 @@ +--- +description: "MkDocs NG is open source under the BSD 2-Clause license. Licenses of the projects it includes." +--- + # License The legal stuff. diff --git a/docs/about/release-notes.md b/docs/about/release-notes.md index 5fae93ba..36c1bbb1 100644 --- a/docs/about/release-notes.md +++ b/docs/about/release-notes.md @@ -1,3 +1,7 @@ +--- +description: "Release notes for every MkDocs NG version, and the versioning and support rules: MkDocs NG 1.x gets fixes until at least 2028-12-31." +--- + # Release Notes --- diff --git a/docs/dev-guide/README.md b/docs/dev-guide/README.md index 183365e0..6944b24b 100644 --- a/docs/dev-guide/README.md +++ b/docs/dev-guide/README.md @@ -1,3 +1,7 @@ +--- +description: "Documentation for developers of MkDocs themes and plugins." +--- + # Developer Guide Extending MkDocs diff --git a/docs/dev-guide/api.md b/docs/dev-guide/api.md index bc2c85fd..9c8a1aff 100644 --- a/docs/dev-guide/api.md +++ b/docs/dev-guide/api.md @@ -1,3 +1,7 @@ +--- +description: "Reference for the MkDocs Python API used by plugins, themes and scripts: configuration, files, pages, navigation and build functions." +--- + # API reference NOTE: The main entry point to the API is through [Events](plugins.md#events) that are received by plugins. These events' descriptions link back to this page. diff --git a/docs/dev-guide/plugins.md b/docs/dev-guide/plugins.md index d3c9eb7b..405902db 100644 --- a/docs/dev-guide/plugins.md +++ b/docs/dev-guide/plugins.md @@ -1,3 +1,7 @@ +--- +description: "How to install, use and write MkDocs plugins, with every plugin event and the order in which they run." +--- + # MkDocs Plugins A Guide to installing, using and creating MkDocs Plugins diff --git a/docs/dev-guide/themes.md b/docs/dev-guide/themes.md index d3cdacc7..72ab5a5c 100644 --- a/docs/dev-guide/themes.md +++ b/docs/dev-guide/themes.md @@ -1,3 +1,7 @@ +--- +description: "How to create, package and distribute a custom MkDocs theme, with the template variables themes can use." +--- + # Developing Themes A guide to creating and distributing custom themes. diff --git a/docs/dev-guide/translations.md b/docs/dev-guide/translations.md index 3fdeaace..3f4cc70d 100644 --- a/docs/dev-guide/translations.md +++ b/docs/dev-guide/translations.md @@ -1,3 +1,7 @@ +--- +description: "How to add or update translations of the built-in MkDocs themes." +--- + # Translations Theme localization guide. diff --git a/docs/getting-started.md b/docs/getting-started.md index 16afbc95..2614aa6e 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -1,3 +1,7 @@ +--- +description: "Install MkDocs NG, create a site, preview it as you write and build it, in a few minutes." +--- + # Getting Started with MkDocs An introductory tutorial! diff --git a/docs/hooks.py b/docs/hooks.py index 76e4ac4b..b736bf90 100644 --- a/docs/hooks.py +++ b/docs/hooks.py @@ -28,6 +28,7 @@ ISSUE_REF_RE = re.compile(r"(?\d+)\b") VERSION_EXAMPLE_RE = re.compile(r"mkdocs, version \S+ from") COMPAT_CASES_MARKER = "" +MARKDOWN_SNIPPET_RE = re.compile(r'^--8<-- "([^"]+\.md)"[ \t]*$', re.MULTILINE) COMPAT_CASES_PATH = Path(__file__).resolve().parents[1] / "compat" / "cases.yaml" @@ -149,9 +150,20 @@ def on_config(config: MkDocsConfig) -> None: _fix_cli_page_defaults() +def _inline_markdown_snippets(markdown: str, root: Path) -> str: + # Pages that only include a Markdown file from the repository, such as + # .github/GOVERNANCE.md, get its text here instead of through + # pymdownx.snippets, so that their Markdown copy for llms.txt has it too. + return MARKDOWN_SNIPPET_RE.sub( + lambda m: Path(root, m[1]).read_text(encoding="utf-8"), markdown + ) + + def on_page_markdown( markdown: str, page: Page, config: MkDocsConfig, **kwargs ) -> str | None: + markdown = _inline_markdown_snippets(markdown, Path(config.config_file_path).parent) + if page.file.src_uri == "about/release-notes.md": return _rewrite_release_notes_links(_update_version_example(markdown)) @@ -176,3 +188,5 @@ def replacement(m: re.Match) -> str: markdown, flags=re.MULTILINE, ) + + return markdown diff --git a/docs/img/social.png b/docs/img/social.png new file mode 100644 index 0000000000000000000000000000000000000000..4f575c29d0f11168f3d5b4aaccaf128f00cd2727 GIT binary patch literal 75869 zcmeFZWmr{T*EhNWB?SyZ8l|MWr36HzyPHjS=LSSnKtMveQyS?8MMOF_-QC^IJ5lfZ zxu5es?{%*8;aul@`0p>Qwf9Kyg+THkJPGzlzrO%issFu7 z;?Gsq|NSaw2OGZIEBV;Djd@r(On4ZfEG#^X98g{(Mgulp14d33Hf|$U7H%GH6K?P< zq{zR+(f%3E!0~^3D3gJsBhw2FoiPP z*_c|G+c-KI*cd@2#oQR&tnK*B&5ik3cv*Pa4Y{F=EC!sc;GJ0684X!X*cput42-}} z9400l238JGD=-ic*38__%+A08NFiqefgsHPm0RThEVqHt?;Dw1*#0fFW7}81>)lyV z6`Wx9I|@P+V4%2Lq0>$OUi>EAaPtf5X&2gfwa|I&t|U%HXA zgOwYjBh<=-;#M9Lf!}ximxh`DcLf@o8917$lW%;{I(fV@8ShGaFcO-BB7~T0gXTB! zspr!HsYlvmvrgt;IowE$Y^|9LY@Ey-Z0*dAn2f9poQ9NHbz$9^^A|ejQ#pM z!@~dP8NO8|ld*x5!M`WCzu2m8_(Q{n&ZEihBOCf=@PqH|1ZNo;SecqQni;Thav9kf z7|Yz=@$b*yIT@C)ia=%QA53z>*2rzhy?Ws5C#AG7(i8ae9IiJ0VeGfiHoqqtyuOXO z3DAlK)D4L2cx$14>EPVJ!Rhf66Dz2VsgoH2UJ!5&f`8wG=J$KB8Cm`33j6H`ZYR~; z`j4F=V*g*oHFq>OwJ~sVc7VFc{D-CeHZA7=M-JkTHU4|J|8Y@54cWOk**Mr4Svh%( z7�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 literal 0 HcmV?d00001 diff --git a/docs/robots.txt b/docs/robots.txt new file mode 100644 index 00000000..1fe8e388 --- /dev/null +++ b/docs/robots.txt @@ -0,0 +1,4 @@ +User-agent: * +Allow: / + +Sitemap: https://mkdocs-ng.org/sitemap.xml diff --git a/docs/user-guide/choosing-your-theme.md b/docs/user-guide/choosing-your-theme.md index aef92e30..5e4ff14f 100644 --- a/docs/user-guide/choosing-your-theme.md +++ b/docs/user-guide/choosing-your-theme.md @@ -1,3 +1,7 @@ +--- +description: "The built-in mkdocs and readthedocs themes, the Sumi theme and third-party themes, and how to choose and configure one." +--- + # Choosing your Theme Selecting and configuring a theme. diff --git a/docs/user-guide/cli.md b/docs/user-guide/cli.md index 987c1382..a0ece335 100644 --- a/docs/user-guide/cli.md +++ b/docs/user-guide/cli.md @@ -1,3 +1,7 @@ +--- +description: "Every mkdocs command and option: new, serve, build, gh-deploy and get-deps." +--- + # Command Line Interface ::: mkdocs-click diff --git a/docs/user-guide/configuration.md b/docs/user-guide/configuration.md index 29132f50..67a1f7d2 100644 --- a/docs/user-guide/configuration.md +++ b/docs/user-guide/configuration.md @@ -1,3 +1,7 @@ +--- +description: "Every setting you can use in mkdocs.yml, with defaults and examples." +--- + # Configuration Guide to all available configuration settings. diff --git a/docs/user-guide/customizing-your-theme.md b/docs/user-guide/customizing-your-theme.md index 87093d1a..ed116742 100644 --- a/docs/user-guide/customizing-your-theme.md +++ b/docs/user-guide/customizing-your-theme.md @@ -1,3 +1,7 @@ +--- +description: "Change an existing MkDocs theme with extra CSS and JavaScript, or override its templates, without building a theme from scratch." +--- + # Customizing Your Theme Altering a theme to suit your needs. diff --git a/docs/user-guide/deploying-your-docs.md b/docs/user-guide/deploying-your-docs.md index 3eef2d0a..44a15e21 100644 --- a/docs/user-guide/deploying-your-docs.md +++ b/docs/user-guide/deploying-your-docs.md @@ -1,3 +1,7 @@ +--- +description: "Deploy an MkDocs site to GitHub Pages, Read the Docs or any host that serves static files." +--- + # Deploying your docs A basic guide to deploying your docs to various hosting providers diff --git a/docs/user-guide/installation.md b/docs/user-guide/installation.md index 233bd57c..c5972708 100644 --- a/docs/user-guide/installation.md +++ b/docs/user-guide/installation.md @@ -1,3 +1,7 @@ +--- +description: "Install MkDocs NG with pip or uv, and how it works alongside the upstream mkdocs package that plugins and themes depend on." +--- + # MkDocs Installation A detailed guide. diff --git a/docs/user-guide/localizing-your-theme.md b/docs/user-guide/localizing-your-theme.md index 279f4a8e..82c1959e 100644 --- a/docs/user-guide/localizing-your-theme.md +++ b/docs/user-guide/localizing-your-theme.md @@ -1,3 +1,7 @@ +--- +description: "Show the text of your MkDocs theme, such as search and navigation labels, in your site's language." +--- + # Localizing Your Theme Display your theme in your preferred language. diff --git a/docs/user-guide/migrating.md b/docs/user-guide/migrating.md index ea5f5482..24ed5478 100644 --- a/docs/user-guide/migrating.md +++ b/docs/user-guide/migrating.md @@ -1,3 +1,7 @@ +--- +description: "Move an existing MkDocs site to MkDocs NG. It keeps the mkdocs command, mkdocs.yml, plugins and themes, so switching is a package change." +--- + # Switching to MkDocs NG Move an existing MkDocs site to MkDocs NG. diff --git a/docs/user-guide/multi-language-sites.md b/docs/user-guide/multi-language-sites.md index 43a86161..1e25cd57 100644 --- a/docs/user-guide/multi-language-sites.md +++ b/docs/user-guide/multi-language-sites.md @@ -1,3 +1,7 @@ +--- +description: "Publish your documentation in several languages from one mkdocs.yml with MkDocs NG's languages setting." +--- + # Multi-language Sites Publish your documentation in several languages from one `mkdocs.yml`. diff --git a/docs/user-guide/python-api.md b/docs/user-guide/python-api.md index 71b438b0..7dad81e1 100644 --- a/docs/user-guide/python-api.md +++ b/docs/user-guide/python-api.md @@ -1,3 +1,7 @@ +--- +description: "Build and serve MkDocs sites from Python with mkdocs.build() and mkdocs.serve(), for CI scripts and build tool integrations." +--- + # Python API MkDocs can be used as a Python library in addition to a command-line tool. diff --git a/docs/user-guide/versioned-docs.md b/docs/user-guide/versioned-docs.md index 099d7480..eec17013 100644 --- a/docs/user-guide/versioned-docs.md +++ b/docs/user-guide/versioned-docs.md @@ -1,3 +1,7 @@ +--- +description: "Keep the docs of older releases online with mike, with a menu to switch between versions." +--- + # Versioned Docs Keep the docs of older releases online, with a menu to switch between versions. diff --git a/docs/user-guide/writing-your-docs.md b/docs/user-guide/writing-your-docs.md index 08982150..fce7e03e 100644 --- a/docs/user-guide/writing-your-docs.md +++ b/docs/user-guide/writing-your-docs.md @@ -1,3 +1,7 @@ +--- +description: "How to lay out your Markdown files, link between pages, add images and use the Markdown that MkDocs supports." +--- + # Writing your docs How to layout and write your Markdown source files. diff --git a/mkdocs/tests/docs_hooks_tests.py b/mkdocs/tests/docs_hooks_tests.py index 060d0ca7..9423213d 100644 --- a/mkdocs/tests/docs_hooks_tests.py +++ b/mkdocs/tests/docs_hooks_tests.py @@ -39,6 +39,16 @@ def test_version_example_tracks_current_release(self): self.assertIn(f"mkdocs, version {mkdocs.__version__} from", result) self.assertNotIn("version 0.0.0", result) + def test_markdown_snippets_are_inlined(self): + root = Path(__file__).resolve().parents[2] + markdown = ( + '--8<-- ".github/GOVERNANCE.md"\n\n--8<-- "docs/img/plugin-events.svg"\n' + ) + result = self.hooks._inline_markdown_snippets(markdown, root) + self.assertTrue(result.startswith("# Governance\n")) + self.assertNotIn('--8<-- ".github/GOVERNANCE.md"', result) + self.assertIn('--8<-- "docs/img/plugin-events.svg"', result) + def test_compat_cases_list_links_each_case_to_pypi(self): cases = [ {"name": "mkdocstrings-python", "install": ["mkdocstrings[python]"]}, diff --git a/pyproject.toml b/pyproject.toml index 6307fe19..231a02d9 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -6,6 +6,15 @@ build-backend = "hatchling.build" name = "mkdocs-ng" description = "Write Markdown. Ship docs. The maintained MkDocs that keeps your plugins working." readme = "README.md" +keywords = [ + "mkdocs", + "documentation", + "static site generator", + "markdown", + "docs", + "mkdocs fork", + "mkdocs alternative", +] license = "BSD-2-Clause" authors = [ {name = "Tom Christie", email = "tom@tomchristie.com"},