Update to upstream release 8.2.6

* upstream/master: (205 commits)
  Restructured documentation
  Prepare 8.2.6 release
  Documentation (squidfunk#3760)
  Fixed syntax error on Insiders page
  Added RStudio to list of premium sponsors
  Added RStudio to list of premium sponsors
  Updated dependencies
  Documentation (squidfunk#3688)
  adding docs.mindsdb.com to the list
  Added origins in giscus.json to omit discussion spam
  Added origins in giscus.json to omit discussion spam
  Fixed code annotations not being mounted for long code blocks (8.2.5 regression)
  Fixed deprecation warnings for unescaped backslashes in Jinja templates
  Fixed problems with empty comment nodes generated by Terraform lexer
  Improved semantics when returning from switchMap
  Improved semantics when returning from switchMap
  Updated dependencies
  Bump actions/setup-python from 2.3.2 to 3
  Bump actions/checkout from 2 to 3
  Updated Insiders changelog
  ...

.browserslistrc

@@ -1 +1 @@
-last 2 years
+last 4 years

.dockerignore

@@ -1,4 +1,4 @@
-# Copyright (c) 2016-2021 Martin Donath <martin.donath@squidfunk.com>
+# Copyright (c) 2016-2022 Martin Donath <martin.donath@squidfunk.com>
 
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to

.editorconfig

@@ -1,4 +1,4 @@
-# Copyright (c) 2016-2021 Martin Donath <martin.donath@squidfunk.com>
+# Copyright (c) 2016-2022 Martin Donath <martin.donath@squidfunk.com>
 
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to

.eslintignore

@@ -1,4 +1,4 @@
-# Copyright (c) 2016-2021 Martin Donath <martin.donath@squidfunk.com>
+# Copyright (c) 2016-2022 Martin Donath <martin.donath@squidfunk.com>
 
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to

.github/FUNDING.yml

@@ -1,4 +1,4 @@
-# Copyright (c) 2016-2021 Martin Donath <martin.donath@squidfunk.com>
+# Copyright (c) 2016-2022 Martin Donath <martin.donath@squidfunk.com>
 
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to

.github/ISSUE_TEMPLATE/config.yml

@@ -1,4 +1,4 @@
-# Copyright (c) 2016-2021 Martin Donath <martin.donath@squidfunk.com>
+# Copyright (c) 2016-2022 Martin Donath <martin.donath@squidfunk.com>
 
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to

.github/dependabot.yml

@@ -1,4 +1,4 @@
-# Copyright (c) 2016-2021 Martin Donath <martin.donath@squidfunk.com>
+# Copyright (c) 2016-2022 Martin Donath <martin.donath@squidfunk.com>
 
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to

.github/workflows/build.yml

@@ -1,4 +1,4 @@
-# Copyright (c) 2016-2021 Martin Donath <martin.donath@squidfunk.com>
+# Copyright (c) 2016-2022 Martin Donath <martin.donath@squidfunk.com>
 
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to
@@ -33,10 +33,10 @@ jobs:
     steps:
 
       - name: Checkout repository
-        uses: actions/checkout@v2
+        uses: actions/checkout@v3
 
       - name: Set up Node.js runtime
-        uses: actions/setup-node@v2.5.0
+        uses: actions/setup-node@v3
         with:
           node-version: ${{ env.NODE_VERSION }}
 

.github/workflows/documentation.yml

@@ -1,4 +1,4 @@
-# Copyright (c) 2016-2021 Martin Donath <martin.donath@squidfunk.com>
+# Copyright (c) 2016-2022 Martin Donath <martin.donath@squidfunk.com>
 
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to
@@ -34,10 +34,10 @@ jobs:
     steps:
 
       - name: Checkout repository
-        uses: actions/checkout@v2
+        uses: actions/checkout@v3
 
       - name: Set up Python runtime
-        uses: actions/setup-python@v2.3.1
+        uses: actions/setup-python@v3
         with:
           python-version: ${{ env.PYTHON_VERSION }}
 

.github/workflows/publish.yml

@@ -1,4 +1,4 @@
-# Copyright (c) 2016-2021 Martin Donath <martin.donath@squidfunk.com>
+# Copyright (c) 2016-2022 Martin Donath <martin.donath@squidfunk.com>
 
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to
@@ -35,10 +35,10 @@ jobs:
     steps:
 
       - name: Checkout repository
-        uses: actions/checkout@v2
+        uses: actions/checkout@v3
 
       - name: Set up Python runtime
-        uses: actions/setup-python@v2.3.1
+        uses: actions/setup-python@v3
         with:
           python-version: ${{ env.PYTHON_VERSION }}
 
@@ -61,7 +61,7 @@ jobs:
     steps:
 
       - name: Checkout repository
-        uses: actions/checkout@v2
+        uses: actions/checkout@v3
 
       # - name: Set up QEMU
       #   uses: docker/setup-qemu-action@v1

.gitignore

@@ -1,4 +1,4 @@
-# Copyright (c) 2016-2021 Martin Donath <martin.donath@squidfunk.com>
+# Copyright (c) 2016-2022 Martin Donath <martin.donath@squidfunk.com>
 
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to

.stylelintignore

@@ -1,4 +1,4 @@
-# Copyright (c) 2016-2021 Martin Donath <martin.donath@squidfunk.com>
+# Copyright (c) 2016-2022 Martin Donath <martin.donath@squidfunk.com>
 
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to
@@ -24,4 +24,5 @@ material
 src/**/*.html
 
 # Prevent stylelint from constantly complaining
+*.css
 *.ts

.stylelintrc

@@ -58,6 +58,7 @@
     "declaration-no-important": true,
     "declaration-block-single-line-max-declarations": 0,
     "function-calc-no-unspaced-operator": null,
+    "function-no-unknown": null,
     "function-url-no-scheme-relative": true,
     "function-url-quotes": "always",
     "font-family-name-quotes": "always-where-recommended",

.vscode/settings.json

@@ -7,5 +7,15 @@
   },
   "search.followSymlinks": false,
   "stylelint.validate": ["css", "scss"],
-  "typescript.tsdk": "node_modules/typescript/lib"
+  "typescript.tsdk": "node_modules/typescript/lib",
+  "yaml.schemas": {
+    "docs/schema.json": "mkdocs.yml"
+  },
+  "yaml.customTags": [
+    "!ENV scalar",
+    "!ENV sequence",
+    "tag:yaml.org,2002:python/name:materialx.emoji.to_svg",
+    "tag:yaml.org,2002:python/name:materialx.emoji.twemoji",
+    "tag:yaml.org,2002:python/name:pymdownx.superfences.fence_code_format"
+  ]
 }

