Merge branch 'master' into update-to-mermaid-10.6.0

Author: squidfunk

.github/assets/sponsors/sponsor-trendpop.png

@@ -1,3 +1,46 @@
+mkdocs-material-9.4.12+insiders-4.45.0 (2023-11-24)
+
+  * Added support for sorting blog categories by post count or custom function
+  * Improved tags plugin to generate Unicode-aware slugs by default
+  * Fixed non-deterministic order of multiple authors in blog plugin
+
+mkdocs-material-9.4.12 (2023-11-24)
+
+  * Improved blog plugin to generate Unicode-aware slugs by default
+  * Fixed non-deterministic order of categories in blog plugin
+
+mkdocs-material-9.4.11+insiders-4.44.0 (2023-11-23)
+
+  * Added pagination settings for archive pages in blog plugin
+  * Added pagination settings for category pages in blog plugin
+
+mkdocs-material-9.4.11 (2023-11-23)
+
+  * Fixed #6364: Search plugin crashing when enabling theme while serving
+  * Fixed blog plugin crashing when disabling pagination
+
+mkdocs-material-9.4.10+insiders-4.43.1 (2023-11-19)
+
+  * Added third-party theme support in projects plugin, improving editing
+  * Fixed #6360: Projects plugin crashes when theme is not Material for MkDocs
+  * Fixed #6306: Projects plugin not reloading nested project configuration
+
+mkdocs-material-9.4.10 (2023-11-19)
+
+  * Fixed #6356: Version selector can't be disabled via mike's configuration
+  * Fixed #6281: Navigation not rendering due to Safari bug (9.4.2 regression)
+  * Fixed #6261: Navigation expansion animates on first load (9.4.2 regression)
+
+mkdocs-material-9.4.9 (2023-11-17)
+
+  * Fixed #6344: Long entries cutoff in table of contents
+  * Fixed #6336: Custom template for glob archive not working with pagination
+  * Fixed #6328: Blog plugin crashes for locales with dashes, e.g. pt-BR
+  * Fixed #6327: Copy-to-clipboard button doesn't trim trailing line feed
+  * Fixed #6302: Version strings not matched when using mike, only aliases
+  * Fixed instant navigation progress indicator for gzipped content in Chrome
+  * Fixed rendering bug on details marker rotation in Firefox
+
 mkdocs-material-9.4.8+insiders-4.43.0 (2023-11-05)
 
   * Added support for GitLab committers (document contributors)

CHANGELOG

@@ -58,6 +58,9 @@
   <a href="https://fastapi.tiangolo.com/" target=_blank><img
     src="https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-fastapi.png" height="120"
   /></a>
+  <a href="https://www.trendpop.com/" target=_blank><img
+    src="https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-trendpop.png" height="120"
+  /></a>
 </p>
 <p>&nbsp;</p>
 <p align="center"><strong>Bronze sponsors</strong></p>

README.md

@@ -2,6 +2,32 @@
 
 ## Material for MkDocs
 
+### 9.4.12 <small>November 24, 2023</small> { id="9.4.12" }
+
+- Improved blog plugin to generate Unicode-aware slugs by default
+- Fixed non-deterministic order of categories in blog plugin
+
+### 9.4.11 <small>November 23, 2023</small> { id="9.4.11" }
+
+- Fixed #6364: Search plugin crashing when enabling theme while serving
+- Fixed blog plugin crashing when disabling pagination
+
+### 9.4.10 <small>November 19, 2023</small> { id="9.4.10" }
+
+- Fixed #6356: Version selector can't be disabled via mike's configuration
+- Fixed #6281: Navigation not rendering due to Safari bug (9.4.2 regression)
+- Fixed #6261: Navigation expansion animates on first load (9.4.2 regression)
+
+### 9.4.9 <small>November 17, 2023</small> { id="9.4.9" }
+
+- Fixed #6344: Long entries cutoff in table of contents
+- Fixed #6336: Custom template for glob archive not working with pagination
+- Fixed #6328: Blog plugin crashes for locales with dashes, e.g. `pt-BR`
+- Fixed #6327: Copy-to-clipboard button doesn't trim trailing line feed
+- Fixed #6302: Version strings not matched when using mike, only aliases
+- Fixed instant navigation progress indicator for gzipped content in Chrome
+- Fixed rendering bug on details marker rotation in Firefox
+
 ### 9.4.8 <small>November 5, 2023</small> { id="9.4.8" }
 
 - Fixed invalid local address replacement when using instant loading

