From 233252194fe4271ef46a2a9386b63d3606d3f7fa Mon Sep 17 00:00:00 2001
From: squidfunk <martin.donath@squidfunk.com>
Date: Sat, 13 Aug 2022 10:57:43 +0200
Subject: [PATCH] Removed all occurrences of the meta extension

---
 docs/reference/index.md                  | 28 ++++--------------
 docs/schema/extensions/markdown.json     |  8 ------
 docs/setup/extensions/index.md           |  4 ---
 docs/setup/extensions/python-markdown.md | 36 ------------------------
 docs/setup/setting-up-navigation.md      |  7 ++---
 docs/setup/setting-up-site-analytics.md  |  5 +---
 docs/setup/setting-up-site-search.md     | 11 ++++----
 docs/setup/setting-up-social-cards.md    |  5 ++--
 docs/setup/setting-up-tags.md            | 11 ++++----
 docs/setup/setting-up-the-footer.md      |  8 ++----
 mkdocs.yml                               |  1 -
 11 files changed, 24 insertions(+), 100 deletions(-)

diff --git a/docs/reference/index.md b/docs/reference/index.md
index 069d9e81d..dca050360 100644
--- a/docs/reference/index.md
+++ b/docs/reference/index.md
@@ -11,22 +11,6 @@ within Markdown files.
 
 ## Configuration
 
-This configuration allows to set a title and description for a page, change the
-template or define an icon to be rendered in the navigation. Add the following 
-lines to `mkdocs.yml`:
-
-``` yaml
-markdown_extensions:
-  - meta
-```
-
-See additional configuration options:
-
-- [Metadata]
-
-  [front matter]: https://jekyllrb.com/docs/front-matter/
-  [Metadata]: ../setup/extensions/python-markdown.md#metadata
-
 ### Built-in meta plugin :material-alert-decagram:{ .mdx-pulse title="Added on July 17, 2022" }
 
 [:octicons-heart-fill-24:{ .mdx-heart } Sponsors only][Insiders]{ .mdx-insiders } ·
@@ -70,8 +54,8 @@ The following configuration options are available:
 
 ### Setting the page title
 
-When [Metadata] is enabled, the page title can be overridden for a document with
-some custom front matter. Add the following lines at the top of a Markdown file:
+The page title can be overridden for a document with the front matter `title`
+property. Add the following lines at the top of a Markdown file:
 
 ``` sh
 ---
@@ -92,9 +76,8 @@ title: Lorem ipsum dolor sit amet # (1)!
 
 ### Setting the page description
 
-When [Metadata] is enabled, the page description can be overridden for a
-document with custom front matter. Add the following lines at the top of a
-Markdown file:
+The page description can be overridden for a document with the front matter
+`description` property. Add the following lines at the top of a Markdown file:
 
 ``` sh
 ---
@@ -115,8 +98,7 @@ description: Nullam urna elit, malesuada eget finibus ut, ac tortor. # (1)!
 :octicons-beaker-24: Experimental
 
 An icon can be assigned to each page, which is then rendered as part of the