CHANGELOG

@@ -1,4 +1,159 @@
-mkdocs-material-8.1.3 (2012-12-19)
+mkdocs-material-8.2.6 (2022-03-23)
+
+  * Fixed #3695: Deprecation warning for unescaped backslashes in templates
+  * Fixed #3696: Annotations not mounted in some Terraform code blocks
+  * Fixed #3698: Annotations not mounted in long code blocks (8.2.5 regression)
+
+mkdocs-material-8.2.5+insiders-4.11.0 (2022-03-06)
+
+  * Added support for excluding external assets from privacy plugin
+
+mkdocs-material-8.2.5 (2022-03-06)
+
+  * Fixed #3596: Mermaid not working when headline with name 'Mermaid' present
+  * Fixed #3643: Reduce time to render pages with thousands of code blocks
+  * Fixed #3665: Missing styles for Mermaid.js flowcharts cluster labels
+
+mkdocs-material-8.2.4+insiders-4.10.1 (2022-03-02)
+
+  * Added missing build dependencies to Dockerfile
+  * Fixed encoding issues in privacy plugin, now forcing UTF-8 encoding
+  * Fixed #3624: Scroll to active navigation item unreliable in Firefox
+  * Fixed #3642: Privacy plugin errors when font setting was omitted
+
+mkdocs-material-8.2.4 (2022-03-02)
+
+  * Fixed malformed Google Fonts URL when a font setting was omitted
+  * Fixed #3648: Fixed specificity issue with admonitions in lists
+  * Fixed #3653: Invalid outdated version banner URL when using instant loading
+
+mkdocs-material-8.2.3+insiders-4.10.0 (2022-02-27)
+
+  * Added support for offline plugin (supersedes offline search support)
+  * Improved built-in privacy plugin to download nested JavaScript assets
+  * Refactored configuration of built-in privacy plugin
+
+mkdocs-material-8.2.3 (2022-02-27)
+
+  * Fixed #3578: Active element in table of contents off-by-one on large screens
+
+mkdocs-material-8.2.2 (2022-02-26)
+
+  * Added automatic removal of query parameter when search is closed
+  * Fixed #3599: Anchors always overriden when using navigation tracking
+
+mkdocs-material-8.2.1+insiders-4.9.1 (2022-02-21)
+
+  * Fixed #3610: missing lxml dependency for privacy plugin
+  * Fixed error when charset is missing in content-type header
+
+mkdocs-material-8.2.1+insiders-4.9.0 (2022-02-20)
+
+  * Added privacy plugin: automatic downloading of external assets
+
+mkdocs-material-8.2.1 (2022-02-17)
+
+  * Fixed module 'material.plugins' not being found (8.2.0 regression)
+
+mkdocs-material-8.2.0 (2022-02-17)
+
+  * Added native support for Mermaid.js diagrams
+  * Added native support for tags (with search integration)
+  * Added support for staying on page when switching versions
+
+mkdocs-material-8.1.11+insiders-4.8.3 (2022-02-13)
+
+  * Fixed #3560: Mermaid diagrams don't render for file:// locations
+
+mkdocs-material-8.1.11+insiders-4.8.2 (2022-02-10)
+
+  * Fixed #3559: Mermaid diagrams don't render inside closed details
+
+mkdocs-material-8.1.11 (2022-02-10)
+
+  * Added Portuguese (Brasilian) translations
+  * Updated FontAwesome to v6 (might lead to missing icons)
+  * Fixed #3545: Color palette toggle and search overlaying version selector
+
+mkdocs-material-8.1.10+insiders-4.8.1 (2022-02-06)
+
+  * Fixed jump back to top on mobile when using anchor following
+
+mkdocs-material-8.1.10+insiders-4.8.0 (2022-02-06)
+
+  * Added support for anchor following table of contents (= auto scroll)
+
+mkdocs-material-8.1.10 (2022-02-06)
+
+  * Fixed cutoff of very wide logos in the sidebar on mobile
+
+mkdocs-material-8.1.9+insiders-4.7.2 (2022-02-02)
+
+  * Fixed #3526: Transparent sidebar title due to Safari bug
+  * Fixed #3528: Firefox sometimes clips text in flow chart diagrams
+
+mkdocs-material-8.1.9+insiders-4.7.1 (2022-01-30)
+
+  * Fixed #3506: Tags index not respecting title set via front matter
+
+mkdocs-material-8.1.9 (2022-01-30)
+
+  * Added support for mkdocs.yml validation and auto-complete
+  * Fixed errors in Latvian translations
+
+mkdocs-material-8.1.8+insiders-4.7.0 (2022-01-25)
+
+  * Added native support for offline search
+
+mkdocs-material-8.1.8 (2022-01-23)
+
+  * Added Latvian translations
+  * Updated Giscus example integration with dynamic theme change support
+  * Fixed #3479: Back-to-top button not hidden when using sticky navigation tabs
+  * Fixed #3491: Logo in header and drawer doesn't honor aspect ratio
+
+mkdocs-material-8.1.7+insiders-4.6.1 (2022-01-16)
+
+  * Fixed #3459: Section index pages picking up wrong title
+
+mkdocs-material-8.1.7 (2022-01-16)
+
+  * Improved back-to-top button behavior - now not shown on anchor jump
+
+mkdocs-material-8.1.6-insiders-4.6.0 (2022-01-11)
+
+  * Added support for annotations (outside of code blocks)
+
+mkdocs-material-8.1.6 (2022-01-11)
+
+  * Fixed spacing of blockquotes (8.1.5 regression)
+  * Fixed edge cases for rounded corners on code blocks (8.1.5 regression)
+  * Fixed rendering issues with code annotation line heights
+
+mkdocs-material-8.1.5 (2022-01-09)
+
+  * Improved browser support: Chrome 49+, Safari 10+, Firefox 53+, Edge 79+
+  * Improved rendering of inline code blocks in headlines
+  * Added Bahasa Malaysian translations
+  * Fixed #3354: MathJax formulas show vertical scrollbar
+
+mkdocs-material-8.1.4+insiders-4.5.2 (2022-01-08)
+
+  * Fixed #3440: Content tab indicator not moving when using linking
+  * Fixed #3445: Content tab switch flickers/jitters when using linking
+
+mkdocs-material-8.1.4+insiders-4.5.1 (2022-01-02)
+
+  * Added support for setting initial state of cookie consent
+  * Fixed #3396: Disappearing link in navigation due to Safari bug
+
+mkdocs-material-8.1.4 (2022-01-02)
+
+  * Added indicator to navigation expander icon
+  * Improved support for reduced motion preference
+  * Fixed jitter of active content tab indicator
+
+mkdocs-material-8.1.3 (2021-12-19)
 
   * Added animation to active content tab indicator
   * Fixed #3360: Highlighted lines add blank lines in copied text
