Merge branch 'master' into merge/piri-piri

.devcontainer/devcontainer.json

@@ -5,7 +5,7 @@
 		"ghcr.io/devcontainers/features/python:1": {
 			"installTools": true,
 			"version": "3.11"
-	}
+	  }
 	},
 	"postCreateCommand": "pip install -e . && pip install mkdocs-minify-plugin mkdocs-redirects && npm install && npm run build"
 }

README.md

@@ -107,9 +107,6 @@
   <a href="https://elastic.co" target=_blank><img
     src="https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-elastic.png" height="58"
   /></a>
-  <a href="https://www.hyperledger.org/" target=_blank><img
-    src="https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-hyperledger.png" height="58"
-  /></a>
   <a href="https://ipfabric.io/" target=_blank><img
     src="https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-ip-fabric.png" height="58"
   /></a>
@@ -158,6 +155,9 @@
   <a href="https://koor.tech/" target=_blank><img
     src="https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-koor.png" height="58"
   /></a>
+  <a href="https://astral.sh/" target=_blank><img
+    src="https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-astral.png" height="58"
+  /></a>
 </p>
 <p>&nbsp;</p>
 

docs/insiders/index.md

@@ -88,7 +88,7 @@ a handful of them, [thanks to our awesome sponsors]!
 ## What's in it for me?
 
 The moment you [become a sponsor][how to become a sponsor], you'll get __immediate
-access to 28 additional features__ that you can __start using now__, and
+access to 22 additional features__ that you can __start using now__, and
 which are currently exclusively available to sponsors:
 
 <div class="mdx-columns" markdown>
@@ -107,20 +107,14 @@ which are currently exclusively available to sponsors:
 - [x] [Tags plugin: allow list] + [custom sorting]
 - [x] [Blog plugin: custom index pages]
 - [x] [Blog plugin: related links]
-- [x] [Blog plugin]
-- [x] [Navigation status]
 - [x] [Meta plugin]
 - [x] [Tags plugin: additional indexes]
 - [x] [Document contributors]
 - [x] [Automatic light / dark mode]
 - [x] [Content tabs: anchor links]
-- [x] [Navigation pruning]
 - [x] [Tooltips]
-- [x] [Chinese search support]
 - [x] [Card grids]
 - [x] [Privacy plugin]
-- [x] [Annotations]
-- [x] [Navigation icons]
 
 </div>
 