-navigation sidebar. Ensure [Metadata] is enabled and add the following lines
-at the top of a Markdown file:
+navigation sidebar. Add the following lines at the top of a Markdown file:
 
 ``` sh
 ---
diff --git a/docs/schema/extensions/markdown.json b/docs/schema/extensions/markdown.json
index 7c081fecd..99563b0a6 100644
--- a/docs/schema/extensions/markdown.json
+++ b/docs/schema/extensions/markdown.json
@@ -43,14 +43,6 @@
         "footnotes"
       ]
     },
-    {
-      "title": "Metadata – Python Markdown",
-      "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/extensions/python-markdown/#metadata",
-      "enum": [
-        "markdown.extensions.meta",
-        "meta"
-      ]
-    },
     {
       "title": "Markdown in HTML – Python Markdown",
       "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/extensions/python-markdown/#markdown-in-html",
diff --git a/docs/setup/extensions/index.md b/docs/setup/extensions/index.md
index 6300bb6ab..8fd02f6e3 100644
--- a/docs/setup/extensions/index.md
+++ b/docs/setup/extensions/index.md
@@ -35,7 +35,6 @@ configuration:
 - [Footnotes]
 - [Highlight]
 - [Keys]
-- [Metadata]
 - [Markdown in HTML]
 - [SmartSymbols]
 - [Snippets]
@@ -60,7 +59,6 @@ configuration:
   [Footnotes]: python-markdown.md#footnotes
   [Highlight]: python-markdown-extensions.md#highlight
   [Keys]: python-markdown-extensions.md#keys
-  [Metadata]: python-markdown.md#metadata
   [Markdown in HTML]: python-markdown.md#markdown-in-html
   [SmartSymbols]: python-markdown-extensions.md#smartsymbols
   [Snippets]: python-markdown-extensions.md#snippets
@@ -88,7 +86,6 @@ gradually add what you want to use:
 markdown_extensions:
 
   # Python Markdown
-  - meta
   - toc:
       permalink: true
 
@@ -113,7 +110,6 @@ markdown_extensions:
   - attr_list
   - def_list
   - footnotes
-  - meta
   - md_in_html
   - toc:
       permalink: true
diff --git a/docs/setup/extensions/python-markdown.md b/docs/setup/extensions/python-markdown.md
index 5b51fa653..bcd9c2ac7 100644
--- a/docs/setup/extensions/python-markdown.md
+++ b/docs/setup/extensions/python-markdown.md
@@ -147,42 +147,6 @@ No configuration options are supported. See reference for usage:
   [Adding footnote references]: ../../reference/footnotes.md#adding-footnote-references
   [Adding footnote content]: ../../reference/footnotes.md#adding-footnote-content
 
-### Metadata
-
-[:octicons-tag-24: 1.0.0][Metadata support] ·
-[:octicons-workflow-24: Extension][Metadata]
-
-The [Metadata] extension adds the ability to attach arbitrary key-value pairs
-to a document via front matter written in YAML syntax before the Markdown.
-Enable it via `mkdocs.yml`:
-
-``` yaml
-markdown_extensions:
-  - meta
-```
-
-No configuration options are available. See reference for usage:
-
-- [Setting the page title]
-- [Setting the page description]
-- [Setting the page icon]
-- [Setting the page template]
-- [Adding tags]
-- [Hiding tags on a page]
-- [Hiding the sidebars]
-- [Hiding the feedback widget]
-
-  [Metadata]: https://python-markdown.github.io/extensions/meta_data/
-  [Metadata support]: https://github.com/squidfunk/mkdocs-material/releases/tag/1.0.0
-  [Setting the page title]: ../../reference/index.md#setting-the-page-title
-  [Setting the page description]: ../../reference/index.md#setting-the-page-description
-  [Setting the page icon]: ../../reference/index.md#setting-the-page-icon
-  [Setting the page template]: ../../reference/index.md#setting-the-page-template
-  [Adding tags]: ../../setup/setting-up-tags.md#adding-tags
-  [Hiding tags on a page]: ../../setup/setting-up-tags.md#hiding-tags-on-a-page
-  [Hiding the sidebars]: ../../setup/setting-up-navigation.md#hiding-the-sidebars
-  [Hiding the feedback widget]: ../../setup/setting-up-site-analytics.md#hiding-the-feedback-widget
-
 ### Markdown in HTML
 
 [:octicons-tag-24: 0.1.0][Markdown in HTML support] ·
diff --git a/docs/setup/setting-up-navigation.md b/docs/setup/setting-up-navigation.md
index f9dffc100..d7e896c89 100644
--- a/docs/setup/setting-up-navigation.md
+++ b/docs/setup/setting-up-navigation.md
@@ -325,9 +325,9 @@ theme:
 
 ### Hiding the sidebars
 
-When [Metadata] is enabled, the navigation and/or table of contents sidebars
-can be hidden for a document with custom front matter. Add the following lines
-at the top of a Markdown file:
+The navigation and/or table of contents sidebars can be hidden for a document
+with the front matter `hide` property. Add the following lines at the top of a 
+Markdown file:
 
 ``` sh
 ---
@@ -352,7 +352,6 @@ hide:
 
     [![hide.* enabled]][hide.* enabled]
 
-  [Metadata]: extensions/python-markdown.md#metadata
   [hide.navigation enabled]: ../assets/screenshots/hide-navigation.png
   [hide.toc enabled]: ../assets/screenshots/hide-toc.png
   [hide.* enabled]: ../assets/screenshots/hide-navigation-toc.png
diff --git a/docs/setup/setting-up-site-analytics.md b/docs/setup/setting-up-site-analytics.md
index 51f586f6f..d606e7318 100644
--- a/docs/setup/setting-up-site-analytics.md
+++ b/docs/setup/setting-up-site-analytics.md
@@ -233,8 +233,7 @@ The following properties are available for each rating:
 
 ### Hiding the feedback widget
 
-When [Metadata] is enabled, the [feedback widget] can be hidden for a document
-with custom front matter. Add the following lines at the top of a Markdown file:
+The [feedback widget] can be hidden for a document with the front matter `hide` property. Add the following lines at the top of a Markdown file:
 
 ``` sh
 ---
@@ -246,8 +245,6 @@ hide:
 ...
 ```
 
-  [Metadata]: extensions/python-markdown.md#metadata
-
 ## Customization
 
 ### Custom site analytics
