OpenSourceArk/mkdocs-material
1
0
Fork 0
mirror of https://github.com/squidfunk/mkdocs-material.git synced 2024-06-14 11:52:32 +03:00
Code Issues Packages Projects Releases Wiki Activity

Fixed all anchors after turning on validation

Browse Source
This commit is contained in:
squidfunk 2024-04-25 10:51:05 +07:00
parent 02034087ad
commit 2585b82be2
No known key found for this signature in database
GPG Key ID: 5ED40BC4F9C436DF
13 changed files with 24 additions and 38 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
docs/blog/posts/blog-support-just-landed.md
View File

@ -78,7 +78,7 @@ nav:
project, and not in a subdirectory. For more information, see the
[`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
@ -182,12 +182,12 @@ which allow for fine-tuning the output. You can configure post slugs, general
behavior and much more.
[exact same Markdown flavor]: ../../reference/index.md
[post slugs]: ../../setup/setting-up-a-blog.md#+blog.post_url_format
[draft]: ../../setup/setting-up-a-blog.md#drafts
[This behavior can be changed]: ../../setup/setting-up-a-blog.md#+blog.draft
[post slugs]: ../../plugins/blog.md#config.post_url_format
[draft]: ../../plugins/blog.md#meta.draft
[This behavior can be changed]: ../../plugins/blog.md#config.draft
[live preview server]: ../../creating-your-site.md#previewing-as-you-write
[archive]: ../../setup/setting-up-a-blog.md#archive
[category]: ../../setup/setting-up-a-blog.md#categories
[archive]: ../../plugins/blog.md#config.archive
[category]: ../../plugins/blog.md#config.categories
[Blog]: blog-support-just-landed/blog.png
[Blog post]: blog-support-just-landed/blog-post.png
[Adding an excerpt]: ../../setup/setting-up-a-blog.md#adding-an-excerpt

2
docs/blog/posts/chinese-search-support.md
View File

@ -78,6 +78,6 @@ improved, please [open an issue].
[jieba]: https://pypi.org/project/jieba/
[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=支持
[open an issue]: https://github.com/squidfunk/mkdocs-material/issues/new/choose

13
docs/blog/posts/search-better-faster-smaller.md
View File

@ -36,7 +36,7 @@ implementation. If you immediately want to learn what's new, skip to the
[section just after that][what's new]._
[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
[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
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
[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
@ -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.
[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
@ -499,19 +499,12 @@ following expression to the separator allows for just that:
&[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
tokenizer lookahead brings. If you found other useful expressions, you're
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
Highlighting is the last step in the process of search and involves the

2
docs/blog/posts/the-past-present-and-future.md
View File

@ -169,7 +169,7 @@ __55__ times, `mkdocs-material-insiders` was shipped __72__ times.
[Code annotations]: ../../reference/code-blocks.md#adding-annotations
[Code annotations: strip comments]: ../../reference/code-blocks.md#stripping-comments
[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
[Content tabs: improved support]: ../../reference/content-tabs.md
[Content tabs: auto-linking]: ../../reference/content-tabs.md#linked-content-tabs

2
docs/conventions.md
View File

@ -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
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
be enabled in `mkdocs.yml` and adds additional functionality to the Markdown

4
docs/insiders/faq/sponsoring.md
View File

@ -476,7 +476,7 @@ overrides via [configuration inheritance].
See the [getting started guide] for more information.
[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
## 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
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
widely and are specific to individual cases. Our support is primarily focused on

13
docs/insiders/getting-started.md
View File

@ -42,13 +42,13 @@ your private repositories.
Material for MkDocs Insiders can be installed with `pip`. You will
normally want to install the latest release but can also install a
specific older release or even the latest development version.
specific older release or even the latest development version.
Make sure you have the `GH_TOKEN` variable set as instructed above.
=== "Specific release"
Pick the corresponding tag from the [list of tags] for the Insiders
repository. In the `pip` command below, replace the tag at the
Pick the corresponding tag from the [list of tags] for the Insiders
repository. In the `pip` command below, replace the tag at the
end of the URL with the one you want.
``` sh
@ -180,12 +180,5 @@ Of course, you can also enable both groups with:
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
[configuration inheritance]: https://www.mkdocs.org/user-guide/configuration/#configuration-inheritance

2
docs/insiders/index.md
View File

@ -555,7 +555,7 @@ exclusive to Insiders, it's recommended to split configuration into a base
See the [getting started guide] for more information.
[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

2
docs/philosophy.md
View File

@ -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
discusses the [conventions] used in this documentation.
[conventions]: #conventions
[conventions]: conventions.md
## Design principles

2
docs/plugins/search.md
View File

@ -94,7 +94,7 @@ The following settings are available:
#### <!-- md:setting config.enabled -->
<!-- md:version 9.2.9 -->
<!-- md:version 9.3.2 -->
<!-- md:default `true` -->
Use this setting to enable or disable the plugin when [building your project].

4
docs/plugins/tags.md
View File

@ -109,7 +109,7 @@ The following settings are available for tags:
#### <!-- md:setting config.tags -->
<!-- md:version 9.2.9 -->
<!-- md:version 9.3.2 -->
<!-- md:default `true` -->
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.
[listings section]: #listing_configuration
[listings section]: #listing-configuration
---

2
docs/reference/admonitions.md
View File

@ -285,7 +285,7 @@ the default type, and thus fallback for unknown type qualifiers, is `note`[^1]:
[^1]:
Previously, some of the supported types defined more than one qualifier.
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
type qualifiers are now all deprecated and will be removed in the next major
version. This will also be mentioned in the upgrade guide.

2
docs/setup/changing-the-language.md
View File

@ -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
[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+...
### Site language selector