@@ -8,13 +163,13 @@ mkdocs-material-8.1.2+insiders-4.5.0 (2021-12-16)
 
   * Added support for navigation icons
 
-mkdocs-material-8.1.2 (2012-12-15)
+mkdocs-material-8.1.2 (2021-12-15)
 
   * Switched CSS sources to logical properties
   * Added transformation of logical properties to ltr/rtl equivalents
   * Fixed spacing for admonitions inside lists (8.1.1 regression)
 
-mkdocs-material-8.1.1 (2012-12-13)
+mkdocs-material-8.1.1 (2021-12-13)
 
   * Added support for #only-light and #only-dark image hash fragments
   * Fixed copy-to-clipboard adding blank lines when using line anchors
@@ -33,7 +188,7 @@ mkdocs-material-8.1.0+insiders-4.4.0 (2021-12-10)
   * Added new code annotation syntax modifier to strip comment
   * Updated German translations for cookie consent
 
-mkdocs-material-8.1.0 (2012-12-10)
+mkdocs-material-8.1.0 (2021-12-10)
 
   * Added basic support for code block line anchors
   * Switched code annotation markers to + signs to improve usability
@@ -43,7 +198,7 @@ mkdocs-material-8.1.0 (2012-12-10)
   * Improved and simplified code annotation positioning
   * Fixed syntax error in Russian translations
 
