mirror of
https://github.com/squidfunk/mkdocs-material.git
synced 2024-11-30 18:24:35 +01:00
Fixed all anchors after turning on validation
This commit is contained in:
parent
02034087ad
commit
2585b82be2
@ -78,7 +78,7 @@ nav:
|
|||||||
project, and not in a subdirectory. For more information, see the
|
project, and not in a subdirectory. For more information, see the
|
||||||
[`blog_dir`][blog_dir] configuration option.
|
[`blog_dir`][blog_dir] configuration option.
|
||||||
|
|
||||||
[blog_dir]: ../../setup/setting-up-a-blog.md#+blog.blog_dir
|
[blog_dir]: ../../plugins/blog.md#config.blog_dir
|
||||||
|
|
||||||
#### Blog setup
|
#### Blog setup
|
||||||
|
|
||||||
@ -182,12 +182,12 @@ which allow for fine-tuning the output. You can configure post slugs, general
|
|||||||
behavior and much more.
|
behavior and much more.
|
||||||
|
|
||||||
[exact same Markdown flavor]: ../../reference/index.md
|
[exact same Markdown flavor]: ../../reference/index.md
|
||||||
[post slugs]: ../../setup/setting-up-a-blog.md#+blog.post_url_format
|
[post slugs]: ../../plugins/blog.md#config.post_url_format
|
||||||
[draft]: ../../setup/setting-up-a-blog.md#drafts
|
[draft]: ../../plugins/blog.md#meta.draft
|
||||||
[This behavior can be changed]: ../../setup/setting-up-a-blog.md#+blog.draft
|
[This behavior can be changed]: ../../plugins/blog.md#config.draft
|
||||||
[live preview server]: ../../creating-your-site.md#previewing-as-you-write
|
[live preview server]: ../../creating-your-site.md#previewing-as-you-write
|
||||||
[archive]: ../../setup/setting-up-a-blog.md#archive
|
[archive]: ../../plugins/blog.md#config.archive
|
||||||
[category]: ../../setup/setting-up-a-blog.md#categories
|
[category]: ../../plugins/blog.md#config.categories
|
||||||
[Blog]: blog-support-just-landed/blog.png
|
[Blog]: blog-support-just-landed/blog.png
|
||||||
[Blog post]: blog-support-just-landed/blog-post.png
|
[Blog post]: blog-support-just-landed/blog-post.png
|
||||||
[Adding an excerpt]: ../../setup/setting-up-a-blog.md#adding-an-excerpt
|
[Adding an excerpt]: ../../setup/setting-up-a-blog.md#adding-an-excerpt
|
||||||
|
@ -78,6 +78,6 @@ improved, please [open an issue].
|
|||||||
|
|
||||||
[jieba]: https://pypi.org/project/jieba/
|
[jieba]: https://pypi.org/project/jieba/
|
||||||
[zero-width whitespace]: https://en.wikipedia.org/wiki/Zero-width_space
|
[zero-width whitespace]: https://en.wikipedia.org/wiki/Zero-width_space
|
||||||
[separator]: ../../setup/setting-up-site-search.md#separator
|
[separator]: ../../plugins/search.md#config.separator
|
||||||
[q=支持]: ?q=支持
|
[q=支持]: ?q=支持
|
||||||
[open an issue]: https://github.com/squidfunk/mkdocs-material/issues/new/choose
|
[open an issue]: https://github.com/squidfunk/mkdocs-material/issues/new/choose
|
||||||
|
@ -36,7 +36,7 @@ implementation. If you immediately want to learn what's new, skip to the
|
|||||||
[section just after that][what's new]._
|
[section just after that][what's new]._
|
||||||
|
|
||||||
[search]: ../../setup/setting-up-site-search.md
|
[search]: ../../setup/setting-up-site-search.md
|
||||||
[multilingual]: ../../setup/setting-up-site-search.md#lang
|
[multilingual]: ../../plugins/search.md#config.lang
|
||||||
[offline-capable]: ../../setup/building-for-offline-usage.md
|
[offline-capable]: ../../setup/building-for-offline-usage.md
|
||||||
[what's new]: #whats-new
|
[what's new]: #whats-new
|
||||||
|
|
||||||
@ -206,7 +206,7 @@ more magic involved, e.g., search results are [post-processed] and [rescored] to
|
|||||||
account for some shortcomings of [lunr], but in general, this is how data gets
|
account for some shortcomings of [lunr], but in general, this is how data gets
|
||||||
into and out of the index.
|
into and out of the index.
|
||||||
|
|
||||||
[separator]: ../../setup/setting-up-site-search.md#search-separator
|
[separator]: ../../plugins/search.md#config.separator
|
||||||
[default tokenizer]: https://github.com/olivernn/lunr.js/blob/aa5a878f62a6bba1e8e5b95714899e17e8150b38/lunr.js#L413-L456
|
[default tokenizer]: https://github.com/olivernn/lunr.js/blob/aa5a878f62a6bba1e8e5b95714899e17e8150b38/lunr.js#L413-L456
|
||||||
[post-processed]: https://github.com/squidfunk/mkdocs-material/blob/ec7ccd2b2d15dd033740f388912f7be7738feec2/src/assets/javascripts/integrations/search/_/index.ts#L249-L272
|
[post-processed]: https://github.com/squidfunk/mkdocs-material/blob/ec7ccd2b2d15dd033740f388912f7be7738feec2/src/assets/javascripts/integrations/search/_/index.ts#L249-L272
|
||||||
[rescored]: https://github.com/squidfunk/mkdocs-material/blob/ec7ccd2b2d15dd033740f388912f7be7738feec2/src/assets/javascripts/integrations/search/_/index.ts#L274-L275
|
[rescored]: https://github.com/squidfunk/mkdocs-material/blob/ec7ccd2b2d15dd033740f388912f7be7738feec2/src/assets/javascripts/integrations/search/_/index.ts#L274-L275
|
||||||
@ -486,7 +486,7 @@ digit `\d`, which leaves version numbers discoverable. Searching for
|
|||||||
[:octicons-search-24: 7.2.6][q=7.2.6] brings up the [7.2.6] release notes.
|
[:octicons-search-24: 7.2.6][q=7.2.6] brings up the [7.2.6] release notes.
|
||||||
|
|
||||||
[q=7.2.6]: ?q=7.2.6
|
[q=7.2.6]: ?q=7.2.6
|
||||||
[7.2.6]: ../../changelog/index.md#726-_-september-1-2021
|
[7.2.6]: ../../changelog/index.md#7.2.6
|
||||||
|
|
||||||
#### HTML/XML tags
|
#### HTML/XML tags
|
||||||
|
|
||||||
@ -499,19 +499,12 @@ following expression to the separator allows for just that:
|
|||||||
&[lg]t;
|
&[lg]t;
|
||||||
```
|
```
|
||||||
|
|
||||||
Searching for [:octicons-search-24: custom search worker script][q=script]
|
|
||||||
brings up the section on [custom search] and matches the `script` tag among the
|
|
||||||
other search terms discovered.
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
_We've only just begun to scratch the surface of the new possibilities
|
_We've only just begun to scratch the surface of the new possibilities
|
||||||
tokenizer lookahead brings. If you found other useful expressions, you're
|
tokenizer lookahead brings. If you found other useful expressions, you're
|
||||||
invited to share them in the comment section._
|
invited to share them in the comment section._
|
||||||
|
|
||||||
[q=script]: ?q=custom+search+worker+script
|
|
||||||
[custom search]: ../../setup/setting-up-site-search.md#custom-search
|
|
||||||
|
|
||||||
### Accurate highlighting
|
### Accurate highlighting
|
||||||
|
|
||||||
Highlighting is the last step in the process of search and involves the
|
Highlighting is the last step in the process of search and involves the
|
||||||
|
@ -169,7 +169,7 @@ __55__ times, `mkdocs-material-insiders` was shipped __72__ times.
|
|||||||
[Code annotations]: ../../reference/code-blocks.md#adding-annotations
|
[Code annotations]: ../../reference/code-blocks.md#adding-annotations
|
||||||
[Code annotations: strip comments]: ../../reference/code-blocks.md#stripping-comments
|
[Code annotations: strip comments]: ../../reference/code-blocks.md#stripping-comments
|
||||||
[Code block titles]: ../../reference/code-blocks.md#adding-a-title
|
[Code block titles]: ../../reference/code-blocks.md#adding-a-title
|
||||||
[Code block line anchors]: ../../setup/extensions/python-markdown-extensions.md#anchor-linenums
|
[Code block line anchors]: ../../setup/extensions/python-markdown-extensions.md#+pymdownx.highlight.anchor_linenums
|
||||||
[Color palette toggle]: ../../setup/changing-the-colors.md#color-palette-toggle
|
[Color palette toggle]: ../../setup/changing-the-colors.md#color-palette-toggle
|
||||||
[Content tabs: improved support]: ../../reference/content-tabs.md
|
[Content tabs: improved support]: ../../reference/content-tabs.md
|
||||||
[Content tabs: auto-linking]: ../../reference/content-tabs.md#linked-content-tabs
|
[Content tabs: auto-linking]: ../../reference/content-tabs.md#linked-content-tabs
|
||||||
|
@ -69,7 +69,7 @@ Several features are implemented through MkDocs excellent plugin architecture,
|
|||||||
some of which are built-in and distributed with Material for MkDocs, so no
|
some of which are built-in and distributed with Material for MkDocs, so no
|
||||||
installation is required.
|
installation is required.
|
||||||
|
|
||||||
### <!-- md:extension --> – Markdown extension { data-toc-label="Markdown extension" }
|
### <!-- md:extension --> – Markdown extension { data-toc-label="Markdown extension" #extension }
|
||||||
|
|
||||||
This symbol denotes that the thing described is a Markdown extension, which can
|
This symbol denotes that the thing described is a Markdown extension, which can
|
||||||
be enabled in `mkdocs.yml` and adds additional functionality to the Markdown
|
be enabled in `mkdocs.yml` and adds additional functionality to the Markdown
|
||||||
|
@ -476,7 +476,7 @@ overrides via [configuration inheritance].
|
|||||||
See the [getting started guide] for more information.
|
See the [getting started guide] for more information.
|
||||||
|
|
||||||
[configuration inheritance]: https://www.mkdocs.org/user-guide/configuration/#configuration-inheritance
|
[configuration inheritance]: https://www.mkdocs.org/user-guide/configuration/#configuration-inheritance
|
||||||
[getting started guide]: ../getting-started.md#caveats
|
[getting started guide]: ../getting-started.md
|
||||||
[Card grids]: ../../reference/grids.md?h=grids#using-card-grids
|
[Card grids]: ../../reference/grids.md?h=grids#using-card-grids
|
||||||
|
|
||||||
## Support
|
## Support
|
||||||
@ -530,7 +530,7 @@ report it on our [issue tracker] in the public community repository. When
|
|||||||
submitting the bug report, please ensure that you do not include any private
|
submitting the bug report, please ensure that you do not include any private
|
||||||
Insiders' source code, as we want to uphold our fair use policy.
|
Insiders' source code, as we want to uphold our fair use policy.
|
||||||
|
|
||||||
[__How can I report an issue in my customizations?__](#customizations-issues){ #costumisations-issues }
|
[__How can I report an issue in my customizations?__](#customizations-issues){ #customizations-issues }
|
||||||
|
|
||||||
Please note, that we do not offer support for customizations as they vary
|
Please note, that we do not offer support for customizations as they vary
|
||||||
widely and are specific to individual cases. Our support is primarily focused on
|
widely and are specific to individual cases. Our support is primarily focused on
|
||||||
|
@ -180,12 +180,5 @@ Of course, you can also enable both groups with:
|
|||||||
CI=1 INSIDERS=1 mkdocs build
|
CI=1 INSIDERS=1 mkdocs build
|
||||||
```
|
```
|
||||||
|
|
||||||
[^1]:
|
|
||||||
Previously we recommended to use [configuration inheritance] to work around
|
|
||||||
this limitations, but the brand new [built-in group plugin] is a much better
|
|
||||||
approach, as it allows you to use a single configuration file for building
|
|
||||||
your project with the community edition and Insiders version of Material
|
|
||||||
for MkDocs.
|
|
||||||
|
|
||||||
[built-in group plugin]: ../plugins/group.md
|
[built-in group plugin]: ../plugins/group.md
|
||||||
[configuration inheritance]: https://www.mkdocs.org/user-guide/configuration/#configuration-inheritance
|
[configuration inheritance]: https://www.mkdocs.org/user-guide/configuration/#configuration-inheritance
|
||||||
|
@ -555,7 +555,7 @@ exclusive to Insiders, it's recommended to split configuration into a base
|
|||||||
See the [getting started guide] for more information.
|
See the [getting started guide] for more information.
|
||||||
|
|
||||||
[configuration inheritance]: https://www.mkdocs.org/user-guide/configuration/#configuration-inheritance
|
[configuration inheritance]: https://www.mkdocs.org/user-guide/configuration/#configuration-inheritance
|
||||||
[getting started guide]: getting-started.md#caveats
|
[getting started guide]: getting-started.md
|
||||||
|
|
||||||
### Payment
|
### Payment
|
||||||
|
|
||||||
|
@ -5,7 +5,7 @@ philosophy behind the project, in order to make sure it aligns with your goals.
|
|||||||
This page explains the design principles anchored in Material for MkDocs, and
|
This page explains the design principles anchored in Material for MkDocs, and
|
||||||
discusses the [conventions] used in this documentation.
|
discusses the [conventions] used in this documentation.
|
||||||
|
|
||||||
[conventions]: #conventions
|
[conventions]: conventions.md
|
||||||
|
|
||||||
## Design principles
|
## Design principles
|
||||||
|
|
||||||
|
@ -94,7 +94,7 @@ The following settings are available:
|
|||||||
|
|
||||||
#### <!-- md:setting config.enabled -->
|
#### <!-- md:setting config.enabled -->
|
||||||
|
|
||||||
<!-- md:version 9.2.9 -->
|
<!-- md:version 9.3.2 -->
|
||||||
<!-- md:default `true` -->
|
<!-- md:default `true` -->
|
||||||
|
|
||||||
Use this setting to enable or disable the plugin when [building your project].
|
Use this setting to enable or disable the plugin when [building your project].
|
||||||
|
@ -109,7 +109,7 @@ The following settings are available for tags:
|
|||||||
|
|
||||||
#### <!-- md:setting config.tags -->
|
#### <!-- md:setting config.tags -->
|
||||||
|
|
||||||
<!-- md:version 9.2.9 -->
|
<!-- md:version 9.3.2 -->
|
||||||
<!-- md:default `true` -->
|
<!-- md:default `true` -->
|
||||||
|
|
||||||
Use this setting to enable or disable rendering of tags. The plugin still
|
Use this setting to enable or disable rendering of tags. The plugin still
|
||||||
@ -425,7 +425,7 @@ Then, just reference the listing identifier:
|
|||||||
|
|
||||||
See the [listings section] for a list of all available settings.
|
See the [listings section] for a list of all available settings.
|
||||||
|
|
||||||
[listings section]: #listing_configuration
|
[listings section]: #listing-configuration
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
@ -285,7 +285,7 @@ the default type, and thus fallback for unknown type qualifiers, is `note`[^1]:
|
|||||||
[^1]:
|
[^1]:
|
||||||
Previously, some of the supported types defined more than one qualifier.
|
Previously, some of the supported types defined more than one qualifier.
|
||||||
For example, authors could use `summary` or `tldr` as alternative qualifiers
|
For example, authors could use `summary` or `tldr` as alternative qualifiers
|
||||||
to render an [`abstract`](#type:abstract) admonition. As this increased the
|
to render an [`abstract`](#+type:abstract) admonition. As this increased the
|
||||||
size of the CSS that is shipped with Material for MkDocs, the additional
|
size of the CSS that is shipped with Material for MkDocs, the additional
|
||||||
type qualifiers are now all deprecated and will be removed in the next major
|
type qualifiers are now all deprecated and will be removed in the next major
|
||||||
version. This will also be mentioned in the upgrade guide.
|
version. This will also be mentioned in the upgrade guide.
|
||||||
|
@ -43,7 +43,7 @@ the default slug function works. Consider using a [Unicode-aware slug function].
|
|||||||
|
|
||||||
[single language per document]: https://www.w3.org/International/questions/qa-html-language-declarations.en#attributes
|
[single language per document]: https://www.w3.org/International/questions/qa-html-language-declarations.en#attributes
|
||||||
[language selector]: #site-language-selector
|
[language selector]: #site-language-selector
|
||||||
[Unicode-aware slug function]: extensions/python-markdown.md#toc-slugify
|
[Unicode-aware slug function]: extensions/python-markdown.md#+toc.slugify
|
||||||
[add a new language]: https://github.com/squidfunk/mkdocs-material/issues/new?template=04-add-a-translation.yml&title=Add+translations+for+...
|
[add a new language]: https://github.com/squidfunk/mkdocs-material/issues/new?template=04-add-a-translation.yml&title=Add+translations+for+...
|
||||||
|
|
||||||
### Site language selector
|
### Site language selector
|
||||||
|
Loading…
Reference in New Issue
Block a user