Update output sample of mkdocs material.

Author: orzih

samples/mkdocs-material/README.md

@@ -7,7 +7,7 @@
 |            |                                               |
 | ---------: | --------------------------------------------- |
 | Repository | https://github.com/squidfunk/mkdocs-material/ |
-| Commit     | 175498da779810933e68527ae801598cd2492292      |
+| Commit     | 81944ae1a1c3de0b37691c6dc3a0bc70fe4980b9      |
 
 - use Original
   - .browserslistrc
@@ -27,16 +27,17 @@ INFO    -  Building documentation to directory: /tmp/mkdocs-with-pdf/samples/mkd
 WARNING -  Missing article: [Home]()
 INFO    -  Number headings up to level 3.
 INFO    -  Generate a table of contents up to heading level 2.
-INFO    -  Generate a cover page.
+INFO    -  Generate a cover page with "default_cover.html.j2".
+INFO    -  Generate a back cover page with "default_back_cover.html.j2".
 INFO    -  Converting <img> alignment(workaround).
 INFO    -  Converting <iframe> to poster image(if available).
 INFO    -  Converting for two-column layout(heading level 3).
 INFO    -  Rendering on `Headless Chrome`(execute JS).
 INFO    -  Rendering for PDF.
 INFO    -  Output a PDF to "/tmp/mkdocs-with-pdf/samples/mkdocs-material/site/../document.pdf".
 ERROR   -  No anchor #.: for internal URI reference
