Prepare 9.2.0 release

squidfunk · squidfunk · commit d1ffeb22eba9 · 2023-08-21T19:18:59.000+02:00
diff --git a/CHANGELOG b/CHANGELOG
@@ -1,3 +1,52 @@
+mkdocs-material-9.2.0 (2023-08-21)
+
+  Additions and improvements
+
+  * Added blogging support via built-in blog plugin
+  * Added support for Chinese language segmentaiton in search plugin
+  * Added support for adding custom dates to blog posts
+  * Added support for paginating archive and category pages
+  * Added support for annotations (outside of code blocks)
+  * Added support for navigation icons
+  * Added support for navigation pruning
+  * Added support for navigation status
+  * Added support for customizing site icons
+  * Added support for customizing (code) annotation icons
+  * Added focus outline to admonitions and details
+  * Added prompt for bug report name to info plugin
+  * Added Luxembourgish translations
+  * Improved rendering of (code) annotation markers
+  * Improved print styles for (code) annotations
+  * Improved customizability of navigation tabs
+  * Improved interop of plugins with external tools like mike
+  * Improved interop of blog plugin with awesome pages plugin
+  * Improved header partial by moving buttons into separate partials
+  * Improved clarity of site_url warning in social plugin
+  * Improved blog plugin to automatically setup directory structure
+  * Switched info plugin to importlib to mitigate deprecations
+  * Automatically download ResizeObserver polyfill when necessary
+  * Automatically add iframe-worker polyfill when necessary in offline plugin
+  * Automatically focus and bring up keyboard on touch devices
+  * Updated Serbo-Croatian translations
+  * Updated MkDocs to 1.5.2
+
+  Removals
+
+  * Removed Universal Analytics integration
+  * Removed ancient polyfills to reduce size of bundled JavaScript by 20%
+  * Removed necessity for Array.flat and Array.flatMap polyfill
+  * Removed announcement bar button when JavaScript is not available
+
+  Fixes
+
+  * Fixed rendering of tags when announcement bar is present
+  * Fixed tags plugin rendering pages excluded by other plugins
+  * Fixed #5132: Blog plugin requires nav entry in mkdocs.yml
+  * Fixed #5599: Insufficient contrast for default link color
+  * Fixed #5715: Blog plugin missing integrated table of contents in pagination
+  * Fixed #5806: Version selector not hoverable on some Android devices
+  * Fixed #5826: Blog post drafts with tags show up in tags index
+
 mkdocs-material-9.1.21+insiders-4.39.0 (2023-08-01)
 
   * Added support for hoisting theme media files when building projects
diff --git a/docs/changelog/index.md b/docs/changelog/index.md
@@ -4,26 +4,52 @@
 
 ### 9.2.0 <small>July 6, 2023</small> { id="9.2.0" }
 
+__Additions and improvements__
+
 - Added blogging support via built-in blog plugin
-- Added Chinese language support to built-in search plugin
+- Added support for Chinese language segmentaiton in search plugin
+- Added support for adding custom dates to blog posts
+- Added support for paginating archive and category pages
 - Added support for annotations (outside of code blocks)
 - Added support for navigation icons
 - Added support for navigation pruning
 - Added support for navigation status
 - Added support for customizing site icons
 - Added support for customizing (code) annotation icons
 - Added focus outline to admonitions and details
+- Added prompt for bug report name to info plugin
+- Added Luxembourgish translations
 - Improved rendering of (code) annotation markers
 - Improved print styles for (code) annotations
 - Improved customizability of navigation tabs
-- Improved plugin inter-op with external tools like mike
+- Improved interop of plugins with external tools like mike
+- Improved interop of blog plugin with awesome pages plugin
+- Improved header partial by moving buttons into separate partials
+- Improved clarity of `site_url` warning in social plugin
+- Improved blog plugin to automatically setup directory structure
+- Switched info plugin to `importlib` to mitigate deprecations 
+- Automatically download ResizeObserver polyfill when necessary
+- Automatically add iframe-worker polyfill when necessary in offline plugin
+- Automatically focus and bring up keyboard on touch devices
+- Updated Serbo-Croatian translations
+- Updated MkDocs to 1.5.2
+
+__Removals__
+
 - Removed Universal Analytics integration
 - Removed ancient polyfills to reduce size of bundled JavaScript by 20%
 - Removed necessity for `Array.flat` and `Array.flatMap` polyfill
 - Removed announcement bar button when JavaScript is not available