-mkdocs-material-8.0.5 (2012-12-04)
+mkdocs-material-8.0.5 (2021-12-04)
 
   * Fixed #3302: Footer refactoring induced ellipsis in some browsers
   * Fixed #3313: Details always rendered closed on load (8.0.4 regression)
@@ -53,7 +208,7 @@ mkdocs-material-8.0.4+insiders-4.3.0 (2021-12-05)
   * Added support for custom fonts in social cards
   * Fixed #3300: Announcement bar reappearing when using instant loading
 
-mkdocs-material-8.0.4 (2012-12-04)
+mkdocs-material-8.0.4 (2021-12-04)
 
   * Improved support for deeply nested code annotations
   * Improved code annotation and copy-to-clipboard interop
@@ -68,7 +223,7 @@ mkdocs-material-8.0.3+insiders-4.2.0 (2021-12-02)
   * Added support for dismissable announcement bar
   * Added support for named placeholders in feedback widget
 
-mkdocs-material-8.0.3 (2012-12-02)
+mkdocs-material-8.0.3 (2021-12-02)
 
   * Removed deprecated google_analytics setting (was forgotten in 8.0.0)
   * Fixed syntax error in Swedish and Polish translations

CONTRIBUTING.md

@@ -79,4 +79,4 @@ After your PR is merged, you can safely delete your branch and pull the changes
 from the main (upstream) repository.
 
   [development environment]: https://squidfunk.github.io/mkdocs-material/customization/#environment-setup
-  [build the theme]: https://squidfunk.github.io/mkdocs-material/customization/#build-process
+  [build the theme]: https://squidfunk.github.io/mkdocs-material/customization/#building-the-theme

Dockerfile

@@ -1,4 +1,4 @@
-# Copyright (c) 2016-2021 Martin Donath <martin.donath@squidfunk.com>
+# Copyright (c) 2016-2022 Martin Donath <martin.donath@squidfunk.com>
 
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to

LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2016-2021 Martin Donath <martin.donath@squidfunk.com>
+Copyright (c) 2016-2022 Martin Donath <martin.donath@squidfunk.com>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to