From 672414163c51b8cd753539724a8c139ca7eb538b Mon Sep 17 00:00:00 2001 From: squidfunk Date: Wed, 24 Jan 2024 15:45:24 +0700 Subject: [PATCH] Documentation --- docs/insiders/index.md | 12 ++++++------ docs/reference/footnotes.md | 22 ++++++++++++++++++++++ docs/schema/theme.json | 5 +++++ docs/setup/building-an-optimized-site.md | 2 +- docs/setup/setting-up-a-blog.md | 2 +- docs/setup/setting-up-navigation.md | 2 +- mkdocs.yml | 1 + 7 files changed, 37 insertions(+), 9 deletions(-) diff --git a/docs/insiders/index.md b/docs/insiders/index.md index de555ff05..49f5e25cb 100644 --- a/docs/insiders/index.md +++ b/docs/insiders/index.md @@ -88,11 +88,12 @@ a handful of them, [thanks to our awesome sponsors]! ## What's in it for me? The moment you [become a sponsor][how to become a sponsor], you'll get __immediate -access to 23 additional features__ that you can __start using now__, and +access to 24 additional features__ that you can __start using now__, and which are currently exclusively available to sponsors:
+- [x] [Footnote tooltips] :material-alert-decagram:{ .mdx-pulse title="Added on January 24, 2023" } - [x] [Tags plugin: advanced settings] :material-alert-decagram:{ .mdx-pulse title="Added on December 23, 2023" } - [x] [Tags plugin: nested tags] :material-alert-decagram:{ .mdx-pulse title="Added on December 23, 2023" } - [x] [Tags plugin: shadow tags] :material-alert-decagram:{ .mdx-pulse title="Added on December 23, 2023" } @@ -293,6 +294,7 @@ are released for general availability. - [x] [Instant prefetching] - [x] [Blog plugin: advanced settings] - [x] [Blog plugin: author profiles] +- [x] [Footnote tooltips] [Optimize plugin]: ../plugins/optimize.md [Typeset plugin]: ../plugins/typeset.md @@ -302,6 +304,7 @@ are released for general availability. [Instant prefetching]: ../setup/setting-up-navigation.md#instant-prefetching [Blog plugin: advanced settings]: ../setup/setting-up-a-blog.md#advanced-settings [Blog plugin: author profiles]: ../setup/setting-up-a-blog.md#adding-author-profiles + [Footnote tooltips]: ../reference/footnotes.md#footnote-tooltips #### $ 24,000 – Blockpaprika @@ -313,6 +316,7 @@ are released for general availability. - [x] [Stay on page when switching languages] - [x] [Tags plugin: nested tags] - [x] [Tags plugin: shadow tags] +- [x] [Tags plugin: advanced settings] [Projects plugin]: ../plugins/projects.md [Social plugin: custom layouts]: ../setup/setting-up-social-cards.md#customization @@ -322,13 +326,9 @@ are released for general availability. [Stay on page when switching languages]: ../setup/changing-the-language.md#stay-on-page [Tags plugin: nested tags]: ../setup/setting-up-tags.md#nested-tags [Tags plugin: shadow tags]: ../setup/setting-up-tags.md#shadow-tags - -#### $ 28,000 – Lemon Drop - -- [x] [Tags plugin: advanced settings] - [Tags plugin: advanced settings]: ../setup/setting-up-tags.md#advanced-settings + ### Goals completed This section lists all funding goals that were previously completed, which means diff --git a/docs/reference/footnotes.md b/docs/reference/footnotes.md index 16380c2cb..1a2ec5ca3 100644 --- a/docs/reference/footnotes.md +++ b/docs/reference/footnotes.md @@ -26,6 +26,28 @@ See additional configuration options: [Footnotes]: ../setup/extensions/python-markdown.md#footnotes +### Footnote tooltips :material-alert-decagram:{ .mdx-pulse title="Added on January 24, 2024" } + + + + + +[Insiders] allows to render footnotes as inline tooltips, so the user can read +the footnote without leaving the context of the document. Footnote tooltips can +be enabled in `mkdocs.yml` with: + +``` yaml +theme: + features: + - content.footnote.tooltips +``` + +__Footnote tooltips are enabled on our documentation__, so to try it out, you +can just hover or focus any footnote on this page or any other page of our +documentation. + + [Insiders]: ../insiders/index.md + ## Usage ### Adding footnote references diff --git a/docs/schema/theme.json b/docs/schema/theme.json index d871a55b4..87ec5f0e3 100644 --- a/docs/schema/theme.json +++ b/docs/schema/theme.json @@ -498,6 +498,11 @@ "markdownDescription": "https://squidfunk.github.io/mkdocs-material/reference/code-blocks/#code-selection-button", "const": "content.code.select" }, + { + "title": "Footnote tooltips", + "markdownDescription": "https://squidfunk.github.io/mkdocs-material/reference/footnotes/#footnote-tooltips", + "const": "content.footnote.tooltips" + }, { "title": "Linked content tabs", "markdownDescription": "https://squidfunk.github.io/mkdocs-material/reference/content-tabs/#linked-content-tabs", diff --git a/docs/setup/building-an-optimized-site.md b/docs/setup/building-an-optimized-site.md index a75b101ae..d9e2ef182 100644 --- a/docs/setup/building-an-optimized-site.md +++ b/docs/setup/building-an-optimized-site.md @@ -9,7 +9,7 @@ further useful automatic optimization techniques. ## Configuration -### Built-in projects plugin :material-alert-decagram:{ .mdx-pulse title="Added on July 29, 2023" } +### Built-in projects plugin diff --git a/docs/setup/setting-up-a-blog.md b/docs/setup/setting-up-a-blog.md index dbfe39ab7..83b2642d1 100644 --- a/docs/setup/setting-up-a-blog.md +++ b/docs/setup/setting-up-a-blog.md @@ -36,7 +36,7 @@ For a list of all settings, please consult the [plugin documentation]. [plugin documentation]: ../plugins/blog.md -#### Advanced settings :material-alert-decagram:{ .mdx-pulse title="Added on November 23, 2023" } +#### Advanced settings diff --git a/docs/setup/setting-up-navigation.md b/docs/setup/setting-up-navigation.md index a6b64f350..a9867766f 100644 --- a/docs/setup/setting-up-navigation.md +++ b/docs/setup/setting-up-navigation.md @@ -33,7 +33,7 @@ especially useful for large documentation sites. [XHR]: https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest -#### Instant prefetching :material-alert-decagram:{ .mdx-pulse title="Added on June 15, 2023" } +#### Instant prefetching diff --git a/mkdocs.yml b/mkdocs.yml index 2ac67a2e1..60d2fc2cf 100755 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -44,6 +44,7 @@ theme: - content.code.annotate - content.code.copy # - content.code.select + # - content.footnote.tooltips # - content.tabs.link - content.tooltips # - header.autohide