Updated Insiders changelog

CHANGELOG

@@ -1,3 +1,8 @@
+mkdocs-material-8.3.9+insiders-4.20.0 (2022-07-07)
+
+  * Added support for additional tags indexes
+  * Fixed #4100: Tag icons not shown in tags index
+
 mkdocs-material-8.3.9+insiders-4.19.2 (2022-07-04)
 
   * Fixed #4051: Privacy plugin fails if symlinking isn't allowed on Windows

docs/insiders/changelog.md

@@ -6,6 +6,11 @@ template: overrides/main.html
 
 ## Material for MkDocs Insiders
 
+### 4.20.0 <small>_ July 7, 2022</small> { id="4.20.0" }
+
+- Added support for additional tags indexes
+- Fixed #4100: Tag icons not shown in tags index
+
 ### 4.19.2 <small>_ July 4, 2022</small> { id="4.19.2" }
 
 - Fixed #4051: Privacy plugin fails if symlinking isn't allowed on Windows

docs/insiders/index.md

@@ -82,14 +82,15 @@ a handful of them, [thanks to our awesome sponsors]!
 ## What's in for me?
 
 The moment you [become a sponsor][how to become a sponsor], you'll get __immediate
-access to 25 additional features__ that you can start using right away, and
+access to 26 additional features__ that you can start using right away, and
 which are currently exclusively available to sponsors:
 
 <div class="mdx-columns" markdown>
 
+- [x] [Additional tags indexes] :material-alert-decagram:{ .mdx-pulse title="Added on July 7, 2022" }
 - [x] [Document contributors] :material-alert-decagram:{ .mdx-pulse title="Added on June 24, 2022" }
 - [x] [Automatic light / dark mode] :material-alert-decagram:{ .mdx-pulse title="Added on June 11, 2022" }
-- [x] [Content tabs: anchor links] :material-alert-decagram:{ .mdx-pulse title="Added on June 4, 2022" }
+- [x] [Content tabs: anchor links]
 - [x] [Navigation pruning]
 - [x] [Tooltips]
 - [x] [Chinese search support]
@@ -299,9 +300,11 @@ are released for general availability.
 
 #### $ 16,000 – Chipotle
 
+- [x] [Additional tags indexes]
 - [ ] [Instant previews]
 - [ ] ... more to be announced
 
+  [Additional tags indexes]: ../setup/setting-up-tags.md#tags-extra-files
   [Instant previews]: https://twitter.com/squidfunk/status/1466794654213492743
 
 ### Goals completed

docs/reference/content-tabs.md

@@ -31,7 +31,7 @@ See additional configuration options:
   [SuperFences]: ../setup/extensions/python-markdown-extensions.md#superfences
   [Tabbed]: ../setup/extensions/python-markdown-extensions.md#tabbed
 
-### Anchor links :material-alert-decagram:{ .mdx-pulse title="Added on June 4, 2022" }
+### Anchor links
 
 [:octicons-heart-fill-24:{ .mdx-heart } Sponsors only][Insiders]{ .mdx-insiders } ·
 [:octicons-tag-24: insiders-4.17.0][Insiders] ·

docs/schema/plugins/tags.json

@@ -20,6 +20,20 @@
               "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/setting-up-tags/#tags-file",
               "pattern": "\\.md$",
               "default": "tags.md"
+            },
+            "tags_extra_files": {
+              "title": "Markdown files to render additional tags indexes",
+              "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/setting-up-tags/#tags-extra-files",
+              "type": "object",
+              "patternProperties": {
+                "\\.md$": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              },
+              "additionalProperties": false
             }
           },
           "additionalProperties": false

docs/setup/setting-up-tags.md

@@ -48,7 +48,46 @@ The following configuration options are available:
     of `mkdocs.yml`. Note, however, that this options is not required – only use
     it if you want a tags index page.
 
+`tags_extra_files`{ #tags-extra-files } :material-alert-decagram:{ .mdx-pulse title="Added on July 7, 2022" }
+
+:   [:octicons-tag-24: insiders-4.20.0][Insiders] · :octicons-milestone-24: 
+    Default: _none_ – This option allows to define additional pages to render
+    subsets of the [tags index], in order to provide scoped tags indexes for
+    specific sections:
+
+    ``` yaml
+    plugins:
+      - tags:
+          tags_extra_files:
+            compatibility.md:
+              - compat #(1)!
+            web.md:
+              - html
+              - js
+              - css
+    ```
+
+    1.  Each page can be assigned a list of [tag identifiers], which must be
+        defined as part of `extra.tags` in `mkdocs.yml`:
+
+        ``` yaml
+        extra:
+          tags:
+            Compatibility: compat
+            HTML5: html
+            JavaScript: js
+            CSS: css
+        ```
+
+        In this example, all pages with the tag `Compatibility` will be included 
+        in the additional tags index on `compatibility.md`, all pages defining
+        at least one of the tags `HTML5`, `JavaScript` or `CSS` will be included
+        in the additional tags index on `web.md`.
+
+    See #3864 for additional use cases.
+
   [tags support]: https://github.com/squidfunk/mkdocs-material/releases/tag/8.2.0
+  [tag identifiers]: #tag-icons
 
 ### Tag icons