@@ -187,7 +181,6 @@ You can cancel your sponsorship anytime.[^5]
 [![World Wide Technology]](https://wwt.com){ target=_blank title="World Wide Technology" }
 [![Coda]](https://coda.io){ target=_blank title="Coda" }
 [![Elastic]](https://elastic.co){ target=_blank title="Elastic" }
-[![Hyperledger]](https://www.hyperledger.org){ target=_blank title="Hyperledger Foundation" }
 [![IP Fabric]](https://ipfabric.io/){ target=_blank title="IP Fabric" }
 [![Apex.AI]](https://www.apex.ai/){ target=_blank title="Apex.AI" }
 [![Jitterbit]](https://jitterbit.com/){ target=_blank title="Jitterbit" }
@@ -204,6 +197,7 @@ You can cancel your sponsorship anytime.[^5]
 [![Kolena]](https://kolena.io/){ target=_blank title="Kolena" }
 [![Evergiving]](https://www.evergiving.com/){ target=_blank title="Evergiving" }
 [![Koor]](https://koor.tech/){ target=_blank title="Koor" }
+[![Astral]](https://astral.sh/){ target=_blank title="Astral" }
 
 </div>
 
@@ -221,7 +215,6 @@ You can cancel your sponsorship anytime.[^5]
   [World Wide Technology]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-wwt.png
   [Coda]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-coda.png
   [Elastic]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-elastic.png
-  [Hyperledger]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-hyperledger.png
   [IP Fabric]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-ip-fabric.png
   [Apex.AI]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-apex-ai.png
   [Jitterbit]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-jitterbit.png
@@ -238,6 +231,7 @@ You can cancel your sponsorship anytime.[^5]
   [Kolena]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-kolena.png
   [Evergiving]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-evergiving.png
   [Koor]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-koor.png
+  [Astral]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-astral.png
 
 <hr />
 
@@ -264,22 +258,6 @@ features prefixed with a checkmark symbol, denoting whether a feature is
 :octicons-check-circle-fill-24:{ style="color: var(--md-default-fg-color--lightest)" } planned, but not yet implemented. When the funding goal is hit, the features
 are released for general availability.
 
-#### $ 12,000 – Piri Piri
-
-- [x] [Blog plugin]
-- [x] [Chinese search support]
-- [x] [Annotations]
-- [x] [Navigation icons]
-- [x] [Navigation pruning]
-- [x] [Navigation status]
-
-  [Blog plugin]: ../setup/setting-up-a-blog.md
-  [Chinese search support]: ../blog/posts/chinese-search-support.md
-  [Annotations]: ../reference/annotations.md
-  [Navigation icons]: ../reference/index.md#setting-the-page-icon
-  [Navigation pruning]: ../setup/setting-up-navigation.md#navigation-pruning
-  [Navigation status]: ../reference/index.md#setting-the-page-status
-
 #### $ 14,000 – Goat's Horn
 
 - [x] [Privacy plugin]
@@ -348,6 +326,22 @@ This section lists all funding goals that were previously completed, which means
 that those features were part of Insiders, but are now generally available and
 can be used by all users.
 
+#### $ 12,000 – Piri Piri
+
+- [x] [Blog plugin]
+- [x] [Chinese search support]
+- [x] [Annotations]
+- [x] [Navigation icons]
+- [x] [Navigation pruning]
+- [x] [Navigation status]
+
+  [Blog plugin]: ../setup/setting-up-a-blog.md
+  [Chinese search support]: ../blog/posts/chinese-search-support.md
+  [Annotations]: ../reference/annotations.md
+  [Navigation icons]: ../reference/index.md#setting-the-page-icon
+  [Navigation pruning]: ../setup/setting-up-navigation.md#navigation-pruning
+  [Navigation status]: ../reference/index.md#setting-the-page-status
+
 #### $ 10,000 – Carolina Reaper
 
 - [x] [Brand new search plugin]

docs/reference/annotations.md

@@ -35,8 +35,7 @@ See additional configuration options:
 
 ### Using annotations
 
-[:octicons-heart-fill-24:{ .mdx-heart } Sponsors only][Insiders]{ .mdx-insiders } ·
-[:octicons-tag-24: insiders-4.6.0][Insiders] ·
+[:octicons-tag-24: 9.2.0b0][Annotation support] ·
 :octicons-beaker-24: Experimental
 
 Annotations consist of two parts: a marker, which can be placed anywhere in
@@ -65,7 +64,7 @@ Note that the `annotate` class must only be added to the outermost block. All
 nested elements can use the same list to define annotations, except when
 annotations are nested themselves.
 
-  [Insiders]: ../insiders/index.md
+  [Annotation support]: https://github.com/squidfunk/mkdocs-material/releases/tag/9.2.0b0
 
 #### in annotations
 

docs/reference/index.md

@@ -121,8 +121,7 @@ description: Nullam urna elit, malesuada eget finibus ut, ac tortor. # (1)!
 
 ### Setting the page `icon`
 
-[:octicons-heart-fill-24:{ .mdx-heart } Sponsors only][Insiders]{ .mdx-insiders } ·
-[:octicons-tag-24: insiders-4.5.0][Insiders] ·
+[:octicons-tag-24: 9.2.0b0][Page icon support] ·
 :octicons-beaker-24: Experimental
 
 An icon can be assigned to each page, which is then rendered as part of the
@@ -150,14 +149,14 @@ icon: material/emoticon-happy # (1)!
       </div>
     </div>
 
+  [Page icon support]: https://github.com/squidfunk/mkdocs-material/releases/tag/9.2.0b0
   [Insiders]: ../insiders/index.md
   [icon search]: icons-emojis.md#search
   [navigation tabs]: ../setup/setting-up-navigation.md#navigation-tabs
 
 ### Setting the page `status`
 
-[:octicons-heart-fill-24:{ .mdx-heart } Sponsors only][Insiders]{ .mdx-insiders } ·
-[:octicons-tag-24: insiders-4.22.0][Insiders] ·
+[:octicons-tag-24: 9.2.0b0][Page status support] ·
 :octicons-beaker-24: Experimental
 
 A status can be assigned to each page, which is then displayed as part of the
@@ -198,6 +197,8 @@ The following status identifiers are currently supported:
 - :material-alert-decagram: – `new`
 - :material-trash-can: – `deprecated`
 
+  [Page status support]: https://github.com/squidfunk/mkdocs-material/releases/tag/9.2.0b0
+
 ### Setting the page `subtitle`
 
 [:octicons-heart-fill-24:{ .mdx-heart } Sponsors only][Insiders]{ .mdx-insiders } ·

docs/setup/setting-up-a-blog.md

@@ -19,8 +19,7 @@ __Check out our [blog], which is created with the new [built-in blog plugin]!__
 
 ### Built-in blog plugin
 
-[:octicons-heart-fill-24:{ .mdx-heart } Sponsors only][Insiders]{ .mdx-insiders } ·
-[:octicons-tag-24: insiders-4.23.0][Insiders] ·
+[:octicons-tag-24: 9.2.0b0][Blog plugin support] ·
 :octicons-cpu-24: Plugin ·
 :octicons-beaker-24: Experimental
 
@@ -127,6 +126,7 @@ back here later for fine-tuning the output.__
 
 ---
 
+  [Blog plugin support]: https://github.com/squidfunk/mkdocs-material/releases/tag/9.2.0b0
   [Insiders]: ../insiders/index.md
   [built-in plugins]: ../insiders/getting-started.md#built-in-plugins
   [this is configurable]: #+blog.blog_dir
@@ -1133,6 +1133,10 @@ linked with their titles.
 
 #### Adding related links
 
+[:octicons-heart-fill-24:{ .mdx-heart } Sponsors only][Insiders]{ .mdx-insiders } ·
+[:octicons-tag-24: insiders-4.23.0][Insiders] ·
+:octicons-beaker-24: Experimental
+
 Related links offer the perfect way to prominently add a _further reading_ 
 section to your post that is included in the left sidebar, guiding the user to 
 other destinations of your documentation. Use the front matter `links` property 
@@ -1293,6 +1297,7 @@ nav:
 
 ### Custom index pages
 
+[:octicons-heart-fill-24:{ .mdx-heart } Sponsors only][Insiders]{ .mdx-insiders } ·
 [:octicons-tag-24: insiders-4.24.0][Insiders] ·
 :octicons-beaker-24: Experimental
 

docs/setup/setting-up-navigation.md

@@ -52,6 +52,8 @@ theme:
     - navigation.instant.prefetch
 ```
 
+  [Insiders]: ../insiders/index.md
+
 ### Anchor tracking
 
 [:octicons-tag-24: 8.0.0][Anchor tracking support] ·
@@ -221,8 +223,7 @@ theme:
 
 ### Navigation pruning
 
-[:octicons-heart-fill-24:{ .mdx-heart } Sponsors only][Insiders]{ .mdx-insiders } ·
-[:octicons-tag-24: insiders-4.16.0][Insiders] ·
+[:octicons-tag-24: 9.2.0b0][Navigation pruning support] ·
 :octicons-beaker-24: Experimental
 
 When pruning is enabled, only the visible navigation items are included in the 
@@ -244,7 +245,7 @@ This feature flag is especially useful for documentation sites with 100+ or even
 Navigation pruning will replace all expandable sections with links to the first
 page in that section (or the section index page).
 
-  [Insiders]: ../insiders/index.md
+  [Navigation pruning support]: https://github.com/squidfunk/mkdocs-material/releases/tag/9.2.0b0
   [navigation.expand]: #navigation-expansion
 
 ### Section index pages

docs/setup/setting-up-site-search.md

@@ -191,27 +191,24 @@ The following configuration options are supported:
 
 #### Chinese language support
 
-[:octicons-heart-fill-24:{ .mdx-heart } Sponsors only][Insiders]{ .mdx-insiders } ·
-[:octicons-tag-24: insiders-4.14.0][Insiders] ·
+[:octicons-tag-24: 9.2.0b0][Chinese language support] ·
 :octicons-beaker-24: Experimental
 
-[Insiders] adds search support for the Chinese language (see our [blog article]
-[chinese search] from May 2022) by integrating with the text segmentation
-library [jieba], which can be installed with `pip`.
+In order to add support for Chinese languages to the [built-in search plugin],
+install the text segmentation library [jieba] via `pip`, and the plugin will
+run all text through the segmenter:
 
 ``` sh
 pip install jieba
 ```
 
-If [jieba] is installed, the [built-in search plugin] automatically detects
-Chinese characters and runs them through the segmenter. The following
-configuration options are available:
+The following configuration options are available:
 
 [`jieba_dict`](#+search.jieba_dict){ #+search.jieba_dict }
 
-:   [:octicons-tag-24: insiders-4.17.2][Insiders] · :octicons-milestone-24:
-    Default: _none_ – This option allows for specifying a [custom dictionary]
-    to be used by [jieba] for segmenting text, replacing the default dictionary:
+:   :octicons-milestone-24: Default: _none_ – This option allows for specifying
+    a [custom dictionary] to be used by [jieba] for segmenting text, replacing
+    the default dictionary:
 
     ``` yaml
     plugins:
@@ -226,10 +223,9 @@ configuration options are available:
 
 [`jieba_dict_user`](#+search.jieba_dict_user){ #+search.jieba_dict_user }
 
-:   [:octicons-tag-24: insiders-4.17.2][Insiders] · :octicons-milestone-24:
-    Default: _none_ – This option allows for specifying an additional
-    [user dictionary] to be used by [jieba] for segmenting text, augmenting the
-    default dictionary:
+:   :octicons-milestone-24: Default: _none_ – This option allows for specifying
+    an additional [user dictionary] to be used by [jieba] for segmenting text, 
+    augmenting the default dictionary:
 
     ``` yaml
     plugins:
@@ -240,7 +236,7 @@ configuration options are available:
     User dictionaries can be used for tuning the segmenter to preserve
     technical terms.
 
-  [Insiders]: ../insiders/index.md
+  [Chinese language support]: https://github.com/squidfunk/mkdocs-material/releases/tag/9.2.0b0
   [chinese search]: ../blog/posts/chinese-search-support.md
   [jieba]: https://pypi.org/project/jieba/
   [built-in search plugin]: #built-in-search-plugin