-- Automatically download ResizeObserver polyfill when necessary
-- Updated MkDocs to 1.5.0
+
+__Fixes__
+
 - Fixed rendering of tags when announcement bar is present
+- Fixed tags plugin rendering pages excluded by other plugins
+- Fixed #5132: Blog plugin requires `nav` entry in `mkdocs.yml`
+- Fixed #5599: Insufficient contrast for default link color
+- Fixed #5715: Blog plugin missing integrated table of contents in pagination
+- Fixed #5806: Version selector not hoverable on some Android devices
+- Fixed #5826: Blog post drafts with tags show up in tags index
 
 ### 9.1.21 <small>July 27, 2023</small> { id="9.1.20" }
 
diff --git a/docs/setup/setting-up-a-blog.md b/docs/setup/setting-up-a-blog.md
@@ -1021,8 +1021,22 @@ categories:
     output. [This behavior can be changed], e.g. for rendering drafts when 
     building deploy previews.
 
-2.  You can use `date_updated` to signal when you updated a blog posts. The
-    date will be rendered as part of the sidebar.
+2.  If you wish to provide multiple dates, you can use the following syntax,
+    allowing you to define a date when you last updated the blog post +
+    further custom dates you can add to the template:
+
+    ``` yaml
+    ---
+    date:
+      created: 2022-01-31
+      updated: 2022-02-02
+    ---
+
+    # Hello world!
+    ```
+
+    Note that the creation date __must__ be set under `date.created`, as each
+    blog post must have a creation date set.
 
 When you spin up the [live preview server], you should be greeted by your first
 post! You'll also realize, that [archive] and [category] indexes have been
diff --git a/material/assets/stylesheets/main.cad15034.min.css b/material/assets/stylesheets/main.cad15034.min.css
diff --git a/material/assets/stylesheets/main.cad15034.min.css.map b/material/assets/stylesheets/main.cad15034.min.css.map
diff --git a/material/base.html b/material/base.html
@@ -32,7 +32,7 @@
         <link rel="alternate" type="application/rss+xml" title="{{ lang.t('rss.updated') }}" href="{{ 'feed_rss_updated.xml' | url }}">
       {% endif %}
       <link rel="icon" href="{{ config.theme.favicon | url }}">
-      <meta name="generator" content="mkdocs-{{ mkdocs_version }}, mkdocs-material-9.2.0-b3">
+      <meta name="generator" content="mkdocs-{{ mkdocs_version }}, mkdocs-material-9.2.0">
     {% endblock %}
     {% block htmltitle %}
       {% if page.meta and page.meta.title %}
@@ -44,7 +44,7 @@
       {% endif %}
     {% endblock %}
     {% block styles %}
-      <link rel="stylesheet" href="{{ 'assets/stylesheets/main.cad15034.min.css' | url }}">
+      <link rel="stylesheet" href="{{ 'assets/stylesheets/main.0e669242.min.css' | url }}">
       {% if config.theme.palette %}
         {% set palette = config.theme.palette %}
         <link rel="stylesheet" href="{{ 'assets/stylesheets/palette.85d0ee34.min.css' | url }}">
diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "mkdocs-material",
-  "version": "9.2.0-b3",
+  "version": "9.2.0",
   "description": "Documentation that simply works",
   "keywords": [
     "mkdocs",
diff --git a/requirements.txt b/requirements.txt
@@ -21,7 +21,7 @@
 # Requirements for core
 jinja2>=3.0
 markdown>=3.2
-mkdocs>=1.5.1
+mkdocs>=1.5.2
 mkdocs-material-extensions>=1.1
 pygments>=2.14
 pymdown-extensions>=9.9.1

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "mkdocs-material",`
`3`		`- "version": "9.2.0-b3",`
	`3`	`+ "version": "9.2.0",`
`4`	`4`	`"description": "Documentation that simply works",`
`5`	`5`	`"keywords": [`
`6`	`6`	`"mkdocs",`