-INFO    -  Converting 37 articles to PDF took 268.5s
-INFO    -  Documentation built in 271.76 seconds
+INFO    -  Converting 38 articles to PDF took 272.3s
+INFO    -  Documentation built in 275.89 seconds
 ```
 
 ## TODO

samples/mkdocs-material/docs/assets/screenshots/navigation-sections.png

@@ -6,6 +6,11 @@ template: overrides/main.html
 
 ## Material for MkDocs Insiders
 
+### 1.8.0 <small>_ November 1, 2020</small>
+
+* Added support for navigation sections
+* Fixed appearance of inactive search suggestions
+
 ### 1.7.0 <small>_ October 25, 2020</small>
 
 * Added support for deploying multiple versions
@@ -53,6 +58,14 @@ template: overrides/main.html
 
 ## Material for MkDocs
 
+### 6.1.2 <small>_ October 31, 2020</small>
+
+* Fixed sizing of icons in Admonition, Tasklist, etc. (6.1.1 regression)
+
+### 6.1.1 <small>_ October 31, 2020</small>
+
+* Fixed #2019: Page title not correctly updated when using instant loading
+
 ### 6.1.0 <small>_ October 17, 2020</small>
 
 * Fixed #1973: Added support for printing in dark mode

samples/mkdocs-material/docs/changelog.md

@@ -65,26 +65,28 @@ for MkDocs Insiders. You can click on each feature to learn more about it:
 - [x] [Search suggestions help to save keystrokes][14]
 - [x] [Highlighting of matched search terms in content area][15]
 - [x] Search goes to first result on ++enter++ (I'm feeling lucky)
-- [x] [Navigation can always be expanded via configuration][16]
-- [x] [Header can be automatically hidden on scrolling][17]
-- [x] [Table of contents can be automatically hidden when empty][18]
+- [x] [Navigation can be grouped into sections][16]
+- [x] [Navigation can always be expanded via configuration][17]
+- [x] [Header can be automatically hidden on scrolling][18]
+- [x] [Table of contents can be automatically hidden when empty][19]
 
   [11]: setup/setting-up-the-footer.md#remove-generator
   [12]: setup/changing-the-colors.md#color-palette-toggle
   [13]: setup/setting-up-versioning.md#versioning
   [14]: setup/setting-up-site-search.md#search-suggestions
   [15]: setup/setting-up-site-search.md#search-highlighting
-  [16]: setup/setting-up-navigation.md#navigation-expansion
-  [17]: setup/setting-up-the-header.md#automatic-hiding
-  [18]: setup/setting-up-navigation.md#automatic-hiding
+  [16]: setup/setting-up-navigation.md#navigation-sections
+  [17]: setup/setting-up-navigation.md#navigation-expansion
+  [18]: setup/setting-up-the-header.md#automatic-hiding
+  [19]: setup/setting-up-navigation.md#automatic-hiding
 
 ## Roadmap
 
 The following list of funding goals – named after varieties of chili peppers 
-[I'm growing on my balcony][19] – shows which features are already available
+[I'm growing on my balcony][20] – shows which features are already available
 in Material for MkDocs Insiders.
 
-  [19]: https://www.instagram.com/squidfunk/
+  [20]: https://www.instagram.com/squidfunk/
 
 ### Madame Jeanette
 
@@ -100,9 +102,10 @@ in Material for MkDocs Insiders.
 [:octicons-flame-24: Funding goal: __$1,000__][6] ·
 :octicons-lock-24: Status: _exclusive_
 
-- [x] [Navigation can always be expanded via configuration][16]
-- [x] [Header can be automatically hidden on scrolling][17]
-- [x] [Table of contents can be automatically hidden when empty][18]
+- [x] [Navigation can be grouped into sections][16]
+- [x] [Navigation can always be expanded via configuration][17]
+- [x] [Header can be automatically hidden on scrolling][18]
+- [x] [Table of contents can be automatically hidden when empty][19]
 - [ ] Table of contents can be moved into navigation for more space
 - [ ] Better support for wide screens, i.e. more horizontal space
 
@@ -156,10 +159,10 @@ improvements (e.g. search) do not require any changes to existing configuration.
 This means that your users will be able to build the docs locally with the
 regular version and when they push their changes to CI/CD, they will be built
 with Material for MkDocs Insiders. For this reason, it's recommended to
-[install Insiders][20] only in CI, as you don't want to expose your `GH_TOKEN`
+[install Insiders][21] only in CI, as you don't want to expose your `GH_TOKEN`
 to users.
 
-  [20]: publishing-your-site.md#github-pages
+  [21]: publishing-your-site.md#github-pages
 
 ### Terms
 
@@ -169,7 +172,7 @@ terms?_
 
 Yes. Whether you're an individual or a company, you may use _Material for MkDocs
 Insiders_ precisely under the same terms as Material for MkDocs, which are given
-by the [MIT license][21]. However, we kindly ask you to respect the following
+by the [MIT license][22]. However, we kindly ask you to respect the following
 guidelines:
 
 - Please __don't distribute the source code__ from Material for MkDocs Insiders.
@@ -180,7 +183,7 @@ guidelines:
 - If you cancel your subscription, you're removed as a collaborator and will
   miss out on future updates of Material for MkDocs Insiders. However, you may
   __use the latest version__ that's available to you __as long as you like__.
-  Just remember that __[GitHub deletes private forks][22]__.
+  Just remember that __[GitHub deletes private forks][23]__.
 
-  [21]: license.md
-  [22]: https://docs.github.com/en/github/setting-up-and-managing-your-github-user-account/removing-a-collaborator-from-a-personal-repository
+  [22]: license.md
+  [23]: https://docs.github.com/en/github/setting-up-and-managing-your-github-user-account/removing-a-collaborator-from-a-personal-repository

samples/mkdocs-material/docs/insiders.md

@@ -88,12 +88,70 @@ _Result_:
 
 The unit price is 12.50.
 
+### Using variables in snippets
+
+You may want to use variables in snippets, for example, when describing the same
+procedure in multiple contexts where only one piece of information differs. This
+does not work with snippets that are included using the [Snippets][2] extension.
+Instead, you can use the [macros][3] plugin for defining snippets.
+
+To this end, add the snippet location using the `include_dir` parameter to the 
+plugin's configuration in `mkdocs.yml`, for example:
+
+``` yaml
+plugins:
+  - search
+  - macros:
+      include_dir: snippets
+```
+
+In your Markdown file, you can include snippets with Jinja's [`include`][4]
+function:
+
+``` markdown
+{% include "definitions.md" %}
+```
+
+This example illustrates the behavior:
+
+=== "snippets/definitions.md"
+
+    ``` markdown
+    The unit price is {{ page.meta.unit.price }}
+    ```
+
+=== "docs/page-1.md"
+
+    ``` markdown
+    ---
+    unit:
+      price: 12.50
+    ---
+
+    {% include "definitions.md" %}
+    ```
+
+=== "docs/page-2.md"
+
+    ``` markdown
+    ---
+    unit:
+      price: 25.00
+    ---
+
+    {% include "definitions.md" %}
+    ```
+
+  [2]: https://facelessuser.github.io/pymdown-extensions/extensions/snippets/
+  [3]: #macros
+  [4]: https://jinja.palletsprojects.com/en/2.11.x/templates/#include
+
 ## Customization
 
 ### Custom macros
 
 The [macros][1] plugin allows to define custom macros, which can then be used
-from Markdown files. See the [official documentation][2] for more information
+from Markdown files. See the [official documentation][5] for more information
 how to define custom macros.
 
-  [2]: https://mkdocs-macros-plugin.readthedocs.io/en/latest/python/
+  [5]: https://mkdocs-macros-plugin.readthedocs.io/en/latest/python/