diff --git a/docs/setup/setting-up-site-search.md b/docs/setup/setting-up-site-search.md
index 28a6b2ab1..bcc44532e 100644
--- a/docs/setup/setting-up-site-search.md
+++ b/docs/setup/setting-up-site-search.md
@@ -366,9 +366,9 @@ clipboard.
 [:octicons-tag-24: 8.3.0][boost support] ·
 :octicons-beaker-24: Experimental
 
-When [Metadata] is enabled, pages can be boosted in search with custom front
-matter, which will make them rank higher. Add the following lines at the top of
-a Markdown file:
+Pages can be boosted in search with the front matter `search.boost` property,
+which will make them rank higher. Add the following lines at the top of a
+Markdown file:
 
 ``` sh
 ---
@@ -384,7 +384,6 @@ search:
     __low values__.
 
   [boost support]: https://github.com/squidfunk/mkdocs-material/releases/tag/8.3.0
-  [Metadata]: extensions/python-markdown.md#metadata
 
 ### Search exclusion
 
@@ -392,8 +391,8 @@ search:
 [:octicons-tag-24: insiders-3.1.0][Insiders] ·
 :octicons-beaker-24: Experimental
 
-When [Metadata] is enabled, pages can be excluded from search with custom front 
-matter, removing them from the index. Add the following lines at the top of a 
+Pages can be excluded from search with the front matter `search.exclude`
+property, removing them from the index. Add the following lines at the top of a 
 Markdown file:
 
 ``` sh
diff --git a/docs/setup/setting-up-social-cards.md b/docs/setup/setting-up-social-cards.md
index c47246f17..e576ca598 100644
--- a/docs/setup/setting-up-social-cards.md
+++ b/docs/setup/setting-up-social-cards.md
@@ -274,12 +274,11 @@ you don't want to use it:
 ## Usage
 
 If you want to adjust the title or set a custom description for the social card,
-you can use the [Metadata] extension, which takes precedence over the
-default values.
+you can set the front matter `title` and `description` properties, which take 
+precedence over the default values.
 
 - [Changing the title]
 - [Changing the description]
 
-  [Metadata]: extensions/python-markdown.md#metadata
   [Changing the title]: ../reference/index.md#setting-the-page-title
   [Changing the description]: ../reference/index.md#setting-the-page-description
diff --git a/docs/setup/setting-up-tags.md b/docs/setup/setting-up-tags.md
index 890eef335..cb3f3cf76 100644
--- a/docs/setup/setting-up-tags.md
+++ b/docs/setup/setting-up-tags.md
@@ -175,9 +175,9 @@ configuration setting:
 
 ### Adding tags
 
-When both, the [built-in tags plugin] and [Metadata] extension are enabled,
-tags can be added for a document with custom front matter. Add the following
-lines at the top of a Markdown file:
+When the [built-in tags plugin] is enabled, tags can be added for a document
+with the front matter `tags` property. Add the following lines at the top of a 
+Markdown file:
 
 ``` sh
 ---
@@ -212,7 +212,6 @@ search preview, which now allows to __find pages by tags__.
     appended.
 
   [built-in tags plugin]: #built-in-tags-plugin
-  [Metadata]: extensions/python-markdown.md#metadata
   [built-in meta plugin]: ../reference/index.md#built-in-meta-plugin
 
 ### Adding a tags index
@@ -241,8 +240,8 @@ arbitrary content before and after the marker:
 ### Hiding tags on a page
 
 While the tags are rendered above the main headline, sometimes, it might be
-desirable to hide them for a specific page, which can be achieved by using the
-[Metadata] extension:
+desirable to hide them for a specific page, which can be achieved with the
+front matter `hide` property:
 
 ``` sh
 ---
diff --git a/docs/setup/setting-up-the-footer.md b/docs/setup/setting-up-the-footer.md
index b5638ffe6..9361f69f4 100644
--- a/docs/setup/setting-up-the-footer.md
+++ b/docs/setup/setting-up-the-footer.md
@@ -152,9 +152,9 @@ extra:
 
 ### Hiding prev/next links
 
-When [Metadata] is enabled, the footer navigation showing links to the previous
-and next page can be hidden by adding the following lines to the front matter of
-a page:
+The footer navigation showing links to the previous and next page can be hidden
+with the front matter `hide` property. Add the following lines at the top of a 
+Markdown file:
 
 ``` sh
 ---
@@ -166,8 +166,6 @@ hide:
 ...
 ```
 
-[Metadata]: extensions/python-markdown.md#metadata
-
 ## Customization
 
 ### Custom copyright
diff --git a/mkdocs.yml b/mkdocs.yml
index c59beef1b..ce50c427c 100755
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -127,7 +127,6 @@ markdown_extensions:
   - attr_list
   - def_list
   - footnotes
-  - meta
   - md_in_html
   - toc:
       permalink: true