docs/changelog/index.md

@@ -33,7 +33,7 @@ explicitly define them. The default value of the property is always included.
 
 #### <!-- md:default computed --> – Default value is computed { #default data-toc-label="is computed" }
 
-Some default values are not set to static values but computed form other values,
+Some default values are not set to static values but computed from other values,
 like the site language, repository provider, or other settings.
 
 #### <!-- md:default none --> – Default value is empty { #default data-toc-label="is empty" }

docs/conventions.md

@@ -66,6 +66,7 @@ theme:
               "yaml.customTags": [ // (1)!
                 "!ENV scalar",
                 "!ENV sequence",
+                "!relative scalar",
                 "tag:yaml.org,2002:python/name:material.extensions.emoji.to_svg",
                 "tag:yaml.org,2002:python/name:material.extensions.emoji.twemoji",
                 "tag:yaml.org,2002:python/name:pymdownx.superfences.fence_code_format"

docs/creating-your-site.md

@@ -1,5 +1,32 @@
 ---
-template: redirect.html
-location: https://calendly.com/squidfunk/enterprise
 status: new
 ---
+
+# Enterprise Feedback
+
+We highly value the insights of our enterprise users, and we're eager to hear
+from you. Your feedback is immensely valuable to us. If you're utilizing
+Material for MkDocs in an enterprise context and would like to share your
+experiences with us, we'd love to connect and discuss:
+
+- What you are building with it
+- What aspects you like about it
+- What challenges you are facing
+- What could be improved
+
+## Let's Connect
+
+To schedule a convenient appointment, please reach out to us via email at
+[email protected] and provide us with the following details:
+
+- Your company's name
+- How you are using Material for MkDocs
+- Any specific questions or topics you'd like to address
+
+Once we have this information, we'll promptly get in touch with you to arrange
+a 30-minute call. Please note that this call is exclusively intended for
+enterprise users and is not meant for technical support. Instead, it's an
+opportunity for us to engage in a casual conversation to better understand your
+unique needs.
+
+We look forward to our discussion!

docs/enterprise-support.md

@@ -2,6 +2,23 @@
 
 ## Material for MkDocs Insiders
 
+### 4.45.0 <small>November 24, 2023</small> { id="4.45.0" }
+
+- Added support for sorting blog categories by post count or custom function
+- Improved tags plugin to generate Unicode-aware slugs by default
+- Fixed non-deterministic order of multiple authors in blog plugin
+
+### 4.44.0 <small>November 23, 2023</small> { id="4.44.0" }
+
+- Added pagination settings for archive pages in blog plugin
+- Added pagination settings for category pages in blog plugin
+
+### 4.43.1 <small>November 19, 2023</small> { id="4.43.1" }
+
+- Added third-party theme support in projects plugin, improving editing
+- Fixed #6360: Projects plugin crashes when theme is not Material for MkDocs
+- Fixed #6306: Projects plugin not reloading nested project configuration
+
 ### 4.43.0 <small>November 5, 2023</small> { id="4.43.0" }
 
 - Added support for GitLab committers (document contributors)

docs/insiders/changelog/index.md

@@ -0,0 +1,148 @@
+---
+title: Community Experts Program
+status: new
+---
+
+# Calling for Community Experts
+
+Interested in joining the Material for MkDocs team as a Community Expert?
+We're on the lookout for individuals who are passionate about supporting our
+awesome community. In return for your valuable contributions, time, and
+insights, __you'll gain free access to the Insiders edition__.
+
+## Why we need you
+
+As our project and community continue to grow, so do the questions and needs of
+our users on our discussion board. Our discussion board is a vital part of our
+project, serving as a hub for our community to connect and a valuable knowledge
+base to complement our documentation.
+
+We're eager to keeping it well-maintained, organized, easy to search and address
+all queries which is why we need extra hands to keep up with the demand.
+
+That's why we're bulding a team of Community Experts!
+
+## Your role
+
+As a Community Expert, your role primarily involves active participation on
+our [discussion board], where we'd expect you to be:
+
+- Answering discussions to help users with their questions
+- Providing guidance regarding implementations
+- Sharing insights into customizations and workarounds
+- Optimizing searchability by adjusting discussion titles with relevant keywords
+
+## Your benefits
+
+Here is a list of the benefits we offer to our Community Experts:
+
+-   __Free access to Material for MkDocs Insiders__ – Exclusive Access to all of
+    our Material for MkDocs Insiders features for _non-commercial use_.[^1]
+
+-   __Close communication with the team__ – Stay connected with us through various
+    channels, including calls and internal project management tools.
+
+-   __GitHub profile boost__ – Enhance your GitHub profile's visibility and
+    credibility as your activity increases, earning you valuable badges that can
+    enhance your credibility.
+
+  [^1]:
+    Access to Insiders is granted to your primary account, i.e., the account
+    with which you're contributing to the project. It cannot be transferred to
+    another account. Additionally, it cannot be used for commercial purposes.
+
+## Your knowledge & skills
+
+To be a successful Community Expert, your skills should include the following:
+
+-   __Material and MkDocs allrounder__ – You have an understanding of Material
+    for MkDocs and the MkDocs ecosystem, including many of its extensions and
+    plugins.
+
+-   __Great communicator__ – You enjoy helping others in a productive,
+    constructive and friendly manner and use inclusive and welcoming language.
+
+-   __Independent worker__ – You are self-motivated, stay up-to-date with
+    project developments, regularly check the discussion board, and respond to
+    notifications in reasonable time.
+
+  [discussion board]: https://github.com/squidfunk/mkdocs-material/discussions
+  [documentation]: https://squidfunk.github.io/mkdocs-material/
+  [contribution guides]: ../contributing/index.md
+
+## Your time commitment
+
+We don't require a fixed number of hours each week; instead, we ask for a
+minimum of __five answered discussions per month[^2]__, which amounts to
+slightly more than one per week. Your active interaction within the community is
+highly valued.
+
+To do this effectively, it's best to regularly check the discussion board to see
+where you can offer help. The time you invest may vary depending on the
+complexity of the topics and questions.
+
+Upon joining, you'll receive access to the Insiders' edition for as long as you
+continue to assist us. Access will be renewed every three months, allowing you
+the flexibility to continue your contributions or take a break as needed.
+
+  [^2]:
+    An answered discussion is a collaborative interaction where knowledge and
+    expertise are shared, resulting in resolutions or clarifications that benefit
+    the user and our entire community. In essence, it embodies the spirit of
+    cooperation and support within our community, highlighting the power of
+    collective wisdom and the willingness to assist and uplift one another.
+
+## Ready to get started?
+
+Since we have a limited number of seats for these roles[^3], we would like to
+get to know you before you become one of our Community Experts. Here's how to
+get started:
+
+  [^3]:
+    Please note that we're currently limiting the number of seats on the
+    Community Experts program to three. We will update this page when we'll
+    expand the team, which is when we'll be accepting new applications.
+
+### Step 1: Get in touch
+
+Send us an email introducing yourself, sharing a bit about your background, and
+include a link to your GitHub profile. Additionally, provide links to three
+previous discussions you've answered on the discussion board, where you've
+assisted another community member.
+
+Please use the following email template to reach out to us at
+[email protected]:
+
+```
+Subject: Community Expert
+
+Intro: Tell us a bit about yourself.
+  - Name:
+  - Background:
+  - Profession:
+  - GitHub profile:
+
+Answered discussions
+  - Link 1:
+  - Link 2:
+  - Link 3:
+```
+
+### Step 2: Evaluation
+
+After receiving and reviewing your application, we will get in touch with you
+to discuss everything you need to know to get started. If you get selected, we
+will set you up as a collaborator and provide you immediate access to the
+Insiders edition for three months.
+
+### Step 3: Dive in
+
+Let's get started! You can actively begin participating in five discussions per
+month. We trust you to take the lead, and we won't do strict monitoring. Simply
+ensure that you are consistently listed on the _Most Helpful_ list, located on
+the discussion board's left side, under the categories.
+---
+
+__Ready to join us?__
+
+Sounds good? Let's give it a try!