Merge branch 'master' into docs/simplify-overrides

Author: squidfunk

docs/insiders/index.md

@@ -88,7 +88,7 @@ which are currently exclusively available to sponsors:
 
 - [x] [Privacy plugin: external links] :material-alert-decagram:{ .mdx-pulse title="Added on October 18, 2022" }
 - [x] [Navigation subtitles] :material-alert-decagram:{ .mdx-pulse title="Added on October 2, 2022" }
-- [x] [Tags plugin: allow list] :material-alert-decagram:{ .mdx-pulse title="Added on October 2, 2022" }
+- [x] [Tags plugin: allow list] and [custom sorting] :material-alert-decagram:{ .mdx-pulse title="Added on October 2, 2022" }
 - [x] [Blog plugin: custom index pages]
 - [x] [Blog plugin: related links]
 - [x] [Blog plugin]
@@ -295,14 +295,15 @@ are released for general availability.
 - [x] [Blog plugin: related links]
 - [x] [Blog plugin: custom index pages]
 - [x] [Tags plugin: additional indexes]
-- [x] [Tags plugin: allow list]
+- [x] [Tags plugin: allow list] and [custom sorting]
 - [x] [Navigation subtitles]
 
   [Meta plugin]: ../reference/index.md#built-in-meta-plugin
   [Blog plugin: related links]: ../setup/setting-up-a-blog.md#adding-related-links
   [Blog plugin: custom index pages]: ../setup/setting-up-a-blog.md#custom-index-pages
   [Tags plugin: additional indexes]: ../setup/setting-up-tags.md#+tags.tags_extra_files
   [Tags plugin: allow list]: ../setup/setting-up-tags.md#+tags.tags_allowed
+  [custom sorting]: ../setup/setting-up-tags.md#+tags.tags_compare
   [Navigation subtitles]: ../reference/index.md#setting-the-page-subtitle
 
 #### $ 20,000 – Jalapeño

docs/schema/assets/icons.json

@@ -9131,7 +9131,9 @@
     "octicons/arrow-both-24",
     "octicons/arrow-down-16",
     "octicons/arrow-down-24",
+    "octicons/arrow-down-left-16",
     "octicons/arrow-down-left-24",
+    "octicons/arrow-down-right-16",
     "octicons/arrow-down-right-24",
     "octicons/arrow-left-16",
     "octicons/arrow-left-24",
@@ -9141,7 +9143,9 @@
     "octicons/arrow-switch-24",
     "octicons/arrow-up-16",
     "octicons/arrow-up-24",
+    "octicons/arrow-up-left-16",
     "octicons/arrow-up-left-24",
+    "octicons/arrow-up-right-16",
     "octicons/arrow-up-right-24",
     "octicons/beaker-16",
     "octicons/beaker-24",
@@ -9386,6 +9390,10 @@
     "octicons/issue-opened-24",
     "octicons/issue-reopened-16",
     "octicons/issue-reopened-24",
+    "octicons/issue-tracked-by-16",
+    "octicons/issue-tracked-by-24",
+    "octicons/issue-tracked-in-16",
+    "octicons/issue-tracked-in-24",
     "octicons/italic-16",
     "octicons/italic-24",
     "octicons/iterations-16",
@@ -9875,6 +9883,7 @@
     "simple/backblaze",
     "simple/backbonedotjs",
     "simple/backendless",
+    "simple/backstage",
     "simple/badgr",
     "simple/badoo",
     "simple/baidu",
@@ -10242,6 +10251,7 @@
     "simple/dynamics365",
     "simple/dynatrace",
     "simple/e",
+    "simple/e3",
     "simple/ea",
     "simple/eagle",
     "simple/easyjet",
@@ -10269,6 +10279,7 @@
     "simple/elementary",
     "simple/elementor",
     "simple/eleventy",
+    "simple/elgato",
     "simple/elixir",
     "simple/eljueves",
     "simple/ello",
@@ -10612,6 +10623,7 @@
     "simple/ibm",
     "simple/ibmcloud",
     "simple/ibmwatson",
+    "simple/iced",
     "simple/iceland",
     "simple/icinga",
     "simple/icloud",
@@ -10979,6 +10991,7 @@
     "simple/moscowmetro",
     "simple/motorola",
     "simple/mozilla",
+    "simple/mqtt",
     "simple/msi",
     "simple/msibusiness",
     "simple/mta",
@@ -11345,6 +11358,7 @@
     "simple/rarible",
     "simple/rasa",
     "simple/raspberrypi",
+    "simple/ravelry",
     "simple/ray",
     "simple/razer",
     "simple/razorpay",
@@ -11606,6 +11620,7 @@
     "simple/stackshare",
     "simple/stadia",
     "simple/staffbase",
+    "simple/standardjs",
     "simple/starbucks",
     "simple/stardock",
     "simple/starlingbank",

docs/setup/setting-up-tags.md

@@ -132,6 +132,34 @@ The following configuration options are available:
           tags_slugify_separator: "-"
     ```
 
+[`tags_compare`](#+tags.tags_compare){ #+tags.tags_compare }
+
+:   [:octicons-tag-24: insiders-4.26.2][Insiders] · :octicons-milestone-24:
+    Default: `None` – This option specifies which function to use when
+    comparing tag values for sorting. If you wish to compare tags irregardless
+    of casing, use:
+
+    ``` yaml
+    plugins:
+      - tags:
+          tags_compare: !!python/name:material.plugins.tags.plugin.casefold
+    ```
+
+    You can also define your own comparison function which must return a tag
+    value (as a string) that is used for sorting, and reference it accordingly.
+
+[`tags_compare_reverse`](#+tags.tags_compare_reverse){ #+tags.tags_compare_reverse }
+
+:   [:octicons-tag-24: insiders-4.26.2][Insiders] · :octicons-milestone-24:
+    Default: `false` – This option specifies whether tags are sorted in reverse
+    order. It is mainly provided for completeness. To change direction, use:
+
+    ``` yaml
+    plugins:
+      - tags:
+          tags_compare_reverse: true
+    ```
+
 [`tags_allowed`](#+tags.tags_allowed){ #+tags.tags_allowed } :material-alert-decagram:{ .mdx-pulse title="Added on October 2, 2022" }
 
 :   [:octicons-tag-24: insiders-4.25.0][Insiders] · :octicons-milestone-24: