1
0
mirror of https://github.com/squidfunk/mkdocs-material.git synced 2025-02-17 18:49:21 +01:00

Merge pull request #4628 from squidfunk/feature/material-v9

Material for MkDocs 9
This commit is contained in:
Martin Donath 2023-01-02 10:24:02 +01:00 committed by GitHub
commit 23730a1f15
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
311 changed files with 6130 additions and 3844 deletions

View File

@ -1,77 +1,119 @@
name: Bug Report
description: Report a bug
description: Something is not working? Report a bug in Material for MkDocs.
body:
- type: checkboxes
attributes:
label: Contribution guidelines
description: Please read the contribution guidelines before proceeding.
options:
- label: I've read the [contribution guidelines](https://github.com/squidfunk/mkdocs-material/blob/master/CONTRIBUTING.md) and wholeheartedly agree
required: true
- type: checkboxes
attributes:
label: I've found a bug and checked that ...
description: Make sure that your request fulfills all of the following requirements. If one requirement cannot be satisfied, explain in detail why.
options:
- label: ... the problem doesn't occur with the `mkdocs` or `readthedocs` themes
required: true
- label: ... the problem persists when all overrides are removed, i.e. `custom_dir`, `extra_javascript` and `extra_css`
- label: ... the documentation does not mention anything about my problem
- label: ... there are no open or closed issues that are related to my problem
- type: textarea
id: context
attributes:
label: Description
description: Please provide a brief description of the bug in 1-2 sentences.
label: Context
description: >-
This field is optional. You may provide additional context for the bug
you want to report, helping us to understand what you are working on and
what you are trying to achieve. If the context is not relevant, you can
leave this field empty. [More](https://squidfunk.github.io/mkdocs-material/bug-report/#context)
validations:
required: false
- type: textarea
id: bug-description
attributes:
label: Bug description
description: >-
Please give a detailed description of the bug. Explain where Material
for MkDocs does not behave as you would expect it to. Be as specific as
possible. If you have found a workaround or a fix for the problem,
please let us maintainers (and all other users) know. [More](https://squidfunk.github.io/mkdocs-material/bug-report/#bug-description)
validations:
required: true
- type: textarea
id: related-links
attributes:
label: Expected behaviour
description: Please describe precisely what you'd expect to happen.
label: Related links
description: >-
Please list all links to the sections of
[our documentation](https://squidfunk.github.io/mkdocs-material) that
are relevant to the bug, in order to show that you have consulted and
thoroughly read it. Additionally, list links to possibly related issues
or discussions you encountered when searching our issue tracker.
[More](https://squidfunk.github.io/mkdocs-material/bug-report/#related-links)
value: |-
- [Bug reporting](https://squidfunk.github.io/mkdocs-material/bug-report/)
-
validations:
required: true
- type: textarea
id: reproduction
attributes:
label: Actual behaviour
description: Please describe precisely what is actually happening.
label: Reproduction
description: >-
Please create a __minimal reproduction__ for the bug. First, read our
[reproduction guide](https://squidfunk.github.io/mkdocs-material/bug-report/reproduction/)
that explains the necessary steps, then use the [built-in info plugin](https://squidfunk.github.io/mkdocs-material/bug-report/reproduction/#creating-a-zip-file) (mandatory) to create a self-contained
.zip file with the reproduction. Without a reproduction, it can be
challenging to fix the bug. [More](https://squidfunk.github.io/mkdocs-material/bug-report/#reproduction)
placeholder: |-
Drag and drop .zip file with reproduction here.
validations:
required: true
- type: textarea
id: steps-to-reproduce
attributes:
label: Steps to reproduce
description: Please describe the steps to reproduce the bug.
description: >-
Please provide a detailed list of instructions, guiding us maintainers
through the required steps, helping us to recreate the problem using the
minimal reproduction you provided. Be as specific as possible and as
verbose as necessary try not to leave anything out. [More](https://squidfunk.github.io/mkdocs-material/bug-report/reproduction/#steps-to-reproduce)
placeholder: |-
1. ...
2. ...
3. ...
validations:
required: true
- type: textarea
- type: dropdown
id: browser
attributes:
label: Package versions
description: Please provide all package versions, i.e. run the commands in backticks on a shell.
value: |-
- Python: `python --version`
- MkDocs: `mkdocs --version`
- Material: `pip show mkdocs-material | grep -E ^Version`
validations:
required: true
- type: textarea
label: Browser
description: >-
If the bug only happens in __specific browsers__, please select them
from the dropdown below. If your browser is not listed or the version
is relevant, you may select _Other_ and provide more details in the
field above. [More](https://squidfunk.github.io/mkdocs-material/bug-report/reproduction/#browser)
multiple: true
options:
- Chrome
- Safari
- Edge
- Firefox
- Opera
- Other
- type: checkboxes
id: checklist
attributes:
label: Configuration
description: Please provide a minimal (!) `mkdocs.yml` to reproduce the bug.
placeholder: |-
site_name: My Docs
site_url: https://example.com/docs
render: yaml
validations:
required: true
- type: textarea
attributes:
label: System information
description: Please provide your operating system and browser type and version.
value: |-
- Operating system: ...
- Browser: ...
validations:
required: true
label: Before submitting
description: >-
Please ensure your bug report fulfills all of the following requirements.
If you are not sure what a specific requirement means, follow the link
to learn about it and understand why it is necessary before ticking the
box. This will save the maintainers and you valuable time.
options:
- label: >-
I have read and followed the [bug reporting guidelines](https://squidfunk.github.io/mkdocs-material/bug-report/).
required: true
- label: >-
I have attached links to [the documentation](https://squidfunk.github.io/mkdocs-material),
and possibly related [issues](https://github.com/squidfunk/mkdocs-material/issues)
or [discussions](https://github.com/squidfunk/mkdocs-material/discussions).
required: true
- label: >-
I assure that I have [removed all customizations](https://squidfunk.github.io/mkdocs-material/bug-report/#remove-customizations)
before submitting this bug report.
required: true
- label: >-
I have attached a [minimal reproduction](https://squidfunk.github.io/mkdocs-material/bug-report/reproduction/).
required: true

View File

@ -24,13 +24,15 @@ body:
{% macro t(key) %}{{ {
"language": "en",
"direction": "ltr",
"action.edit": "Edit this page",
"action.skip": "Skip to content",
"action.view": "View source of this page",
"announce.dismiss": "Don't show this again",
"clipboard.copy": "Copy to clipboard",
"clipboard.copied": "Copied to clipboard",
"consent.accept": "Accept",
"consent.manage": "Manage settings",
"consent.reject": "Reject",
"edit.link": "Edit this page",
"footer": "Footer",
"footer.next": "Next",
"footer.previous": "Previous",
@ -52,10 +54,9 @@ body:
"search.result.term.missing": "Missing",
"select.language": "Select language",
"select.version": "Select version",
"skip.link": "Skip to content",
"source": "Go to repository",
"source.file.date.created": "Created",
"source.file.date.updated": "Last update",
"source.link": "Go to repository",
"tabs": "Tabs",
"toc": "Table of contents",
"top": "Back to top"

4
.gitignore vendored
View File

@ -45,6 +45,10 @@
.eslintcache
__pycache__
# Examples
example
example.zip
# -----------------------------------------------------------------------------
# General
# -----------------------------------------------------------------------------

View File

@ -103,6 +103,7 @@
"dppx",
"deg",
"em",
"fr",
"mm",
"ms",
"px",

2
.vscode/launch.json vendored
View File

@ -10,7 +10,7 @@
"--incognito"
],
"url": "http://localhost:8000/mkdocs-material/",
"webRoot": ".",
"webRoot": "${workspaceFolder}",
"smartStep": true
}
]

View File

@ -1,3 +1,46 @@
mkdocs-material-9.0.0 (2023-01-02)
Additions and improvements
* Added support for rich search previews
* Added support for tokenizer lookahead
* Added support for better search highlighting
* Added support for excluding content from search
* Added support for configurable search pipeline
* Added support for offline search via offline plugin
* Added support for multiple instances of built-in tags plugin
* Added support for removing copy-to-clipboard button
* Added support for removing footer navigation
* Added support for button to view the source of a page
* Improved readability of query string for search sharing
* Improved stability of search plugin when using --dirtyreload
* Improved search result group button, now sticky and stable
* Updated Norwegian translations
* Updated MkDocs to 1.4.2
Removals
* Removed deprecated alternative admonition qualifiers
* Removed :is() selectors (in output) for easier overriding
* Removed .title suffix on translations
* Removed legacy method for providing page title in feedback URL
* Removed support for indexing only titles in search
* Removed support for custom search transforms
* Removed support for custom search workers
* Removed temporary snow feature (easter egg)
Fixes
* Fixed Norwegian and Korean language code
* Fixed detection of composition events in search interface
* Fixed search plugin not using title set via front matter
* Fixed search highlighting of tags
* Fixed search sharing URL using post transformed string
* Fixed theme-color meta tag getting out-of-sync with palette toggle
* Fixed prev/next page keyboard navigation when footer is not present
* Fixed overflowing navigation tabs not being scrollable
* Fixed inclusion of code block line numbers from search
mkdocs-material-8.5.11+insiders-4.27.0 (2022-12-20)
* Added built-in typeset plugin to preserve formatting in sidebars

View File

@ -1 +0,0 @@
ᴴₒᴴₒᴴₒ: true

View File

@ -64,7 +64,7 @@ mkdocs new .
This will create the following structure:
```
``` { .sh .no-copy }
.
├─ docs/
│ └─ index.md
@ -118,7 +118,7 @@ first post. All blog posts are written with the [exact same Markdown flavor] as
already included with Material for MkDocs. First, create a folder called `posts`
with a file called `hello-world.md`:
``` sh
``` { .sh .no-copy }
.
├─ docs/
│ ├─ posts/

315
docs/bug-report/index.md Normal file
View File

@ -0,0 +1,315 @@
# Bug reporting
Material for MkDocs is an actively maintained project that we constantly strive
to improve. With a project of this size and complexity, bugs may occur. If you
think you have discovered a bug, you can help us by submitting an issue in our
public [issue tracker], following this guide.
[issue tracker]: https://github.com/squidfunk/mkdocs-material/issues
## Before creating an issue
With more than 20.000 users, issues are created every other day. The maintainers
of this project are trying very hard to keep the number of open issues down by
fixing bugs as fast as possible. By following this guide, you will know exactly
what information we need to help you quickly.
__But first, please try the following things before creating an issue.__
### Upgrade to latest version
Chances are, that the bug you discovered was already fixed in a subsequent
version. Thus, before reporting an issue, ensure that you're running the
[latest version] of Material for MkDocs. Please consult our [upgrade guide] to
learn how to upgrade to the latest version.
!!! warning "Bug fixes are not backported"
Please understand that only bugs that occur in the latest version of
Material for MkDocs will be addressed. Also, in order to reduce duplicate
efforts, fixes cannot be backported to earlier versions.
### Remove customizations
If you're using [customizations] like [additional CSS], [JavaScript], or
[theme extension], please remove them from `mkdocs.yml` before reporting a bug.
We can't offer official support for bugs that might hide in your overrides, so
make sure to omit the following settings from `mkdocs.yml`:
- [`theme.custom_dir`][theme.custom_dir]
- [`theme.hooks`][theme.hooks]
- [`extra_css`][extra_css]
- [`extra_javascript`][extra_javascript]
If, after removing those settings, the bug is gone, the bug is likely caused by
your customizations. A good idea is to add them back gradually to narrow down
the root cause of the problem. If you did a major version upgrade, make sure you
adjusted all partials you have overridden.
!!! warning "Customizations mentioned in our documentation"
A handful of the features Material for MkDocs offers can only be implemented
with customizations. If you find a bug in any of the customizations [that
our documentation explicitly mentions], you are of course encouraged to
report it.
__Don't be shy to ask on our [discussion board] for help if you run into
problems.__
[latest version]: ../changelog/index.md
[upgrade guide]: ../upgrade.md
[Customizations]: ../customization.md
[additional CSS]: ../customization.md#additional-css
[JavaScript]: ../customization.md#additional-javascript
[theme extension]: ../customization.md#extending-the-theme
[theme.custom_dir]: https://www.mkdocs.org/user-guide/configuration/#custom_dir
[theme.hooks]: https://www.mkdocs.org/user-guide/configuration/#hooks
[extra_css]: https://www.mkdocs.org/user-guide/configuration/#extra_css
[extra_javascript]: https://www.mkdocs.org/user-guide/configuration/#extra_javascript
[discussion board]: https://github.com/squidfunk/mkdocs-material/issues
[StackOverflow]: https://stackoverflow.com
[that our documentation explicitly mentions]: ?q="extends+base"
### Search for solutions
At this stage, we know that the problem persists in the latest version and is
not caused by any of your customizations. However, it's possible that the issue
might be the result of a small typo or a syntactical error in a configuration
file, e.g. `mkdocs.yml`.
Now, before you go through the trouble of creating a bug report, that we
maintainers close right away with a link to the relevant documentation section
or another already reported or closed issue or discussion, you can save time for
us and yourself by doing some research:
1. [Search our documentation] and look for the relevant sections that might
possibly be related to your problem. If found, make sure that you configured
everything correctly.[^1]
[^1]:
When adding lines to `mkdocs.yml`, make sure you are preserving the
indentation as mentioned in the documentation, since YAML is a
whitespace-sensitive language. Many reported issues turn out to be
configuration errors.
2. [Search our issue tracker][issue tracker], as another user might already
have reported the same problem, and there might even be a known workaround
or fix for it. Thus, no need to create a new issue.
3. [Search our discussion board][discussion board] to learn if other users
are struggeling with similar problems, and work together with our
great community towards a solution. Many problems are solved here.
__Keep track of all <u>search terms</u> and <u>relevant links</u>, you'll need
them in the bug report.__[^2]
[^2]:
We might be using terminology in our documentation different from yours,
but mean the same. When you include the search terms and related links
in your bug report, you help us to adjust and improve the documentation.
---
At this point, when you still haven't found a solution to your problem, we
encourage you to create an issue, because it's now very likely that you
stumbled over something we don't know yet. Read the next section to learn
how to create a complete and helpful bug report.
[Search our documentation]: ?q=
## Issue template
We have created a new issue template to make the bug reporting process as simple
as possible and more efficient for the community and for us. It is the result of
our experience answering and fixing more than 1,600 issues (and counting), and
consists of the following parts:
- [Title]
- [Context] <small>optional</small>
- [Bug description]
- [Related links]
- [Reproduction]
- [Steps to reproduce]
- [Browser] <small>optional</small>
- [Checklist]
[Title]: #title
[Context]: #context
[Bug description]: #bug-description
[Related links]: #related-links
[Reproduction]: #reproduction
[Steps to reproduce]: #steps-to-reproduce
[Browser]: #browser
[Checklist]: #checklist
### Title
A good title is short and descriptive. It should be a one-sentence executive
summary of the issue, so the impact and severity of the bug you want to report
can be inferred from the title.
| <!-- --> | Example |
| -------- | -------- |
| :material-check:{ style="color: #4DB6AC" } __Clear__ | Built-in `typeset` plugin changes precedence of nav title over `h1`
| :material-close:{ style="color: #EF5350" } __Wordy__ | The built-in `typeset` plugin changes the precedence of the nav title over the document headline
| :material-close:{ style="color: #EF5350" } __Unclear__ | Title does not work
| :material-close:{ style="color: #EF5350" } __Generic__ | Please help
### Context <small>optional</small> { #context }
Before describing the bug, you can provide additional context that can be
helpful to understand what you were trying to achieve. Explain the circumstances
in which you're using Material for MkDocs, and what you _think_ might be
relevant. Don't write about the bug here.
> __Why this might be helpful__: some errors only manifest in specific settings,
> environments or edge cases, for example when your documentation contains
> thousands of documents.
### Bug description
Now, to the bug you want to report. Provide a clear, focused, specific and
concise summary of the bug you encountered. Explain why you think this is a bug
that should be reported to Material for MkDocs, and not to one of its
dependencies.[^3] Adhere to the following principles:
[^3]:
Sometimes, users report bugs on our [issue tracker] that are caused by one
of our upstream dependencies, including [MkDocs], [Python Markdown],
[Python Markdown Extensions] or third-party plugins. A good rule of thumb is
to change the [`theme.name`][theme.name] to `mkdocs` or `readthedocs`, and
check if the problem persists. If it does, the problem is likely not
related to Material for MkDocs and should be reported upstream. When in
doubt, use our [discussion board] to ask for help.
- __Explain the <u>what</u>, not the <u>how</u>__ don't explain
[how to reproduce the bug][Steps to reproduce] here, we're getting there.
Focus on articulating the problem and its impact as clearly as possible.
- __Keep it short and concise__ if the bug can be precisely explained in one
or two sentences, perfect. Don't inflate it maintainers and future users
will be grateful, having to read less.
- __One bug at a time__ if you encountered several unrelated bugs, please
create separate issues for them. Don't report them in the same issue, as
this makes attribution difficult.
---
:material-run-fast: __Stretch goal__ if you found a workaround or a way to fix
the bug, you can help other users to temporarily mitigate the problem before
we maintainers can fix the bug in our code base.
> __Why we need this__: in order for us to understand the issue at hand, we
> need a clear description of the problem and its impact, which is essential
> for triage and prioritization.
[MkDocs]: https://www.mkdocs.org
[Python Markdown]: https://python-markdown.github.io/extensions/
[Python Markdown Extensions]: https://facelessuser.github.io/pymdown-extensions/
[theme.name]: https://www.mkdocs.org/user-guide/configuration/#theme
### Related links
Of course, prior to reporting a bug, you have read our documentation and
[could not find a working solution][search for solutions]. Please share links
to all sections of our documentation that might be relevant to the bug, as it
helps us gradually improve it.
Additionally, since you have searched our [issue tracker] and [discussion board]
before reporting an issue, and have possibly found several issues or
discussions, include those as well. Every link to an issue or discussion creates
a backlink, guiding us maintainers and other users in the future.
---
:material-run-fast: __Stretch goal__ if you also include the search terms you
used when [searching for a solution][search for solutions] to your problem, you
make it easier for us maintainers to improve the documentation.
> __Why we need this__: related links help us better understand what you were
> trying to achieve and whether sections of our documentation need to be
> adjusted, extended or overhauled.
[search for solutions]: #search-for-solutions
### Reproduction
A minimal reproduction is at the heart of every well-written bug report, as
it allows us maintainers to quickly recreate the necessary conditions to inspect
the bug and quickly find its root cause. It's proven fact that issues with
concise and small reproductions can be fixed much faster.
[:material-bug: Create reproduction][Create reproduction]{ .md-button .md-button--primary }
---
After you created the reproduction, you should have a .zip file, ideally not
larger than 1 MB. Just drag and drop the .zip file into this field, which will
automatically upload it to GitHub.
> __Why we need this__: if an issue contains no minimal reproduction, or just
> a link to a repositority with thousands of files, the maintainers would need
> to invest a lot of time into trying to recreate the right conditions to even
> inspect the bug, let alone fix it.
!!! warning "Don't share links to repositories"
While we know that it is good practice among developers to include a link
to a repository with the bug report, we currently don't support those in our
process. The reason is that the reproduction that is automatically
produced by the [built-in info plugin] contains all of the necessary
environment information that is often forgotten to be included.
Additionally, there are many non-technical users of Material for MkDocs that
have trouble creating repositories.
[Create reproduction]: reproduction.md
[built-in info plugin]: reproduction.md#creating-a-zip-file
### Steps to reproduce
At this point, you provided us with enough information to understand the bug,
and you gave us a reproduction that we can run and inspect. However, when we
run your reproduction, it might not be immediately apparent how we can see
the bug in action.
Next, please list the specific steps we should follow when running your
reproduction to observe the bug. Keep the steps short and concise and make sure
to not leave anything out. Use simple language as you would explain it to a five
year old and focus on continuity.
> __Why we need this__: we must know how to navigate your reproduction in order
> to observe the bug, as some bugs only occur at certain viewports or in
> specific conditions.
### Browser <small>optional</small> { #browser }
If you're reporting a bug that only happens in one or more _specific_ browsers,
we need to know which browsers are affected. This field is optional, as it is
only relevant when the bug you are reporting does not involve a crash when
[previewing] or [building] your site.
> __Why we need this__: some bugs only occur in specific browsers or versions.
> Since now, almost all browser are evergreen, we usually don't need to know the
> version in which it occurs, but we might ask for it later. When in doubt, add
> the browser version as the first step in the field above.
[previewing]: http://localhost:8000/mkdocs-material/creating-your-site/#previewing-as-you-write
[building]: http://localhost:8000/mkdocs-material/creating-your-site/#building-your-site
### Checklist
Thanks for following the guide, and creating a high quality and complete bug
report you are almost done. This section ensures that you have read this guide
and have worked to your best knowledge to provide us with everything we need to
know to help you.
__We'll take it from here.__
## Incomplete issues
Please understand, that we reserve us the right to close incomplete issues which
do not contain minimal reproductions, or do not adhere to the quality standards
and requirements mentioned in this document. Issues can be reopened, when the
missing information has been provided.

View File

@ -0,0 +1,109 @@
# Creating a reproduction
A reproduction is a simplified version of a bug that demonstrates the specific
scenario in which the bug occurred. It includes all necessary minimal settings
and instructions, and should be as simple as possible while still demonstrating
the issue.
## Guide
### Environment <small>optional</small> { #environment }
We recommend using a [virtual environment], which is an isolated Python runtime.
If you are in a virtual environment, any packages that you install or upgrade
will be local to the environment. If you run into problems, you can
just delete and recreate the environment. It's trivial to set up.
- Create a new virtual environment with:
```
python3 -m venv venv
```
- Activate the environment with:
``` sh
. venv/bin/activate # (1)!
```
1. Your terminal should now print `(venv)` before the prompt, which is
how you know that you are inside an environment.
- Exit the environment with:
```
deactivate
```
[virtual environment]: https://realpython.com/what-is-pip/#using-pip-in-a-python-virtual-environment
### Minimal reproduction
By following the instructions below, you will set up a skeleton project in order
to create a minimal reproduction. As mentioned above, we recommend using a
[virtual environment], so create a new folder in your working directory, and
inside it, a new virtual environment. Next:
1. As mentioned in our [bug reporting guide], ensure that you're running the
latest version of Material for MkDocs which might already include a fix for
the bug:
```
pip install --upgrade --force-reinstall mkdocs-material
```
2. Bootstrap a new documentation project by using the `mkdocs` executable,
which you use as a basis for the reproduction. It's essential to create a
new, empty project for this:
```
mkdocs new .
```
Start, by adding the [minimal configuration] in `mkdocs.yml`:
``` yaml
theme:
name: material
```
3. Now, only add the necessary settings to `mkdocs.yml`, to keep the
reproduction minimal. If you are creating a reproduction for a rendering
bug, create only the necessary amount of Markdown documents. __Repeat this
step until the bug you want to report can be observed.__
4. As a last step before packing everything into a .zip file, double check all
settings and documents if they are essential to the reproduction, which
means that the bug does not occur when they are omitted. Remove all
non-essential lines and files.
[bug reporting guide]: index.md#upgrade-to-latest-version
[minimal configuration]: ../../creating-your-site/#minimal-configuration
### Creating a .zip file
Material for MkDocs 9.0.0 includes a new plugin that is solely intended for creating
reproductions for bug reports. When the built-in info plugin is enabled, MkDocs
will add all relevant files to a .zip, print a summary to the terminal and
exit. Add the following lines to `mkdocs.yml`:
``` yaml
plugins:
- info
```
Now, when running `mkdocs build`, a file called `example.zip` is automatically
created, containing the minimal reproduction you can now attach to your bug
report.
```
INFO - Started archive creation for bug report
INFO - Archive successfully created:
example/.dependencies.json 859.0 B
example/.versions.log 83.0 B
example/docs/index.md 282.0 B
example/mkdocs.yml 56.0 B
example.zip 1.8 kB
```

File diff suppressed because it is too large Load Diff

View File

@ -24,7 +24,7 @@ Alternatively, if you're running Material for MkDocs from within Docker, use:
This will create the following structure:
```
``` { .sh .no-copy }
.
├─ docs/
│ └─ index.md

View File

@ -19,7 +19,7 @@ If you want to tweak some colors or change the spacing of certain elements,
you can do this in a separate style sheet. The easiest way is by creating a
new style sheet file in the `docs` directory:
``` sh
``` { .sh .no-copy }
.
├─ docs/
│ └─ stylesheets/
@ -39,7 +39,7 @@ extra_css:
If you want to integrate another syntax highlighter or add some custom logic to
your theme, create a new JavaScript file in the `docs` directory:
``` sh
``` { .sh .no-copy }
.
├─ docs/
│ └─ javascripts/
@ -87,7 +87,7 @@ of the original theme, as any file in the `overrides` directory will replace the
file with the same name which is part of the original theme. Besides, further
assets may also be put in the `overrides` directory:
``` sh
``` { .sh .no-copy }
.
├─ .icons/ # Bundled icon sets
├─ assets/
@ -113,7 +113,6 @@ assets may also be put in the `overrides` directory:
│ ├─ nav.html # Main navigation
│ ├─ nav-item.html # Main navigation item
│ ├─ pagination.html # Pagination (used for blog)
│ ├─ palette.html # Color palette
│ ├─ post.html # Blog post excerpt
│ ├─ search.html # Search interface
│ ├─ social.html # Social links
@ -143,7 +142,7 @@ and location in the `overrides` directory. For example, to replace the original
`footer.html` partial, create a new `footer.html` partial in the `overrides`
directory:
``` sh
``` { .sh .no-copy }
.
├─ overrides/
│ └─ partials/
@ -161,7 +160,7 @@ template blocks, which are defined inside the templates and wrap specific
features. In order to set up block overrides, create a `main.html` file inside
the `overrides` directory:
``` sh
``` { .sh .no-copy }
.
├─ overrides/
│ └─ main.html

View File

@ -23,10 +23,10 @@ Material for MkDocs with:
pip install mkdocs-material
```
=== "8.x"
=== "9.x"
``` sh
pip install mkdocs-material=="8.*" # (1)!
pip install mkdocs-material=="9.*" # (1)!
```
1. Material for MkDocs uses [semantic versioning][^1], which is why it's a
@ -85,10 +85,10 @@ and pull the image with:
docker pull squidfunk/mkdocs-material
```
=== "8.x"
=== "9.x"
```
docker pull squidfunk/mkdocs-material:8
docker pull squidfunk/mkdocs-material:9
```
The `mkdocs` executable is provided as an entry point and `serve` is the

View File

@ -1,7 +1,6 @@
---
template: home.html
title: Material for MkDocs
ᴴₒᴴₒᴴₒ: false
---
Welcome to Material for MkDocs.

View File

@ -2,29 +2,29 @@
## Material for MkDocs Insiders
### 4.27.0 <small>_ December 20, 2022</small> { id="4.27.0" }
### 4.27.0 <small>December 20, 2022</small> { id="4.27.0" }
- Added built-in typeset plugin to preserve formatting in sidebars
- Added URL and table of contents support for blog categories
### 4.26.6 <small>_ November 28, 2022</small> { id="4.26.6" }
### 4.26.6 <small>November 28, 2022</small> { id="4.26.6" }
- Fixed #4683: Tags plugin crashes when a tag is empty
### 4.26.5 <small>_ November 27, 2022</small> { id="4.26.5" }
### 4.26.5 <small>November 27, 2022</small> { id="4.26.5" }
- Fixed #4632: Post excerpt title link doesn't point to top of the page
### 4.26.4 <small>_ November 27, 2022</small> { id="4.26.4" }
### 4.26.4 <small>November 27, 2022</small> { id="4.26.4" }
- Fixed redundant file extension when using privacy plugin
### 4.26.3 <small>_ November 15, 2022</small> { id="4.26.3" }
### 4.26.3 <small>November 15, 2022</small> { id="4.26.3" }
- Fixed #4637: Attachments w/o titles in related links error in blog plugin
- Fixed #4631: Remote favicons not downloaded and inlined by privacy plugin
### 4.26.2 <small>_ November 3, 2022</small> { id="4.26.2" }
### 4.26.2 <small>November 3, 2022</small> { id="4.26.2" }
- Updated MkDocs to 1.4.2
- Added support for tag compare functions when sorting on index pages
@ -36,59 +36,59 @@
- Fixed #4542: Blog plugin doesn't allow for multiple instances
- Fixed #4532: Blog plugin doesn't allow for mixed use of date and datetime
### 4.26.1 <small>_ October 22, 2022</small> { id="4.26.1" }
### 4.26.1 <small>October 22, 2022</small> { id="4.26.1" }
- Improved reporting of configuration errors in tags plugin
- Fixed #4515: Privacy plugin fails when site URL is not defined
- Fixed #4514: Privacy plugin doesn't fetch Google fonts (4.26.0 regression)
### 4.26.0 <small>_ October 18, 2022</small> { id="4.26.0" }
### 4.26.0 <small>October 18, 2022</small> { id="4.26.0" }
- Refactored privacy plugin to prepare for new features
- Added support for `rel=noopener` links in privacy plugin
- Resolve encoding issues with blog and privacy plugin
### 4.25.5 <small>_ October 16, 2022</small> { id="4.25.5" }
### 4.25.5 <small>October 16, 2022</small> { id="4.25.5" }
- Updated MkDocs to 1.4.1
- Added namespace prefix to built-in plugins
- Updated `content` and `header` partial
### 4.25.4 <small>_ October 9, 2022</small> { id="4.25.4" }
### 4.25.4 <small>October 9, 2022</small> { id="4.25.4" }
- Fixed other path issues for standalone blogs (4.24.2 regression)
### 4.25.3 <small>_ October 9, 2022</small> { id="4.25.3" }
### 4.25.3 <small>October 9, 2022</small> { id="4.25.3" }
- Fixed #4457: Posts not collected for standalone blog (4.24.2 regression)
### 4.25.2 <small>_ October 4, 2022</small> { id="4.25.2" }
### 4.25.2 <small>October 4, 2022</small> { id="4.25.2" }
- Fixed #4452: Blog and tags plugin crash when specifying slugify function
### 4.25.1 <small>_ October 3, 2022</small> { id="4.25.1" }
### 4.25.1 <small>October 3, 2022</small> { id="4.25.1" }
- Updated `mkdocs-rss-plugin` in `Dockerfile` to fix MkDocs compat errors
### 4.25.0 <small>_ October 2, 2022</small> { id="4.25.0" }
### 4.25.0 <small>October 2, 2022</small> { id="4.25.0" }
- Added support for navigation subtitles
- Added support for defining an allow list for built-in tags plugin
- Added support for custom slugify functions for built-in tags plugin
- Improved stability of search plugin when using `--dirtyreload`
### 4.24.2 <small>_ October 1, 2022</small> { id="4.24.2" }
### 4.24.2 <small>October 1, 2022</small> { id="4.24.2" }
- Updated MkDocs to 1.4
- Fixed compatibility issues with MkDocs 1.4
- Fixed incorrectly generated paths in privacy plugin
- Fixed blog index page not showing navigation when using meta plugin
### 4.24.1 <small>_ September 30, 2022</small> { id="4.24.1" }
### 4.24.1 <small>September 30, 2022</small> { id="4.24.1" }
- Fixed #4430: build error when enabling consent without repository URL
### 4.24.0 <small>_ September 27, 2022</small> { id="4.24.0" }
### 4.24.0 <small>September 27, 2022</small> { id="4.24.0" }
- Added support for custom content on index pages (blog)
- Added support for keeping content on paginated index pages (blog)
@ -98,265 +98,265 @@
- Fixed #4396: Front matter of index pages not inherited by pagination (blog)
- Improved performance by building post excerpts once (blog)
### 4.23.6 <small>_ September 22, 2022</small> { id="4.23.6" }
### 4.23.6 <small>September 22, 2022</small> { id="4.23.6" }
- Fixed #4389: Blog posts in first week of year in wrong archive
- Fixed (= switched) footer previous and next links for blog posts
### 4.23.5 <small>_ September 18, 2022</small> { id="4.23.5" }
### 4.23.5 <small>September 18, 2022</small> { id="4.23.5" }
- Fixed #4367: Improved blog plugin date handling for MultiMarkdown syntax
- Fixed #4374: Fixed invalid URLs of related links to other blog posts
### 4.23.4 <small>_ September 14, 2022</small> { id="4.23.4" }
### 4.23.4 <small>September 14, 2022</small> { id="4.23.4" }
- Fixed #4365: Recursion error in blog plugin due to `deepcopy`
- Fixed path errors for blog plugin on Windows
- Fixed publishing workflow in forked repositories
### 4.23.3 <small>_ September 13, 2022</small> { id="4.23.3" }
### 4.23.3 <small>September 13, 2022</small> { id="4.23.3" }
- Fixed previous and next page links for drafts of blog posts
### 4.23.2 <small>_ September 13, 2022</small> { id="4.23.2" }
### 4.23.2 <small>September 13, 2022</small> { id="4.23.2" }
- Fixed #4348: Blog plugin crashes on custom `nav` title
- Fixed blog plugin crashing when category contained only drafts
- Fixed rendering of content from blog index file
### 4.23.1 <small>_ September 12, 2022</small> { id="4.23.1" }
### 4.23.1 <small>September 12, 2022</small> { id="4.23.1" }
- Fixed #4345: Blog plugin errors with default settings
### 4.23.0 <small>_ September 12, 2022</small> { id="4.23.0" }
### 4.23.0 <small>September 12, 2022</small> { id="4.23.0" }
- Added blogging support via built-in blog plugin
### 4.22.1 <small>_ September 7, 2022</small> { id="4.22.1" }
### 4.22.1 <small>September 7, 2022</small> { id="4.22.1" }
- Fixed #4217: Tooltips in data tables render in wrong position
### 4.22.0 <small>_ August 21, 2022</small> { id="4.22.0" }
### 4.22.0 <small>August 21, 2022</small> { id="4.22.0" }
- Added support for navigation status
### 4.21.1 <small>_ August 13, 2022</small> { id="4.21.1" }
### 4.21.1 <small>August 13, 2022</small> { id="4.21.1" }
- Fixed #4176: Broken image when avatar is served by Gravatar
- Fixed #4212: Deferred search initialization for file:// locations
### 4.21.0 <small>_ July 17, 2022</small> { id="4.21.0" }
### 4.21.0 <small>July 17, 2022</small> { id="4.21.0" }
- Added meta plugin: set front matter for all pages in a folder
- Fixed #4114: Tags plugin fails if only `tags_extra_files` is set
### 4.20.1 <small>_ July 11, 2022</small> { id="4.20.1" }
### 4.20.1 <small>July 11, 2022</small> { id="4.20.1" }
- Fixed #4105: Tags plugin fails if `tags_file` is not set (4.20.0 regression)
### 4.20.0 <small>_ July 7, 2022</small> { id="4.20.0" }
### 4.20.0 <small>July 7, 2022</small> { id="4.20.0" }
- Added support for additional tags indexes
- Fixed #4100: Tag icons not shown in tags index
### 4.19.2 <small>_ July 4, 2022</small> { id="4.19.2" }
### 4.19.2 <small>July 4, 2022</small> { id="4.19.2" }
- Fixed #4051: Privacy plugin fails if symlinking isn't allowed on Windows
### 4.19.1 <small>_ June 25, 2022</small> { id="4.19.1" }
### 4.19.1 <small>June 25, 2022</small> { id="4.19.1" }
- Added `mkdocs-git-committers-plugin` to Dockerfile
- Added `mkdocs-git-revision-date-localized-plugin` to Dockerfile
### 4.19.0 <small>_ June 24, 2022</small> { id="4.19.0" }
### 4.19.0 <small>June 24, 2022</small> { id="4.19.0" }
- Added support for document contributors
- Updated French translations for cookie consent
### 4.18.2 <small>_ June 16, 2022</small> { id="4.18.2" }
### 4.18.2 <small>June 16, 2022</small> { id="4.18.2" }
- Fixed #4026: Fixed tooltips not mounted for nested navigation links
### 4.18.1 <small>_ June 14, 2022</small> { id="4.18.1" }
### 4.18.1 <small>June 14, 2022</small> { id="4.18.1" }
- Fixed #3990: Chinese search highlighting not working on non-boundaries
### 4.18.0 <small>_ June 11, 2022</small> { id="4.18.0" }
### 4.18.0 <small>June 11, 2022</small> { id="4.18.0" }
- Added support for automatic dark/light mode
- Fixed #4009: Privacy plugin uses invalid paths for file cache on Windows
### 4.17.2 <small>_ June 5, 2022</small> { id="4.17.2" }
### 4.17.2 <small>June 5, 2022</small> { id="4.17.2" }
- Added support for custom jieba dictionaries (Chinese search)
### 4.17.1 <small>_ June 5, 2022</small> { id="4.17.1" }
### 4.17.1 <small>June 5, 2022</small> { id="4.17.1" }
- Added support for cookie consent reject button
- Added support for cookie consent custom button ordering
- Fixed #3988: Content tab not focused after alternating anchor links
### 4.17.0 <small>_ June 4, 2022</small> { id="4.17.0" }
### 4.17.0 <small>June 4, 2022</small> { id="4.17.0" }
- Added support for content tabs anchor links (deep linking)
- Fixed #3975: Detect composition events in search interface (Chinese)
- Fixed #3980: Search plugin doesn't use title set via front matter
### 4.16.2 <small>_ May 29, 2022</small> { id="4.16.2" }
### 4.16.2 <small>May 29, 2022</small> { id="4.16.2" }
- Fixed #3961: Nested sections triggered build error for navigation tabs
### 4.16.1 <small>_ May 28, 2022</small> { id="4.16.1" }
### 4.16.1 <small>May 28, 2022</small> { id="4.16.1" }
- Switched feedback widget rating titles to tooltips
- Improved contrast of link colors for light/dark color schemes
- Fixed #3950: Sticky navigation tabs rendering broken (4.15.2 regression)
- Fixed #3958: Links invisible when using `white` primary color
### 4.16.0 <small>_ May 25, 2022</small> { id="4.16.0" }
### 4.16.0 <small>May 25, 2022</small> { id="4.16.0" }
- Added support for navigation pruning
- Fixed search results for non-segmented characters (4.15.2 regression)
### 4.15.2 <small>_ May 22, 2022</small> { id="4.15.2" }
### 4.15.2 <small>May 22, 2022</small> { id="4.15.2" }
- Removed workaround for `abbr` on touch devices (superseded by tooltips)
- Fixed #3915: Improved Chinese search query segmentation
- Fixed #3938: Fixed tooltips position for navigation titles with ellipsis
### 4.15.1 <small>_ May 14, 2022</small> { id="4.15.1" }
### 4.15.1 <small>May 14, 2022</small> { id="4.15.1" }
- Improved performance of element focus obervables
- Fixed #3531: Added prev/next buttons to content tabs
- Fixed tooltip positioning when host element is hidden
### 4.15.0 <small>_ May 8, 2022</small> { id="4.15.0" }
### 4.15.0 <small>May 8, 2022</small> { id="4.15.0" }
- Added support for improved tooltips
- Fixed #3785: Show tooltip on hover for overflowing navigation link
### 4.14.0 <small>_ May 5, 2022</small> { id="4.14.0" }
### 4.14.0 <small>May 5, 2022</small> { id="4.14.0" }
- Added Chinese language support to built-in search plugin
- Fixed all-numeric page titles raising error in social plugin
### 4.13.2 <small>_ April 30, 2022</small> { id="4.13.2" }
### 4.13.2 <small>April 30, 2022</small> { id="4.13.2" }
- Improved caching of downloaded resources in privacy plugin
- Fixed #3851: External images not downloaded by privacy plugin
### 4.13.1 <small>_ April 25, 2022</small> { id="4.13.1" }
### 4.13.1 <small>April 25, 2022</small> { id="4.13.1" }
- Fixed #3839: Tags plugin breaks without icons (4.13.0 regression)
### 4.13.0 <small>_ April 24, 2022</small> { id="4.13.0" }
### 4.13.0 <small>April 24, 2022</small> { id="4.13.0" }
- Added support for tag icons
### 4.12.0 <small>_ March 27, 2022</small> { id="4.12.0" }
### 4.12.0 <small>March 27, 2022</small> { id="4.12.0" }
- Added support for card grids and grid layouts
- Fixed #3685: Annotations sometimes broken when using instant loading
- Fixed #3742: Automatically add Mermaid.js when building for offline usage
### 4.11.0 <small>_ March 6, 2022</small> { id="4.11.0" }
### 4.11.0 <small>March 6, 2022</small> { id="4.11.0" }
- Added support for excluding external assets from privacy plugin
### 4.10.1 <small>_ March 2, 2022</small> { id="4.10.1" }
### 4.10.1 <small>March 2, 2022</small> { id="4.10.1" }
- 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
### 4.10.0 <small>_ February 27, 2022</small> { id="4.10.0" }
### 4.10.0 <small>February 27, 2022</small> { id="4.10.0" }
- 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
### 4.9.1 <small>_ February 21, 2022</small> { id="4.9.1" }
### 4.9.1 <small>February 21, 2022</small> { id="4.9.1" }
- Fixed #3610: missing `lxml` dependency for privacy plugin
- Fixed error when charset is missing in `content-type` header
### 4.9.0 <small>_ February 20, 2022</small> { id="4.9.0" }
### 4.9.0 <small>February 20, 2022</small> { id="4.9.0" }
- Added privacy plugin: automatic downloading of external assets
### 4.8.3 <small>_ February 13, 2022</small> { id="4.8.3" }
### 4.8.3 <small>February 13, 2022</small> { id="4.8.3" }
- Fixed #3560: Mermaid diagrams don't render for `file://` locations
### 4.8.2 <small>_ February 10, 2022</small> { id="4.8.2" }
### 4.8.2 <small>February 10, 2022</small> { id="4.8.2" }
- Fixed #3559: Mermaid diagrams don't render inside closed `details`
### 4.8.1 <small>_ February 6, 2022</small> { id="4.8.1" }
### 4.8.1 <small>February 6, 2022</small> { id="4.8.1" }
- Fixed jump back to top on mobile when using anchor following
### 4.8.0 <small>_ February 6, 2022</small> { id="4.8.0" }
### 4.8.0 <small>February 6, 2022</small> { id="4.8.0" }
- Added support for anchor following table of contents (= auto scroll)
### 4.7.2 <small>_ February 2, 2022</small> { id="4.7.2" }
### 4.7.2 <small>February 2, 2022</small> { id="4.7.2" }
- Fixed #3526: Transparent sidebar title due to Safari bug
- Fixed #3528: Firefox sometimes clips text in flow chart diagrams
### 4.7.1 <small>_ January 30, 2022</small> { id="4.7.1" }
### 4.7.1 <small>January 30, 2022</small> { id="4.7.1" }
- Fixed #3506: Tags index not respecting title set via front matter
### 4.7.0 <small>_ January 25, 2022</small> { id="4.7.0" }
### 4.7.0 <small>January 25, 2022</small> { id="4.7.0" }
- Added native support for offline search
### 4.6.1 <small>_ January 16, 2022</small> { id="4.6.1" }
### 4.6.1 <small>January 16, 2022</small> { id="4.6.1" }
- Fixed #3459: Section index pages picking up wrong title
### 4.6.0 <small>_ January 11, 2022</small> { id="4.6.0" }
### 4.6.0 <small>January 11, 2022</small> { id="4.6.0" }
- Added support for annotations (outside of code blocks)
### 4.5.2 <small>_ January 8, 2022</small> { id="4.5.2" }
### 4.5.2 <small>January 8, 2022</small> { id="4.5.2" }
- Fixed #3440: Content tab indicator not moving when using linking
- Fixed #3445: Content tab switch flickers/jitters when using linking
### 4.5.1 <small>_ January 2, 2022</small> { id="4.5.1" }
### 4.5.1 <small>January 2, 2022</small> { id="4.5.1" }
- Added support for setting initial state of cookie consent
- Fixed #3396: Disappearing link in navigation due to Safari bug
### 4.5.0 <small>_ December 16, 2021</small> { id="4.5.0" }
### 4.5.0 <small>December 16, 2021</small> { id="4.5.0" }
- Added support for navigation icons
### 4.4.0 <small>_ December 10, 2021</small> { id="4.4.0" }
### 4.4.0 <small>December 10, 2021</small> { id="4.4.0" }
- Added support for code annotation anchor links (deep linking)
- Added new code annotation syntax modifier to strip comment
- Updated German translations for cookie consent
### 4.3.0 <small>_ December 5, 2021</small> { id="4.3.0" }
### 4.3.0 <small>December 5, 2021</small> { id="4.3.0" }
- Added support for custom fonts in social cards
- Fixed #3300: Announcement bar reappearing when using instant loading
### 4.2.0 <small>_ December 2, 2021</small> { id="4.2.0" }
### 4.2.0 <small>December 2, 2021</small> { id="4.2.0" }
- Added support for dismissable announcement bar
- Added support for named placeholders in feedback widget
### 4.1.0 <small>_ November 30, 2021</small> { id="4.1.0" }
### 4.1.0 <small>November 30, 2021</small> { id="4.1.0" }
- Added support for passing page title to feedback forms
### 4.0.0 <small>_ November 28, 2021</small> { id="4.0.0" }
### 4.0.0 <small>November 28, 2021</small> { id="4.0.0" }
- Removed deprecated content tabs legacy implementation
- Removed deprecated `seealso` admonition type
@ -374,7 +374,7 @@
- Improved keyboard navigation for footnotes
- Fixed #3214: Search highlighting breaks site when empty
### 3.2.3 <small>_ November 20, 2021</small> { id="3.2.3" }
### 3.2.3 <small>November 20, 2021</small> { id="3.2.3" }
- Updated Swedish and French translations
- Removed support for `.mermaid-experimental` class (now `.mermaid`)
@ -382,56 +382,56 @@
- Fixed #3216: Cookie consent not dismissed when invoked via anchor
- Fixed #3232: Mermaid.js sometimes runs twice (race condition)
### 3.2.2 <small>_ November 6, 2021</small> { id="3.2.2" }
### 3.2.2 <small>November 6, 2021</small> { id="3.2.2" }
- Fixed always last feedback rating being sent
- Fixed #3145: Code annotations eat whole comment lines
- Fixed #3170: Feedback widget doesn't send data to GA4
### 3.2.1 <small>_ November 4, 2021</small> { id="3.2.1" }
### 3.2.1 <small>November 4, 2021</small> { id="3.2.1" }
- Added support for custom Mermaid.js version via additional JavaScript
- Fixed some configuration edge cases for tags plugin (3.1.5 regression)
- Fixed feedback widget title not being centered in Firefox
- Fixed #3179: Safari doesn't send request for feedback widget
### 3.2.0 <small>_ October 31, 2021</small> { id="3.2.0" }
### 3.2.0 <small>October 31, 2021</small> { id="3.2.0" }
- Added support for feedback widget (Was this page helpful?)
### 3.1.5 <small>_ October 28, 2021</small> { id="3.1.5" }
### 3.1.5 <small>October 28, 2021</small> { id="3.1.5" }
- Fixed #3144: Rogue link when using tags with auto-populated navigation
- Fixed #3147: Code block line numbers appear in search results
- Fixed #3158: Social cards do not strip HTML tags from title
### 3.1.4 <small>_ October 17, 2021</small> { id="3.1.4" }
### 3.1.4 <small>October 17, 2021</small> { id="3.1.4" }
- Fixed #2974: Text cropped with other fonts than `Roboto` in social plugin
- Fixed #3099: Encoding problems with non-latin character in social plugin
- Fixed #3112: Japanese segmenter not executed as part of new tokenizer
- Fixed tags (front matter) appearing in search with disabled tags plugin
### 3.1.3 <small>_ October 12, 2021</small> { id="3.1.3" }
### 3.1.3 <small>October 12, 2021</small> { id="3.1.3" }
- Added warnings to search plugin for unsupported options and syntax
- Fixed #3503: Search sometimes returns entire page
- Fixed #3089: Single-line code annotations disappear when printing
### 3.1.2 <small>_ October 6, 2021</small> { id="3.1.2" }
### 3.1.2 <small>October 6, 2021</small> { id="3.1.2" }
- Fixed incorrect path separators for social cards on Windows
### 3.1.1 <small>_ September 26, 2021</small> { id="3.1.1" }
### 3.1.1 <small>September 26, 2021</small> { id="3.1.1" }
- Fixed ordering bug in search exclusion logic
### 3.1.0 <small>_ September 26, 2021</small> { id="3.1.0" }
### 3.1.0 <small>September 26, 2021</small> { id="3.1.0" }
- Added support for excluding pages, sections, and elements from search
- Fixed #2803: Code block annotations not visible when printing
### 3.0.1 <small>_ September 19, 2021</small> { id="3.0.1" }
### 3.0.1 <small>September 19, 2021</small> { id="3.0.1" }
- Added support for using literal `h1-6` tags for search plugin
- Fixed search plugin breaking on void elements without slashes
@ -439,7 +439,7 @@
- Fixed search plugin handling of multiple `h1` headlines
- Fixed search plugin handling of missing `h1` headlines
### 3.0.0 <small>_ September 13, 2021</small> { id="3.0.0" }
### 3.0.0 <small>September 13, 2021</small> { id="3.0.0" }
- Rewrite of MkDocs' search plugin
- Added support for rich search previews
@ -447,41 +447,41 @@
- Improved search indexing performance (twice as fast)
- Improved search highlighting
### 2.13.3 <small>_ September 1, 2021</small> { id="2.13.3" }
### 2.13.3 <small>September 1, 2021</small> { id="2.13.3" }
- Added support for disabling social card generation
### 2.13.2 <small>_ August 25, 2021</small> { id="2.13.2" }
### 2.13.2 <small>August 25, 2021</small> { id="2.13.2" }
- Fixed #2965: Social plugin error when primary color is not defined
### 2.13.1 <small>_ August 21, 2021</small> { id="2.13.1" }
### 2.13.1 <small>August 21, 2021</small> { id="2.13.1" }
- Fixed #2948: Social cards are not cached
- Fixed #2953: Mermaid.js diagrams can't be centered anymore
### 2.13.0 <small>_ August 7, 2021</small> { id="2.13.0" }
### 2.13.0 <small>August 7, 2021</small> { id="2.13.0" }
- Added support for custom colors in social cards
### 2.12.2 <small>_ August 4, 2021</small> { id="2.12.2" }
### 2.12.2 <small>August 4, 2021</small> { id="2.12.2" }
- Fixed #2891: Division by zero error in social plugin
### 2.12.1 <small>_ July 26, 2021</small> { id="2.12.1" }
### 2.12.1 <small>July 26, 2021</small> { id="2.12.1" }
- Fixed error in social plugin when `site_description` was not set
- Fixed error in social plugin for non-ASCII characters
### 2.12.0 <small>_ July 25, 2021</small> { id="2.12.0" }
### 2.12.0 <small>July 25, 2021</small> { id="2.12.0" }
- Added support for social cards
### 2.11.1 <small>_ July 20, 2021</small> { id="2.11.1" }
### 2.11.1 <small>July 20, 2021</small> { id="2.11.1" }
- Fixed order of tags index, now sorted alphabetically
### 2.11.0 <small>_ July 18, 2021</small> { id="2.11.0" }
### 2.11.0 <small>July 18, 2021</small> { id="2.11.0" }
- Improved Mermaid.js intergration, now stable
- Added support for sequence diagrams
@ -489,193 +489,193 @@
- Added support for cookie consent configuration
- Added feature flag to always enable annotations
### 2.10.0 <small>_ July 10, 2021</small> { id="2.10.0" }
### 2.10.0 <small>July 10, 2021</small> { id="2.10.0" }
- Added support for cookie consent
- Fixed #2807: Back-to-top button not hidden when using sticky tabs
### 2.9.2 <small>_ May 30, 2021</small> { id="2.9.2" }
### 2.9.2 <small>May 30, 2021</small> { id="2.9.2" }
- Moved tags to partial for easier customization
- Added support for hiding tags on any page
### 2.9.1 <small>_ May 24, 2021</small> { id="2.9.1" }
### 2.9.1 <small>May 24, 2021</small> { id="2.9.1" }
- Added missing guard for linking of content tabs
### 2.9.0 <small>_ May 23, 2021</small> { id="2.9.0" }
### 2.9.0 <small>May 23, 2021</small> { id="2.9.0" }
- Added support for linking of content tabs
### 2.8.0 <small>_ May 12, 2021</small> { id="2.8.0" }
### 2.8.0 <small>May 12, 2021</small> { id="2.8.0" }
- Added support for boosting pages in search
### 2.7.2 <small>_ May 8, 2021</small> { id="2.7.2" }
### 2.7.2 <small>May 8, 2021</small> { id="2.7.2" }
- Fixed #2638: Warnings shown when using `tags` plugin without directory URLs
### 2.7.1 <small>_ May 3, 2021</small> { id="2.7.1" }
### 2.7.1 <small>May 3, 2021</small> { id="2.7.1" }
- Fixed `git-revision-date-localized` plugin integration (2.7.0 regression)
### 2.7.0 <small>_ May 1, 2021</small> { id="2.7.0" }
### 2.7.0 <small>May 1, 2021</small> { id="2.7.0" }
- Added support for tags (with search integration)
### 2.6.0 <small>_ April 11, 2021</small> { id="2.6.0" }
### 2.6.0 <small>April 11, 2021</small> { id="2.6.0" }
- Stay on page when switching versions
### 2.5.0 <small>_ March 28, 2021</small> { id="2.5.0" }
### 2.5.0 <small>March 28, 2021</small> { id="2.5.0" }
- Added support for version warning
### 2.4.0 <small>_ March 20, 2021</small> { id="2.4.0" }
### 2.4.0 <small>March 20, 2021</small> { id="2.4.0" }
- Added support for custom admonition icons
- Fixed #2444: Code block annotations with extra comments have wrong index
### 2.3.1 <small>_ March 14, 2021</small> { id="2.3.1" }
### 2.3.1 <small>March 14, 2021</small> { id="2.3.1" }
- Fixed anchor offset for permalinks when using sticky navigation tabs
### 2.3.0 <small>_ March 13, 2021</small> { id="2.3.0" }
### 2.3.0 <small>March 13, 2021</small> { id="2.3.0" }
- Added support for back-to-top button
### 2.2.1 <small>_ March 4, 2021</small> { id="2.2.1" }
### 2.2.1 <small>March 4, 2021</small> { id="2.2.1" }
- Fixed #2382: Repository stats failing when no release tag is present
### 2.2.0 <small>_ February 28, 2021</small> { id="2.2.0" }
### 2.2.0 <small>February 28, 2021</small> { id="2.2.0" }
- Added support for code block annotations
### 2.1.0 <small>_ February 26, 2021</small> { id="2.1.0" }
### 2.1.0 <small>February 26, 2021</small> { id="2.1.0" }
- Added support for anchor tracking
### 2.0.0 <small>_ February 24, 2021</small> { id="2.0.0" }
### 2.0.0 <small>February 24, 2021</small> { id="2.0.0" }
- Migrated Insiders to the new architecture
- Swapped color palette toggle configuration
### 1.17.0 <small>_ January 31, 2021</small> { id="1.17.0" }
### 1.17.0 <small>January 31, 2021</small> { id="1.17.0" }
- Added support for section index pages
### 1.16.1 <small>_ January 26, 2021</small> { id="1.16.1" }
### 1.16.1 <small>January 26, 2021</small> { id="1.16.1" }
- Fixed #2249: Instant loading + sticky tabs result in invalid links
- Fixed #2248: Search highlighting URL parameter always added
- Fixed #2235: Version selector doesn't select current version for aliases
### 1.16.0 <small>_ January 7, 2021</small> { id="1.16.0" }
### 1.16.0 <small>January 7, 2021</small> { id="1.16.0" }
- Added latest release to repository info (GitHub)
- Slight facelift of repository info (lighter fonts, spacing and icons)
### 1.15.0 <small>_ January 2, 2021</small> { id="1.15.0" }
### 1.15.0 <small>January 2, 2021</small> { id="1.15.0" }
- Added support for native Mermaid.js integration
### 1.14.0 <small>_ December 30, 2020</small> { id="1.14.0" }
### 1.14.0 <small>December 30, 2020</small> { id="1.14.0" }
- Added support for sharing searches
### 1.13.2 <small>_ December 22, 2020</small> { id="1.13.2" }
### 1.13.2 <small>December 22, 2020</small> { id="1.13.2" }
- Fixed version selector + sticky tabs navigation rendering issues
- Fixed version selector wrapping
### 1.13.1 <small>_ December 20, 2020</small> { id="1.13.1" }
### 1.13.1 <small>December 20, 2020</small> { id="1.13.1" }
- Removed horizontal scrollbars on language and version selector
- Fixed type conversion in JavaScript config
### 1.13.0 <small>_ December 13, 2020</small> { id="1.13.0" }
### 1.13.0 <small>December 13, 2020</small> { id="1.13.0" }
- Refactored navigation tabs to simplify grouping behavior
- Added support for sticky navigation tabs
- Added support for arbitrary links in navigation tabs
- Fixed #2098: Subsequent active subsection not highlighted correctly
### 1.12.1 <small>_ December 8, 2020</small> { id="1.12.1" }
### 1.12.1 <small>December 8, 2020</small> { id="1.12.1" }
- Fixed empty language selector being shown
### 1.12.0 <small>_ December 6, 2020</small> { id="1.12.0" }
### 1.12.0 <small>December 6, 2020</small> { id="1.12.0" }
- Added support for adding a language selector
### 1.11.2 <small>_ November 29, 2020</small> { id="1.11.2" }
### 1.11.2 <small>November 29, 2020</small> { id="1.11.2" }
- Fixed #2068: Search highlight interprets code blocks as JavaScript
### 1.11.1 <small>_ November 29, 2020</small> { id="1.11.1" }
### 1.11.1 <small>November 29, 2020</small> { id="1.11.1" }
- Refactored styling to be more stable and easier to adjust
- Fixed some styling regressions from latest features
### 1.11.0 <small>_ November 22, 2020</small> { id="1.11.0" }
### 1.11.0 <small>November 22, 2020</small> { id="1.11.0" }
- Added support for rendering admonitions as inline blocks
### 1.10.0 <small>_ November 15, 2020</small> { id="1.10.0" }
### 1.10.0 <small>November 15, 2020</small> { id="1.10.0" }
- Added support for integrating table of contents into navigation
### 1.9.0 <small>_ November 7, 2020</small> { id="1.9.0" }
### 1.9.0 <small>November 7, 2020</small> { id="1.9.0" }
- Added support for hiding navigation and table of contents on any page
- Removed autohiding table of contents when empty
### 1.8.0 <small>_ November 1, 2020</small> { id="1.8.0" }
### 1.8.0 <small>November 1, 2020</small> { id="1.8.0" }
- Added support for navigation sections
- Fixed appearance of inactive search suggestions
### 1.7.0 <small>_ October 25, 2020</small> { id="1.7.0" }
### 1.7.0 <small>October 25, 2020</small> { id="1.7.0" }
- Added support for deploying multiple versions
- Fixed alignment of sidebar when content area is too small
### 1.6.0 <small>_ October 11, 2020</small> { id="1.6.0" }
### 1.6.0 <small>October 11, 2020</small> { id="1.6.0" }
- Added support for search suggestions to save keystrokes
- Added support for removing __Made with Material for MkDocs__ from footer
- Fixed #1915: search should go to first result by pressing ++enter++
### 1.5.1 <small>_ September 21, 2020</small> { id="1.5.1" }
### 1.5.1 <small>September 21, 2020</small> { id="1.5.1" }
- Fixed content area stretching to whole width for long code blocks
### 1.5.0 <small>_ September 19, 2020</small> { id="1.5.0" }
### 1.5.0 <small>September 19, 2020</small> { id="1.5.0" }
- Added support for autohiding table of contents when empty
### 1.4.1 <small>_ September 6, 2020</small> { id="1.4.1" }
### 1.4.1 <small>September 6, 2020</small> { id="1.4.1" }
- Improved typeahead and search result relevance and scoring
### 1.4.0 <small>_ August 30, 2020</small> { id="1.4.0" }
### 1.4.0 <small>August 30, 2020</small> { id="1.4.0" }
- Added support for autohiding header on scroll
### 1.3.0 <small>_ August 26, 2020</small> { id="1.3.0" }
### 1.3.0 <small>August 26, 2020</small> { id="1.3.0" }
- Added support for user-selectable color palettes
### 1.2.0 <small>_ August 11, 2020</small> { id="1.2.0" }
### 1.2.0 <small>August 11, 2020</small> { id="1.2.0" }
- Added feature to expand navigation by default
### 1.1.0 <small>_ August 3, 2020</small> { id="1.1.0" }
### 1.1.0 <small>August 3, 2020</small> { id="1.1.0" }
- Added highlighting of search results
### 1.0.0 <small>_ July 14, 2020</small> { id="1.0.0" }
### 1.0.0 <small>July 14, 2020</small> { id="1.0.0" }
- Added grouping of search results
- Added missing query terms to search result

View File

@ -34,8 +34,7 @@ See additional configuration options:
### Admonition icons
[:octicons-tag-24: 8.3.0][Admonition icons support] ·
:octicons-beaker-24: Experimental
[:octicons-tag-24: 8.3.0][Admonition icons support]
Each of the supported admonition types has a distinct icon, which can be changed
to any icon bundled with the theme, or even a [custom icon]. Add the following
@ -230,9 +229,6 @@ Adding a `+` after the `???` token renders the block expanded:
### Inline blocks
[:octicons-tag-24: 7.0.0][Inline blocks support] ·
:octicons-beaker-24: Experimental
Admonitions can also be rendered as inline blocks (i.e. for sidebars), placing
them to the right using the `inline` + `end` modifiers, or to the left using
only the `inline` modifier:
@ -282,8 +278,6 @@ prior to the content block you want to place them beside. If there's
insufficient space to render the admonition next to the block, the admonition
will stretch to the full width of the viewport, e.g. on mobile viewports.
[Inline blocks support]: https://github.com/squidfunk/mkdocs-material/releases/tag/7.0.0
### Supported types
Following is a list of type qualifiers provided by Material for MkDocs, whereas

View File

@ -1,5 +1,5 @@
---
icon: material/gesture-tap-button
icon: material/button-cursor
---
# Buttons

View File

@ -75,8 +75,7 @@ or to the [publishing guide for Insiders][tab_2].
### Linked content tabs
[:octicons-tag-24: 8.3.0][Linked content tabs support] ·
:octicons-unlock-24: Feature flag ·
:octicons-beaker-24: Experimental
:octicons-unlock-24: Feature flag
When enabled, all content tabs across the whole documentation site will be
linked and switch to the same label when the user clicks on a tab. Add the

View File

@ -13,8 +13,7 @@ popular and flexible solution for drawing diagrams.
## Configuration
[:octicons-tag-24: 8.2.0][Diagrams support] ·
:octicons-beaker-24: Experimental
[:octicons-tag-24: 8.2.0][Diagrams support]
This configuration enables native support for [Mermaid.js] diagrams. Material
for MkDocs will automatically initialize the JavaScript runtime when a page
@ -91,6 +90,7 @@ between those actors:
```` markdown title="Sequence diagram"
``` mermaid
sequenceDiagram
autonumber
Alice->>John: Hello John, how are you?
loop Healthcheck
John->>John: Fight against hypochondria
@ -106,6 +106,7 @@ sequenceDiagram
``` mermaid
sequenceDiagram
autonumber
Alice->>John: Hello John, how are you?
loop Healthcheck
John->>John: Fight against hypochondria

View File

@ -154,8 +154,7 @@ browsers without support:
### Light and dark mode
[:octicons-tag-24: 8.1.1][Light and dark mode support] ·
:octicons-beaker-24: Experimental
[:octicons-tag-24: 8.1.1][Light and dark mode support]
If you added a [color palette toggle] and want to show different images for
light and dark color schemes, you can append a `#only-light` or `#only-dark`

View File

@ -214,7 +214,8 @@
]
}
]
}
},
"uniqueItems": true
}
},
"additionalProperties": false,

View File

@ -25,6 +25,9 @@
{
"$ref": "plugins/blog.json"
},
{
"$ref": "plugins/info.json"
},
{
"$ref": "plugins/meta.json"
},

View File

@ -254,6 +254,7 @@
"items": {
"type": "string"
},
"uniqueItems": true,
"default": []
},
"pagination": {

View File

@ -27,7 +27,9 @@
"type": "array",
"items": {
"pattern": "(\\*|\\.md)$"
}
},
"uniqueItems": true,
"minItems": 1
}
},
"additionalProperties": false

View File

@ -0,0 +1,31 @@
{
"$schema": "https://json-schema.org/draft-07/schema",
"title": "Built-in info plugin",
"oneOf": [
{
"markdownDescription": "https://squidfunk.github.io/mkdocs-material/reporting-an-issue/#creating-a-zip-file",
"enum": [
"info"
]
},
{
"type": "object",
"properties": {
"info": {
"markdownDescription": "https://squidfunk.github.io/mkdocs-material/reporting-an-issue/#creating-a-zip-file",
"type": "object",
"properties": {
"enabled": {
"title": "Enable plugin",
"markdownDescription": "https://squidfunk.github.io/mkdocs-material/reporting-an-issue/#creating-a-zip-file",
"type": "boolean",
"default": true
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
]
}

View File

@ -36,6 +36,19 @@
"markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/setting-up-site-search/#+search.separator",
"type": "string"
},
"pipeline": {
"title": "Text processing pipeline for indexing",
"markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/setting-up-site-search/#+search.pipeline",
"type": "array",
"items": {
"enum": [
"stemmer",
"stopWordFilter",
"trimmer"
]
},
"uniqueItems": true
},
"jieba_dict": {
"title": "Jieba dictionary replacement",
"markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/setting-up-site-search/#+search.jieba_dict",

View File

@ -36,7 +36,8 @@
"type": "array",
"items": {
"type": "string"
}
},
"uniqueItems": true
}
},
"additionalProperties": false
@ -59,6 +60,7 @@
"items": {
"type": "string"
},
"uniqueItems": true,
"default": []
}
},

View File

@ -834,20 +834,6 @@
}
}
]
},
"include_search_page": {
"title": "Only necessary when installing from git",
"markdownDescription": "Must be set to `false`",
"enum": [
false
]
},
"search_index_only": {
"title": "Only necessary when installing from git",
"markdownDescription": "Must be set to `false`",
"enum": [
true
]
}
},
"additionalProperties": false,

View File

@ -11,8 +11,7 @@ support for many of its features.
### Built-in offline plugin
[:octicons-heart-fill-24:{ .mdx-heart } Sponsors only][Insiders]{ .mdx-insiders } ·
[:octicons-tag-24: insiders-4.10.0][Insiders] ·
[:octicons-tag-24: 9.0.0][offline support] ·
:octicons-cpu-24: Plugin
The built-in offline plugin makes sure that the [site search] works when you
@ -24,13 +23,9 @@ plugins:
- offline
```
> If you need to be able to build your documentation with and without
> [Insiders], please refer to the [built-in plugins] section to learn how
> shared configurations help to achieve this.
The plugin will automatically disable [`use_directory_urls`][use_directory_urls]
via `mkdocs.yml`, ensuring that users can open your documentation directly
from the local file system.
The plugin will automatically disable the [`use_directory_urls`][use_directory_urls]
setting, ensuring that users can open your documentation directly from the local
file system.
The following configuration options are available:
@ -52,14 +47,13 @@ hosted on a regular server.
!!! tip "Automatically bundle all external assets"
The brand-new [built-in privacy plugin] makes it easy to use external assets
The [built-in privacy plugin] makes it easy to use external assets
while building documentation for offline usage, as it will automatically
download all external assets to distribute them with your documentation.
[Insiders]: ../insiders/index.md
[offline support]: https://github.com/squidfunk/mkdocs-material/releases/tag/9.0.0
[site search]: setting-up-site-search.md
[site directory]: https://www.mkdocs.org/user-guide/configuration/#site_dir
[built-in plugins]: ../insiders/getting-started.md#built-in-plugins
[use_directory_urls]: https://www.mkdocs.org/user-guide/configuration/#use_directory_urls
[environment variable]: https://www.mkdocs.org/user-guide/configuration/#environment-variables
[built-in privacy plugin]: ensuring-data-privacy.md#built-in-privacy-plugin

View File

@ -64,7 +64,7 @@ theme:
!!! tip "Automatically bundle Google Fonts"
The brand-new [built-in privacy plugin] makes it easy to use Google Fonts
The [built-in privacy plugin] makes it easy to use Google Fonts
while complying with the __General Data Protection Regulation__ (GDPR),
by automatically downloading and self-hosting the web font files.

View File

@ -58,7 +58,7 @@ The following languages are supported:
- `it` Italian
- `ja` Japanese
- `ka` Georgian
- `kr` Korean
- `ko` Korean
- `lt` Lithuanian
- `lv` Latvian
- `mk` Macedonian
@ -105,8 +105,7 @@ the default slug function works. Consider using a [Unicode-aware slug function].
### Site language selector
[:octicons-tag-24: 7.0.0][Site language selector support] ·
:octicons-milestone-24: Default: _none_ ·
:octicons-beaker-24: Experimental
:octicons-milestone-24: Default: _none_
If your documentation is available in multiple languages, a language selector
pointing to those languages can be added to the header. Alternate languages

View File

@ -82,7 +82,7 @@ Next, add your `*.svg` icons into a subfolder of the `.icons` folder. Let's say
you downloaded and unpacked the [Bootstrap] icon set, and want to add it to
your project documentation. The structure of your project should look like this:
``` sh
``` { .sh .no-copy }
.
├─ overrides/
│ └─ .icons/

View File

@ -360,7 +360,7 @@ removed during the build process.
For the official documentation, the [built-in privacy plugin] downloads the
following resources:
``` { .sh id="example" }
``` { .sh .no-copy #example }
.
└─ assets/external/
├─ unpkg.com/tablesort@5.3.0/dist/tablesort.min.js

View File

@ -45,7 +45,7 @@ By default, the built-in blog plugin assumes that your blog is hosted inside
the `blog` subfolder of your documentation ([this is configurable]). Next,
you need to create the following structure:
``` sh
``` { .sh .no-copy }
.
├─ docs/
│ └─ blog/
@ -935,7 +935,7 @@ your first post. The plugin doesn't assume any specific directory structure, so
you're completely free in how you organize your posts, as long as they are all
located inside the `posts` directory:
``` sh
``` { .sh .no-copy }
.
├─ docs/
│ └─ blog/
@ -1213,7 +1213,7 @@ for each post. Luckily, the [built-in meta plugin] allows to set default front
matter properties per folder. You can group your posts by categories, or
authors, and add a `.meta.yml` file to set common properties:
``` sh
``` { .sh .no-copy }
.
├─ docs/
│ └─ blog/
@ -1278,7 +1278,7 @@ If you want to add custom content to automatically generated [archive] and
posts, you can manually create the category page in the same location where
the [built-in blog plugin] would create it:
``` sh
``` { .sh .no-copy }
.
├─ docs/
│ └─ blog/

View File

@ -37,8 +37,7 @@ especially useful for large documentation sites.
### Anchor tracking
[:octicons-tag-24: 8.0.0][Anchor tracking support] ·
:octicons-unlock-24: Feature flag ·
:octicons-beaker-24: Experimental
:octicons-unlock-24: Feature flag
When anchor tracking is enabled, the URL in the address bar is automatically
updated with the active anchor as highlighted in the table of contents. Add the

View File

@ -67,8 +67,7 @@ following lines to `mkdocs.yml`:
### Was this page helpful?
[:octicons-tag-24: 8.4.0][Was this page helpful? support] ·
:octicons-milestone-24: Default: _none_ ·
:octicons-beaker-24: Experimental
:octicons-milestone-24: Default: _none_
A simple [feedback widget] can be included at the bottom of each page,
encouraging users to give instant feedback whether a page was helpful or not.

View File

@ -44,7 +44,7 @@ The following configuration options are supported:
``` yaml
plugins:
- search:
lang: ru
lang: en
```
=== "Multiple languages"
@ -54,7 +54,7 @@ The following configuration options are supported:
- search:
lang: # (1)!
- en
- ru
- de
```
1. Be aware that including support for other languages increases the
@ -101,48 +101,85 @@ The following configuration options are supported:
``` yaml
plugins:
- search:
separator: '[\s\-\.]' # (1)!
separator: '[\s\-\.]+'
```
1. Tokenization itself is carried out by [lunr's default tokenizer], which
doesn't allow for lookahead or multi-character separators. For more
finegrained control over the tokenization process, see the section on
[tokenizer lookahead].
<div class="mdx-deprecated" markdown>
[`prebuild_index`](#+search.prebuild_index){ #+search.prebuild_index }
: [:octicons-tag-24: 5.0.0][prebuilt index support] · :octicons-archive-24:
Deprecated · :octicons-trash-24: 8.0.0 · :octicons-milestone-24: Default:
`false` MkDocs can generate a [prebuilt index] of all pages during
build time, which provides performance improvements at the cost of more
bandwidth, as it reduces the build time of the search index:
With :octicons-tag-24: 9.0.0, a faster and more flexible tokenizer method
is shipped, allowing for __tokenizing with lookahead__, which yields more
influence on the way documents are indexed. As a result, we use the
following separator setting for this site's search:
``` yaml
plugins:
- search:
prebuild_index: true
separator: '[\s\-,:!=\[\]()"/]+|(?!\b)(?=[A-Z][a-z])|\.(?!\d)|&[lg]t;'
```
Note that this configuration option was removed, as the [new search
plugin] generates up to [50% smaller] search indexes, doubling search
performance.
Broken into its parts, the separator induces the following behavior:
[:octicons-arrow-right-24: Read more on the new search plugin]
[new search plugin]
=== "Special characters"
</div>
```
[\s\-,:!=\[\]()"/]+
```
The first part of the expression inserts token boundaries for each
document before and after whitespace, hyphens, commas, brackets and
other special characters. If several of those special characters are
adjacent, they are treated as one.
=== "Case changes"
```
(?!\b)(?=[A-Z][a-z])
```
Many programming languages have naming conventions like `PascalCase` or
`camelCase`. By adding this subexpression to the separator,
[words are split at case changes], tokenizing the word `PascalCase`
into `Pascal` and `Case`.
[:octicons-arrow-right-24: Read more on tokenizing case changes]
[tokenize case changes]
=== "Version strings"
```
\.(?!\d)
```
When adding `.` to the separator, version strings like `1.2.3` are split
into `1`, `2` and `3`, which makes them undiscoverable via search. When
using this subexpression, a small lookahead is introduced which will
[preserve version strings] and keep them discoverable.
[:octicons-arrow-right-24: Read more on tokenizing version numbers]
[tokenize version numbers]
=== "HTML/XML tags"
```
&[lg]t;
```
If your documentation includes HTML/XML code examples, you may want to allow
users to find specific tag names. Unfortunately, the `<` and `>` control
characters are encoded in code blocks as `&lt;` and `&gt;`. Adding this
subexpression to the separator allows for just that.
[:octicons-arrow-right-24: Read more on tokenizing HTML/XML tags]
[tokenize html-xml tags]
[Search support]: https://github.com/squidfunk/mkdocs-material/releases/tag/0.1.0
[lunr]: https://lunrjs.com
[lunr-languages]: https://github.com/MihaiValentin/lunr-languages
[lunr's default tokenizer]: https://github.com/olivernn/lunr.js/blob/aa5a878f62a6bba1e8e5b95714899e17e8150b38/lunr.js#L413-L456
[site language]: changing-the-language.md#site-language
[tokenizer lookahead]: #tokenizer-lookahead
[prebuilt index support]: https://github.com/squidfunk/mkdocs-material/releases/tag/5.0.0
[prebuilt index]: https://www.mkdocs.org/user-guide/configuration/#prebuild_index
[50% smaller]: ../blog/posts/search-better-faster-smaller.md#benchmarks
[words are split at case changes]: ?q=searchHighlight
[preserve version strings]: ?q=9.0.0
[tokenize case changes]: ../blog/posts/search-better-faster-smaller.md#case-changes
[tokenize version numbers]: ../blog/posts/search-better-faster-smaller.md#version-numbers
[tokenize html-xml tags]: ../blog/posts/search-better-faster-smaller.md#htmlxml-tags
#### Chinese language support
@ -195,6 +232,7 @@ configuration options are available:
User dictionaries can be used for tuning the segmenter to preserve
technical terms.
[Insiders]: ../insiders/index.md
[chinese search]: ../blog/posts/chinese-search-support.md
[jieba]: https://pypi.org/project/jieba/
[built-in search plugin]: #built-in-search-plugin
@ -203,96 +241,6 @@ configuration options are available:
[dict.txt.big]: https://github.com/fxsjy/jieba/raw/master/extra_dict/dict.txt.big
[user dictionary]: https://github.com/fxsjy/jieba#%E8%BD%BD%E5%85%A5%E8%AF%8D%E5%85%B8
### Rich search previews
[:octicons-heart-fill-24:{ .mdx-heart } Sponsors only][Insiders]{ .mdx-insiders } ·
[:octicons-tag-24: insiders-3.0.0][Insiders] ·
:octicons-beaker-24: Experimental
[Insiders] ships rich search previews as part of the [new search plugin], which
will render code blocks directly in the search result, and highlight all
occurrences inside those blocks:
=== "Insiders"
![search preview now]
=== "Material for MkDocs"
![search preview before]
[Insiders]: ../insiders/index.md
[new search plugin]: ../blog/posts/search-better-faster-smaller.md
[search preview now]: ../blog/posts/search-better-faster-smaller/search-preview-now.png
[search preview before]: ../blog/posts/search-better-faster-smaller/search-preview-before.png
### Tokenizer lookahead
[:octicons-heart-fill-24:{ .mdx-heart } Sponsors only][Insiders]{ .mdx-insiders } ·
[:octicons-tag-24: insiders-3.0.0][Insiders] ·
:octicons-beaker-24: Experimental
[Insiders] allows for more complex configurations of the [`separator`][separator]
setting as part of the [new search plugin], yielding more influence on the way
documents are tokenized:
``` yaml
plugins:
- search:
separator: '[\s\-,:!=\[\]()"/]+|\.(?!\d)|&[lg]t;|(?!\b)(?=[A-Z][a-z])'
```
The following section explains what can be achieved with tokenizer lookahead:
=== "Case changes"
```
(?!\b)(?=[A-Z][a-z])
```
`PascalCase` and `camelCase` are used as naming conventions in many
programming languages. By adding this match group to the [`separator`]
[separator], [words are split at case changes], tokenizing the word
`PascalCase` into `Pascal` and `Case`, so both terms can be searched
individually.
[:octicons-arrow-right-24: Read more on tokenizing case changes]
[tokenize case changes]
=== "Version numbers"
```
\.(?!\d)
```
When `.` is added to the [`separator`][separator], version numbers would be
split into parts, rendering them undiscoverable via search. By adding
this match group, a small lookahead is introduced, so version numbers will
remain as they are, and can be found through search.
[:octicons-arrow-right-24: Read more on tokenizing version numbers]
[tokenize version numbers]
=== "HTML/XML tags"
```
&[lg]t;
```
If your documentation includes HTML/XML code examples, you may want to allow
users to find specific tag names. Unfortunately, the `<` and `>` control
characters are encoded in code blocks as `&lt;` and `&gt;`. Adding this
expression to the separator allows for just that.
[:octicons-arrow-right-24: Read more on tokenizing HTML/XML tags]
[tokenize html-xml tags]
[separator]: #search-separator
[words are split at case changes]: ?q=searchHighlight
[tokenize case changes]: ../blog/posts/search-better-faster-smaller.md#case-changes
[tokenize version numbers]: ../blog/posts/search-better-faster-smaller.md#version-numbers
[tokenize html-xml tags]: ../blog/posts/search-better-faster-smaller.md#htmlxml-tags
### Search suggestions
[:octicons-tag-24: 7.2.0][Search suggestions support] ·
@ -340,8 +288,7 @@ highlights all occurrences of both terms.
### Search sharing
[:octicons-tag-24: 7.2.0][Search sharing support] ·
:octicons-unlock-24: Feature flag ·
:octicons-beaker-24: Experimental
:octicons-unlock-24: Feature flag
When search sharing is activated, a :material-share-variant: share button is
rendered next to the reset button, which allows to deep link to the current
@ -362,32 +309,44 @@ clipboard.
### Search boosting
[:octicons-tag-24: 8.3.0][boost support] ·
:octicons-beaker-24: Experimental
[:octicons-tag-24: 8.3.0][boost support]
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:
``` yaml
---
search:
boost: 2 # (1)!
---
=== ":material-arrow-up-circle: Rank up"
# Document title
...
```
``` yaml
---
search:
boost: 2 # (1)!
---
1. :woman_in_lotus_position: When boosting pages, be gentle and start with
__low values__.
# Document title
...
```
1. :woman_in_lotus_position: When boosting pages, be gentle and start with
__low values__.
=== ":material-arrow-down-circle: Rank down"
``` yaml
---
search:
boost: 0.5
---
# Document title
...
```
[boost support]: https://github.com/squidfunk/mkdocs-material/releases/tag/8.3.0
### Search exclusion
[:octicons-heart-fill-24:{ .mdx-heart } Sponsors only][Insiders]{ .mdx-insiders } ·
[:octicons-tag-24: insiders-3.1.0][Insiders] ·
[:octicons-tag-24: 9.0.0][exclusion support] ·
:octicons-beaker-24: Experimental
Pages can be excluded from search with the front matter `search.exclude`
@ -404,10 +363,12 @@ search:
...
```
[exclusion support]: https://github.com/squidfunk/mkdocs-material/releases/tag/9.0.0
#### Excluding sections
When [Attribute Lists] is enabled, specific sections of pages can be excluded
from search by adding the `{ data-search-exclude }` pragma after a Markdown
from search by adding the `data-search-exclude` pragma after a Markdown
heading:
=== ":octicons-file-code-16: `docs/page.md`"
@ -449,7 +410,7 @@ heading:
#### Excluding blocks
When [Attribute Lists] is enabled, specific sections of pages can be excluded
from search by adding the `{ data-search-exclude }` pragma after a Markdown
from search by adding the `data-search-exclude` pragma after a Markdown
inline- or block-level element:
=== ":octicons-file-code-16: `docs/page.md`"
@ -477,112 +438,3 @@ inline- or block-level element:
]
}
```
## Customization
The search implementation of Material for MkDocs is probably its most
sophisticated feature, as it tries to balance a great typeahead experience,
good performance, accessibility, and a result list that is easy to scan.
This is where Material for MkDocs deviates from other themes.
The following section explains how search can be customized to tailor it to
your needs.
### Query transformation
When a user enters a query into the search box, the query is pre-processed
before it is submitted to the search index. Material for MkDocs will apply the
following transformations, which can be customized by [extending the theme]:
``` ts
export function defaultTransform(query: string): string {
return query
.split(/"([^"]+)"/g) /* (1)! */
.map((terms, index) => index & 1
? terms.replace(/^\b|^(?![^\x00-\x7F]|$)|\s+/g, " +")
: terms
)
.join("")
.replace(/"|(?:^|\s+)[*+\-:^~]+(?=\s+|$)/g, "") /* (2)! */
.trim() /* (3)! */
}
```
1. Search for terms in quotation marks and prepend a `+` modifier to denote
that the resulting document must contain all terms, converting the query
to an `AND` query (as opposed to the default `OR` behavior). While users
may expect terms enclosed in quotation marks to map to span queries, i.e.
for which order is important, `lunr` doesn't support them, so the best
we can do is to convert the terms to an `AND` query.
2. Replace control characters which are not located at the beginning of the
query or preceded by white space, or are not followed by a non-whitespace
character or are at the end of the query string. Furthermore, filter
unmatched quotation marks.
3. Trim excess whitespace from left and right.
If you want to switch to the default behavior of the `mkdocs` and `readthedocs`
themes, both of which don't transform the query prior to submission, or
customize the `transform` function, you can do this by [overriding the
`config` block][overriding blocks]:
``` html
{% extends "base.html" %}
{% block config %}
{{ super() }}
<script>
var __search = {
transform: function(query) {
return query
}
}
</script>
{% endblock %}
```
The `transform` function will receive the query string as entered by the user
and must return the processed query string to be submitted to the search index.
[extending the theme]: ../customization.md#extending-the-theme
[overriding blocks]: ../customization.md#overriding-blocks
### Custom search
Material for MkDocs implements search as part of a [web worker]. If you
want to switch the web worker with your own implementation, e.g. to submit
search to an external service, you can add a custom JavaScript file to the
`docs` directory and [override the `config` block][overriding blocks]:
``` html
{% extends "base.html" %}
{% block config %}
{{ super() }}
<script>
var __search = {
worker: "<url>"
}
</script>
{% endblock %}
```
Communication with the search worker is implemented using a designated message
format using discriminated unions, i.e. through the `type` property of the
message. See the following interface definitions to learn about the message
formats:
- [:octicons-file-code-24: `SearchMessage`][SearchMessage]
- [:octicons-file-code-24: `SearchIndex` and `SearchResult`][SearchIndex]
The sequence and direction of messages is rather intuitive:
- :octicons-arrow-right-24: `SearchSetupMessage`
- :octicons-arrow-left-24: `SearchReadyMessage`
- :octicons-arrow-right-24: `SearchQueryMessage`
- :octicons-arrow-left-24: `SearchResultMessage`
[web worker]: https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Using_web_workers
[SearchMessage]: https://github.com/squidfunk/mkdocs-material/blob/master/src/assets/javascripts/integrations/search/worker/message/index.ts
[SearchIndex]: https://github.com/squidfunk/mkdocs-material/blob/master/src/assets/javascripts/integrations/search/_/index.ts

View File

@ -12,8 +12,7 @@ can help to discover relevant information faster.
### Built-in tags plugin
[:octicons-tag-24: 8.2.0][Tags support] ·
:octicons-cpu-24: Plugin ·
:octicons-beaker-24: Experimental
:octicons-cpu-24: Plugin
The built-in tags plugin adds the ability to categorize any page with tags
as part of the front matter of the page. In order to add support for tags, add

View File

@ -3,7 +3,7 @@
Upgrade to the latest version with:
```
pip install --upgrade mkdocs-material
pip install --upgrade --force-reinstall mkdocs-material
```
Show the currently installed version with:
@ -12,6 +12,75 @@ Show the currently installed version with:
pip show mkdocs-material
```
## Upgrading from 8.x to 9.x
This major release includes a brand new search implementation that is faster
and allows for rich previews, advanced tokenization and better highlighting.
It was available as part of Insiders for over a year, and now that the funding
goal was hit, makes its way into the community edition.
### Changes to `mkdocs.yml`
#### `content.code.copy`
The copy-to-clipboard buttons are now opt-in and can be enabled or disabled
per block. If you wish to enable them for all code blocks, add the following
lines to `mkdocs.yml`:
``` yaml
theme:
features:
- content.code.copy
```
#### `content.action.*`
A "view source" button can be shown next to the "edit this page" button, both
of which must now be explicitly enabled. Add the following lines to
`mkdocs.yml`:
``` yaml
theme:
features:
- content.action.edit
- content.action.view
```
#### `navigation.footer`
The _previous_ and _next_ buttons in the footer are now opt-in. If you wish to
keep them for your documentation, add the following lines to `mkdocs.yml`:
``` yaml
theme:
features:
- navigation.footer
```
#### `theme.language`
The Korean and Norwegian language codes were renamed, as they were non-standard:
- `kr` to `ko`
- `no` to `nb`
#### `feedback.ratings`
The old, nameless placeholders were removed (after being deprecated for several
months). Make sure to switch to the new named placeholders `{title}` and `{url}`:
```
https://github.com/.../issues/new/?title=[Feedback]+{title}+-+{url}
```
### Changes to `*.html` files
The templates have undergone a series of changes. If you have customized
Material for MkDocs with theme extension, be sure to incorporate the latest
changes into your templates. A good starting point is to [inspect the diff].
[inspect the diff]: https://github.com/squidfunk/mkdocs-material/pull/4628/files#diff-3ca112736b9164701b599f34780107abf14bb79fe110c478cac410be90899828
## Upgrading from 7.x to 8.x
### What's new?

View File

@ -1 +1 @@
{"version":3,"sources":["src/.overrides/assets/stylesheets/custom/_typeset.scss","../../../../src/.overrides/assets/stylesheets/custom.scss","src/assets/stylesheets/utilities/_break.scss","src/.overrides/assets/stylesheets/custom/layout/_banner.scss","src/.overrides/assets/stylesheets/custom/layout/_hero.scss","src/.overrides/assets/stylesheets/custom/layout/_iconsearch.scss","src/.overrides/assets/stylesheets/custom/layout/_sponsorship.scss"],"names":[],"mappings":"AA2BA,iBACE,cAIE,kBC7BF,CDgCA,QAEE,qBC/BF,CACF,CD0CE,qBACE,aCxCJ,CD4CE,uBACE,UC1CJ,CD6CI,8BAGE,QAAA,CACA,sBAAA,CAHA,iBAAA,CACA,UCzCN,CD+CI,8BAOE,WAAA,CAFA,WAAA,CAFA,MAAA,CAGA,eAAA,CALA,iBAAA,CACA,KAAA,CAEA,UC1CN,CDkDE,uBACE,2BChDJ,CDoDE,0BACE,aClDJ,CDsDE,+BACE,cAAA,CACA,uBCpDJ,CDuDI,0EAEE,WCtDN,CD0DI,oCAGE,2CAAA,CADA,gCAAA,CADA,aCtDN,CD6DE,4BACE,UAAA,CACA,uBC3DJ,CD8DI,2EAEE,SC7DN,CDqEI,wDAEE,cCnEN,CC2JI,wCF1FA,wDAMI,eClEN,CACF,CDsEI,4BACE,kBCpEN,CDyEE,wBACE,YAAA,CACA,gBCvEJ,CD0EI,4BAEE,kBAAA,CADA,WCvEN,CD+EM,sCACE,aAAA,CACA,kBC7ER,CDiFM,+BACE,aC/ER,CEnDE,mDAGE,kBFsDJ,CElDE,kBACE,kBFoDJ,CEhDE,8BACE,gBFkDJ,CEnDE,8BACE,iBFkDJ,CGlEA,eAEE,uYACE,CAFF,gBHsEF,CG3DE,4CACE,yYH6DJ,CGjDA,UAEE,gCAAA,CADA,cHqDF,CGjDE,aAEE,kBAAA,CACA,eAAA,CAFA,kBHqDJ,CCqGI,wCE3JF,aAOI,gBHmDJ,CACF,CG/CE,mBACE,mBHiDJ,CC0EI,mCE7IJ,UAwBI,mBAAA,CADA,YHiDF,CG7CE,mBAEE,iBAAA,CADA,eAAA,CAEA,mBH+CJ,CG3CE,iBACE,OAAA,CAEA,0BAAA,CADA,WH8CJ,CACF,CC0DI,sCEhGA,iBACE,0BHyCJ,CACF,CGrCE,qBAGE,gCAAA,CADA,kBAAA,CADA,gBHyCJ,CGpCI,sDAGE,0CAAA,CACA,sCAAA,CAFA,+BHuCN,CGjCI,8BAEE,2CAAA,CACA,uCAAA,CAFA,aHqCN,CI7HE,4BAEE,2CAAA,CACA,mBAAA,CACA,8BAAA,CAHA,iBAAA,CAIA,2BJgIJ,CI7HI,2EAEE,8BJ8HN,CI1HI,sCACE,qCAAA,CACA,eJ4HN,CIzHM,mEACE,kCJ2HR,CIrHE,mCAIE,kCAAA,CAAA,0BAAA,CAHA,eAAA,CACA,eAAA,CAKA,yDAAA,CADA,oBAAA,CADA,kBJwHJ,CInHI,+CACE,mBJqHN,CIjHI,sDAEE,YAAA,CADA,WJoHN,CI/GI,4DACE,oDJiHN,CI9GM,kEACE,0CJgHR,CI3GI,yCAIE,yCAAA,CACA,gBAAA,CAJA,iBAAA,CAEA,WAAA,CADA,SJgHN,CIzGI,mDAIE,aJ2GN,CI/GI,mDAIE,cJ2GN,CI/GI,yCAME,eAAA,CALA,QAAA,CAIA,SJ0GN,CIrGI,mDAIE,aJuGN,CI3GI,mDAIE,cJuGN,CI3GI,yCAME,+DAAA,CALA,QAAA,CAIA,mBJsGN,CIlGM,oDACE,kBJoGR,CIhGM,2CACE,kBJkGR,CI9FM,6CAEE,YAAA,CADA,WJiGR,CI7FQ,0FACE,gBJ+FV,CKjMI,2BACE,YAAA,CACA,iBLoMN,CKhMI,6BACE,cLkMN,CK9LI,sCACE,YAAA,CACA,cAAA,CACA,sBLgMN,CK7LM,wCACE,aAAA,CACA,aL+LR,CKtLI,mCACE,YLwLN,CKrLM,yCAEE,UAAA,CACA,UAAA,CAFA,aLyLR,CKlLI,6CAEE,UL2LN,CK7LI,6CAEE,WL2LN,CK7LI,mCAOE,kBAAA,CANA,aAAA,CAGA,aAAA,CACA,YAAA,CACA,eAAA,CAEA,kBAAA,CACA,sCACE,CAPF,YL0LN,CK/KM,kFAEE,oBLgLR,CK7KQ,0FACE,mBL+KV,CK1KM,4CAME,+CAAA,CALA,yCAAA,CAEA,eAAA,CADA,eAAA,CAEA,kBAAA,CACA,iBL6KR,CKxKM,uCACE,aAAA,CAGA,mCAAA,CADA,WAAA,CAEA,uBAAA,CAHA,UL6KR,CKpKE,oCACE,eLsKJ,CKlKE,sEAEE,eLoKJ","file":"custom.css"}
{"version":3,"sources":["src/.overrides/assets/stylesheets/custom/_typeset.scss","../../../../src/.overrides/assets/stylesheets/custom.scss","src/assets/stylesheets/utilities/_break.scss","src/.overrides/assets/stylesheets/custom/layout/_banner.scss","src/.overrides/assets/stylesheets/custom/layout/_hero.scss","src/.overrides/assets/stylesheets/custom/layout/_iconsearch.scss","src/.overrides/assets/stylesheets/custom/layout/_sponsorship.scss"],"names":[],"mappings":"AA2BA,iBACE,cAIE,kBC7BF,CDgCA,QAEE,qBC/BF,CACF,CD0CE,qBACE,aCxCJ,CD4CE,uBACE,UC1CJ,CD6CI,8BAGE,QAAA,CACA,sBAAA,CAHA,iBAAA,CACA,UCzCN,CD+CI,8BAOE,WAAA,CAFA,WAAA,CAFA,MAAA,CAGA,eAAA,CALA,iBAAA,CACA,KAAA,CAEA,UC1CN,CDkDE,uBACE,2BChDJ,CDoDE,0BACE,aClDJ,CDsDE,+BACE,cAAA,CACA,uBCpDJ,CDuDI,0EACE,WCrDN,CDyDI,oCAGE,2CAAA,CADA,gCAAA,CADA,aCrDN,CD4DE,4BACE,UAAA,CACA,uBC1DJ,CD6DI,2EACE,SC3DN,CDmEI,wDAEE,cCjEN,CC2JI,wCF5FA,wDAMI,eChEN,CACF,CDoEI,4BACE,kBClEN,CDuEE,wBACE,YAAA,CACA,gBCrEJ,CDwEI,4BAEE,kBAAA,CADA,WCrEN,CD6EM,sCACE,aAAA,CACA,kBC3ER,CD+EM,+BACE,aC7ER,CEnDE,mDAGE,kBFsDJ,CElDE,kBACE,kBFoDJ,CEhDE,8BACE,gBFkDJ,CEnDE,8BACE,iBFkDJ,CGlEA,eAEE,uYACE,CAFF,gBHsEF,CG3DE,4CACE,yYH6DJ,CGjDA,UAEE,gCAAA,CADA,cHqDF,CGjDE,aAEE,kBAAA,CACA,eAAA,CAFA,kBHqDJ,CCqGI,wCE3JF,aAOI,gBHmDJ,CACF,CG/CE,mBACE,mBHiDJ,CC0EI,mCE7IJ,UAwBI,mBAAA,CADA,YHiDF,CG7CE,mBAEE,iBAAA,CADA,eAAA,CAEA,mBH+CJ,CG3CE,iBACE,OAAA,CAEA,0BAAA,CADA,WH8CJ,CACF,CC0DI,sCEhGA,iBACE,0BHyCJ,CACF,CGrCE,qBAGE,gCAAA,CADA,kBAAA,CADA,gBHyCJ,CGpCI,sDAEE,0CAAA,CACA,sCAAA,CAFA,+BHwCN,CGlCI,8BAEE,2CAAA,CACA,uCAAA,CAFA,aHsCN,CI7HE,4BAEE,2CAAA,CACA,mBAAA,CACA,8BAAA,CAHA,iBAAA,CAIA,2BJgIJ,CI7HI,2EACE,8BJ+HN,CI3HI,sCACE,qCAAA,CACA,eJ6HN,CI1HM,mEACE,kCJ4HR,CItHE,mCAIE,kCAAA,CAAA,0BAAA,CAHA,eAAA,CACA,eAAA,CAKA,yDAAA,CADA,oBAAA,CADA,kBJyHJ,CIpHI,+CACE,mBJsHN,CIlHI,sDAEE,YAAA,CADA,WJqHN,CIhHI,4DACE,oDJkHN,CI/GM,kEACE,0CJiHR,CI5GI,yCAIE,yCAAA,CACA,gBAAA,CAJA,iBAAA,CAEA,WAAA,CADA,SJiHN,CI1GI,mDAIE,aJ4GN,CIhHI,mDAIE,cJ4GN,CIhHI,yCAME,eAAA,CALA,QAAA,CAIA,SJ2GN,CItGI,mDAIE,aJwGN,CI5GI,mDAIE,cJwGN,CI5GI,yCAME,+DAAA,CALA,QAAA,CAIA,mBJuGN,CInGM,oDACE,kBJqGR,CIjGM,2CACE,kBJmGR,CI/FM,6CAEE,YAAA,CADA,WJkGR,CI9FQ,0FACE,gBJgGV,CKjMI,2BACE,YAAA,CACA,iBLoMN,CKhMI,6BACE,cLkMN,CK9LI,sCACE,YAAA,CACA,cAAA,CACA,sBLgMN,CK7LM,wCACE,aAAA,CACA,aL+LR,CKtLI,mCACE,YLwLN,CKrLM,yCAEE,UAAA,CACA,UAAA,CAFA,aLyLR,CKlLI,6CAEE,UL2LN,CK7LI,6CAEE,WL2LN,CK7LI,mCAOE,kBAAA,CANA,aAAA,CAGA,aAAA,CACA,YAAA,CACA,eAAA,CAEA,kBAAA,CACA,sCACE,CAPF,YL0LN,CK/KM,kFACE,oBLiLR,CK9KQ,0FACE,mBLgLV,CK3KM,4CAME,+CAAA,CALA,yCAAA,CAEA,eAAA,CADA,eAAA,CAEA,kBAAA,CACA,iBL8KR,CKzKM,uCACE,aAAA,CAGA,mCAAA,CADA,WAAA,CAEA,uBAAA,CAHA,UL8KR,CKrKE,oCACE,eLuKJ,CKnKE,sEAEE,eLqKJ","file":"custom.css"}

View File

@ -16,5 +16,5 @@
{% endblock %}
{% block scripts %}
{{ super() }}
<script src="{{ 'assets/javascripts/custom.ed9684d4.min.js' | url }}"></script>
<script src="{{ 'assets/javascripts/custom.699ea29a.min.js' | url }}"></script>
{% endblock %}

View File

@ -1,13 +0,0 @@
{#-
This file was automatically generated - do not edit
-#}
{% if page.edit_url %}
{% set edit = "https://github.com/squidfunk/mkdocs-material/edit" %}
{% set view = "https://raw.githubusercontent.com/squidfunk/mkdocs-material" %}
<a href="{{ page.edit_url }}" title="{{ lang.t('edit.link.title') }}" class="md-content__button md-icon">
{% include ".icons/material/file-edit-outline.svg" %}
</a>
<a href="{{ page.edit_url | replace(edit, view) }}" title="View source of this page" class="md-content__button md-icon">
{% include ".icons/material/file-eye-outline.svg" %}
</a>
{% endif %}

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

View File

@ -21,8 +21,14 @@
{% if page.canonical_url %}
<link rel="canonical" href="{{ page.canonical_url }}">
{% endif %}
{% if page.previous_page %}
<link rel="prev" href="{{ page.previous_page.url | url }}">
{% endif %}
{% if page.next_page %}
<link rel="next" href="{{ page.next_page.url | url }}">
{% endif %}
<link rel="icon" href="{{ config.theme.favicon | url }}">
<meta name="generator" content="mkdocs-{{ mkdocs_version }}, mkdocs-material-8.5.11">
<meta name="generator" content="mkdocs-{{ mkdocs_version }}, mkdocs-material-9.0.0">
{% endblock %}
{% block htmltitle %}
{% if page.meta and page.meta.title %}
@ -34,17 +40,10 @@
{% endif %}
{% endblock %}
{% block styles %}
<link rel="stylesheet" href="{{ 'assets/stylesheets/main.975780f9.min.css' | url }}">
<link rel="stylesheet" href="{{ 'assets/stylesheets/main.f79797b0.min.css' | url }}">
{% if config.theme.palette %}
{% set palette = config.theme.palette %}
<link rel="stylesheet" href="{{ 'assets/stylesheets/palette.2505c338.min.css' | url }}">
{% if palette.primary %}
{% import "partials/palette.html" as map %}
{% set primary = map.primary(
palette.primary | replace(" ", "-") | lower
) %}
<meta name="theme-color" content="{{ primary }}">
{% endif %}
{% endif %}
{% include "partials/icons.html" %}
{% endblock %}
@ -75,15 +74,15 @@
{% endif %}
{% block extrahead %}{% endblock %}
</head>
{% set direction = config.theme.direction or lang.t('direction') %}
{% set direction = config.theme.direction or lang.t("direction") %}
{% if config.theme.palette %}
{% set palette = config.theme.palette %}
{% if not palette is mapping %}
{% set palette = palette | first %}
{% endif %}
{% set scheme = palette.scheme | d("default", true) %}
{% set primary = palette.primary %}
{% set accent = palette.accent %}
{% set scheme = palette.scheme | d("default", true) %}
{% set primary = palette.primary | d("", true) %}
{% set accent = palette.accent | d("", true) %}
<body dir="{{ direction }}" data-md-color-scheme="{{ scheme | replace(' ', '-') }}" data-md-color-primary="{{ primary | replace(' ', '-') }}" data-md-color-accent="{{ accent | replace(' ', '-') }}">
{% else %}
<body dir="{{ direction }}">
@ -99,7 +98,7 @@
{% if page.toc | first is defined %}
{% set skip = page.toc | first %}
<a href="{{ skip.url | url }}" class="md-skip">
{{ lang.t('skip.link.title') }}
{{ lang.t("action.skip") }}
</a>
{% endif %}
</div>
@ -138,7 +137,7 @@
<div class="md-container" data-md-component="container">
{% block hero %}{% endblock %}
{% block tabs %}
{% if not "navigation.tabs.sticky" in features %}
{% if "navigation.tabs.sticky" not in features %}
{% if "navigation.tabs" in features %}
{% include "partials/tabs.html" %}
{% endif %}
@ -159,7 +158,7 @@
</div>
</div>
{% endif %}
{% if not "toc.integrate" in features %}
{% if "toc.integrate" not in features %}
{% if page.meta and page.meta.hide %}
{% set hidden = "hidden" if "toc" in page.meta.hide %}
{% endif %}
@ -186,7 +185,7 @@
{% if "navigation.top" in features %}
<a href="#" class="md-top md-icon" data-md-component="top" hidden>
{% include ".icons/material/arrow-up.svg" %}
{{ lang.t('top.title') }}
{{ lang.t("top") }}
</a>
{% endif %}
</main>
@ -213,7 +212,7 @@
"base": base_url,
"features": features,
"translations": {},
"search": "assets/javascripts/workers/search.c80a6608.min.js" | url
"search": "assets/javascripts/workers/search.125bc4b3.min.js" | url
} -%}
{%- if config.extra.version -%}
{%- set _ = app.update({ "version": config.extra.version }) -%}
@ -225,10 +224,6 @@
{%- for key in [
"clipboard.copy",
"clipboard.copied",
"search.config.lang",
"search.config.pipeline",
"search.config.separator",
"search.placeholder",
"search.result.placeholder",
"search.result.none",
"search.result.one",
@ -236,7 +231,7 @@
"search.result.more.one",
"search.result.more.other",
"search.result.term.missing",
"select.version.title"
"select.version"
] -%}
{%- set _ = translations.update({ key: lang.t(key) }) -%}
{%- endfor -%}
@ -245,14 +240,10 @@
</script>
{% endblock %}
{% block scripts %}
<script src="{{ 'assets/javascripts/bundle.ffb53309.min.js' | url }}"></script>
<script src="{{ 'assets/javascripts/bundle.6ca897f9.min.js' | url }}"></script>
{% for path in config.extra_javascript %}
<script src="{{ path | url }}"></script>
{% endfor %}
{% endblock %}
{% if page.meta and page.meta.ᴴₒᴴₒᴴₒ %}
<link rel="stylesheet" href="{{ 'assets/stylesheets/extra.ae483297.min.css' | url }}">
<script src="{{ 'assets/javascripts/extra/bundle.84eb86ed.min.js' | url }}" defer></script>
{% endif %}
</body>
</html>

View File

@ -55,14 +55,6 @@ icon:
# Favicon to be rendered
favicon: assets/images/favicon.png
# Material includes the search in the header as a partial, not as a separate
# template, so it's correct that search.html is missing
include_search_page: false
# Material doesn't use MkDocs search functionality but provides its own. For
# this reason, only the search index needs to be built
search_index_only: true
# Static pages to build
static_templates:
- 404.html

View File

@ -2,8 +2,16 @@
This file was automatically generated - do not edit
-#}
{% if page.edit_url %}
<a href="{{ page.edit_url }}" title="{{ lang.t('edit.link.title') }}" class="md-content__button md-icon">
{% set icon = config.theme.icon.edit or "material/pencil" %}
{% include ".icons/" ~ icon ~ ".svg" %}
</a>
{% if "content.action.edit" in features %}
<a href="{{ page.edit_url }}" title="{{ lang.t('action.edit') }}" class="md-content__button md-icon">
{% set icon = config.theme.icon.edit or "material/file-edit-outline" %}
{% include ".icons/" ~ icon ~ ".svg" %}
</a>
{% endif %}
{% if "content.action.view" in features %}
<a href="{{ page.edit_url | replace(edit, view) }}" title="{{ lang.t('action.view') }}" class="md-content__button md-icon">
{% set icon = config.theme.icon.view or "material/file-eye-outline" %}
{% include ".icons/" ~ icon ~ ".svg" %}
</a>
{% endif %}
{% endif %}

View File

@ -16,7 +16,7 @@
{% if not actions %}
{% set actions = ["accept", "manage"] %}
{% endif %}
{% if not "manage" in actions %}
{% if "manage" not in actions %}
{% set checked = "checked" %}
{% endif %}
<h4>{{ config.extra.consent.title }}</h4>

View File

@ -1,11 +1,11 @@
{#-
This file was automatically generated - do not edit
-#}
{% if "tags" in config.plugins %}
{% if "material/tags" in config.plugins %}
{% include "partials/tags.html" %}
{% endif %}
{% include "partials/actions.html" %}
{% if not "\x3ch1" in page.content %}
{% if "\x3ch1" not in page.content %}
<h1>{{ page.title | d(config.site_name, true)}}</h1>
{% endif %}
{{ page.content }}

View File

@ -32,11 +32,7 @@
{% else %}
{% set title = page.title | urlencode %}
{% endif %}
{% if "{}" in rating.note %}
{{ rating.note.format(url, title) }}
{% else %}
{{ rating.note.format(url = url, title = title) }}
{% endif %}
{{ rating.note.format(url = url, title = title) }}
</div>
{% endfor %}
</div>

View File

@ -2,44 +2,46 @@
This file was automatically generated - do not edit
-#}
<footer class="md-footer">
{% if page.previous_page or page.next_page %}
{% if page.meta and page.meta.hide %}
{% set hidden = "hidden" if "footer" in page.meta.hide %}
{% if "navigation.footer" in features %}
{% if page.previous_page or page.next_page %}
{% if page.meta and page.meta.hide %}
{% set hidden = "hidden" if "footer" in page.meta.hide %}
{% endif %}
<nav class="md-footer__inner md-grid" aria-label="{{ lang.t('footer') }}" {{ hidden }}>
{% if page.previous_page %}
{% set direction = lang.t("footer.previous") %}
<a href="{{ page.previous_page.url | url }}" class="md-footer__link md-footer__link--prev" aria-label="{{ direction }}: {{ page.previous_page.title | e }}" rel="prev">
<div class="md-footer__button md-icon">
{% include ".icons/material/arrow-left.svg" %}
</div>
<div class="md-footer__title">
<div class="md-ellipsis">
<span class="md-footer__direction">
{{ direction }}
</span>
{{ page.previous_page.title }}
</div>
</div>
</a>
{% endif %}
{% if page.next_page %}
{% set direction = lang.t("footer.next") %}
<a href="{{ page.next_page.url | url }}" class="md-footer__link md-footer__link--next" aria-label="{{ direction }}: {{ page.next_page.title | e }}" rel="next">
<div class="md-footer__title">
<div class="md-ellipsis">
<span class="md-footer__direction">
{{ direction }}
</span>
{{ page.next_page.title }}
</div>
</div>
<div class="md-footer__button md-icon">
{% include ".icons/material/arrow-right.svg" %}
</div>
</a>
{% endif %}
</nav>
{% endif %}
<nav class="md-footer__inner md-grid" aria-label="{{ lang.t('footer.title') }}" {{ hidden }}>
{% if page.previous_page %}
{% set direction = lang.t("footer.previous") %}
<a href="{{ page.previous_page.url | url }}" class="md-footer__link md-footer__link--prev" aria-label="{{ direction }}: {{ page.previous_page.title | e }}" rel="prev">
<div class="md-footer__button md-icon">
{% include ".icons/material/arrow-left.svg" %}
</div>
<div class="md-footer__title">
<div class="md-ellipsis">
<span class="md-footer__direction">
{{ direction }}
</span>
{{ page.previous_page.title }}
</div>
</div>
</a>
{% endif %}
{% if page.next_page %}
{% set direction = lang.t("footer.next") %}
<a href="{{ page.next_page.url | url }}" class="md-footer__link md-footer__link--next" aria-label="{{ direction }}: {{ page.next_page.title | e }}" rel="next">
<div class="md-footer__title">
<div class="md-ellipsis">
<span class="md-footer__direction">
{{ direction }}
</span>
{{ page.next_page.title }}
</div>
</div>
<div class="md-footer__button md-icon">
{% include ".icons/material/arrow-right.svg" %}
</div>
</a>
{% endif %}
</nav>
{% endif %}
<div class="md-footer-meta md-typeset">
<div class="md-footer-meta__inner md-grid">

View File

@ -6,7 +6,7 @@
{% set class = class ~ " md-header--lifted" %}
{% endif %}
<header class="{{ class }}" data-md-component="header">
<nav class="md-header__inner md-grid" aria-label="{{ lang.t('header.title') }}">
<nav class="md-header__inner md-grid" aria-label="{{ lang.t('header') }}">
<a href="{{ config.extra.homepage | d(nav.homepage.url, true) | url }}" title="{{ config.site_name | e }}" class="md-header__button md-logo" aria-label="{{ config.site_name }}" data-md-component="logo">
{% include "partials/logo.html" %}
</a>
@ -34,10 +34,8 @@
{% if not config.theme.palette is mapping %}
<form class="md-header__option" data-md-component="palette">
{% for option in config.theme.palette %}
{% set scheme = option.scheme | d("default", true) %}
{% set primary = option.primary %}
{% set accent = option.accent %}
<input class="md-option" data-md-color-media="{{ option.media }}" data-md-color-scheme="{{ scheme | replace(' ', '-') }}" data-md-color-primary="{{ primary | replace(' ', '-') }}" data-md-color-accent="{{ accent | replace(' ', '-') }}" {% if option.toggle %} aria-label="{{ option.toggle.name }}" {% else %} aria-hidden="true" {% endif %} type="radio" name="__palette" id="__palette_{{ loop.index }}">
{% set scheme = option.scheme | d("default", true) %}
<input class="md-option" data-md-color-media="{{ option.media }}" data-md-color-scheme="{{ scheme | replace(' ', '-') }}" data-md-color-primary="{{ option.primary | replace(' ', '-') }}" data-md-color-accent="{{ option.accent | replace(' ', '-') }}" {% if option.toggle %} aria-label="{{ option.toggle.name }}" {% else %} aria-hidden="true" {% endif %} type="radio" name="__palette" id="__palette_{{ loop.index }}">
{% if option.toggle %}
<label class="md-header__button md-icon" title="{{ option.toggle.name }}" for="__palette_{{ loop.index0 or loop.length }}" hidden>
{% include ".icons/" ~ option.toggle.icon ~ ".svg" %}
@ -50,7 +48,7 @@
<div class="md-header__option">
<div class="md-select">
{% set icon = config.theme.icon.alternate or "material/translate" %}
<button class="md-header__button md-icon" aria-label="{{ lang.t('select.language.title') }}">
<button class="md-header__button md-icon" aria-label="{{ lang.t('select.language') }}">
{% include ".icons/" ~ icon ~ ".svg" %}
</button>
<div class="md-select__inner">
@ -67,7 +65,7 @@
</div>
</div>
{% endif %}
{% if "search" in config.plugins %}
{% if "material/search" in config.plugins %}
<label class="md-header__button md-icon" for="__search">
{% include ".icons/material/magnify.svg" %}
</label>

View File

@ -3,11 +3,12 @@
-#}
{% macro t(key) %}{{ {
"language": "af",
"action.edit": "Wysig hierdie bladsy",
"action.skip": "Slaan oor na inhoud",
"clipboard.copy": "Kopieer na knipbord",
"clipboard.copied": "gekopieer na knipbord",
"edit.link.title": "Wysig hierdie bladsy",
"footer.previous": "Vorige",
"footer.next": "Volgende",
"footer.previous": "Vorige",
"meta.comments": "Kommentaar",
"meta.source": "Bron",
"search.config.lang": "nl",
@ -16,9 +17,8 @@
"search.result.none": "Geen ooreenstemmende dokumente",
"search.result.one": "1 ooreenstemmende dokument",
"search.result.other": "# ooreenstemmende dokumente",
"skip.link.title": "Slaan oor na inhoud",
"source.link.title": "Slaan oor na inhoud",
"source.file.date.updated": "Laaste opdatering",
"source": "Slaan oor na inhoud",
"source.file.date.created": "Geskep",
"toc.title": "Inhoudsopgawe"
"source.file.date.updated": "Laaste opdatering",
"toc": "Inhoudsopgawe"
}[key] }}{% endmacro %}

View File

@ -4,11 +4,12 @@
{% macro t(key) %}{{ {
"language": "ar",
"direction": "rtl",
"action.edit": "عدل الصفحة",
"action.skip": "انتقل إلى المحتوى",
"clipboard.copy": "نسخ إلى الحافظة",
"clipboard.copied": "تم النسخ الى الحافظة",
"edit.link.title": "عدل الصفحة",
"footer.previous": "السابقة",
"footer.next": "التالية",
"footer.previous": "السابقة",
"meta.comments": "التعليقات",
"meta.source": "المصدر",
"search.config.pipeline": " ",
@ -17,9 +18,8 @@
"search.result.none": "لا توجد نتائج",
"search.result.one": "نتائج البحث مستند واحد",
"search.result.other": "نتائج البحث # مستندات",
"skip.link.title": "انتقل إلى المحتوى",
"source.link.title": "اذهب إلى المصدر",
"source.file.date.updated": "اخر تحديث",
"source": "اذهب إلى المصدر",
"source.file.date.created": "خلقت",
"toc.title": "جدول المحتويات"
"source.file.date.updated": "اخر تحديث",
"toc": "جدول المحتويات"
}[key] }}{% endmacro %}

View File

@ -3,16 +3,17 @@
-#}
{% macro t(key) %}{{ {
"language": "bg",
"action.edit": "Редактирай тази страница",
"action.skip": "Към съдържанието",
"clipboard.copy": "Копирай",
"clipboard.copied": "Копирано",
"edit.link.title": "Редактирай тази страница",
"footer.previous": "Предишна",
"footer": "Долен колонтитул",
"footer.next": "Следваща",
"footer.title": "Долен колонтитул",
"header.title": "Горен колонтитул",
"footer.previous": "Предишна",
"header": "Горен колонтитул",
"meta.comments": "Коментари",
"meta.source": "Код",
"nav.title": "Навигация",
"nav": "Навигация",
"search.config.lang": "ru",
"search.placeholder": "Търси",
"search.reset": "Изчисти",
@ -22,10 +23,9 @@
"search.result.other": "# резултата",
"search.result.more.one": "още 1 на тази страница",
"search.result.more.other": "още # на тази страница",
"skip.link.title": "Към съдържанието",
"source.link.title": "Към хранилището",
"source.file.date.updated": "Последна промяна",
"source": "Към хранилището",
"source.file.date.created": "Създаден",
"tabs.title": "Табове",
"toc.title": "Съдържание"
"source.file.date.updated": "Последна промяна",
"tabs": "Табове",
"toc": "Съдържание"
}[key] }}{% endmacro %}

View File

@ -3,16 +3,17 @@
-#}
{% macro t(key) %}{{ {
"language": "bn",
"action.edit": "এই পেজ এডিট করুন",
"action.skip": "কনটেন্টে যান",
"clipboard.copy": "ক্লিপবোর্ডে কপি করুন",
"clipboard.copied": "ক্লিপবোর্ডে কপি হয়েছে",
"edit.link.title": "এই পেজ এডিট করুন",
"footer.previous": "পূর্ববর্তী",
"footer": "ফুটার",
"footer.next": "পরে",
"footer.title": "ফুটার",
"header.title": "হেডার",
"footer.previous": "পূর্ববর্তী",
"header": "হেডার",
"meta.comments": "কমেন্ট",
"meta.source": "সোর্স",
"nav.title": "ন্যাভিগেশন",
"nav": "ন্যাভিগেশন",
"search.config.pipeline": " ",
"search.placeholder": "সার্চ",
"search.reset": "মুছে ফেলুন",
@ -20,10 +21,9 @@
"search.result.none": "কিছু পাওয়া যায়নি",
"search.result.one": "১ টা ডকুমেন্ট",
"search.result.other": "# টা ডকুমেন্ট",
"skip.link.title": "কনটেন্টে যান",
"source.link.title": "রিপোজিটরিতে যান",
"source.file.date.updated": "শেষ আপডেট",
"source": "রিপোজিটরিতে যান",
"source.file.date.created": "তৈরি হয়েছে",
"tabs.title": "ট্যাব",
"toc.title": "টেবিল অফ কনটেন্ট"
"source.file.date.updated": "শেষ আপডেট",
"tabs": "ট্যাব",
"toc": "টেবিল অফ কনটেন্ট"
}[key] }}{% endmacro %}

View File

@ -3,11 +3,12 @@
-#}
{% macro t(key) %}{{ {
"language": "ca",
"action.edit": "Edita aquesta pàgina",
"action.skip": "Salta el contingut",
"clipboard.copy": "Còpia al porta-retalls",
"clipboard.copied": "Copiat al porta-retalls",
"edit.link.title": "Edita aquesta pàgina",
"footer.previous": "Anterior",
"footer.next": "Següent",
"footer.previous": "Anterior",
"meta.comments": "Comentaris",
"meta.source": "Codi font",
"search.placeholder": "Cerca",
@ -15,9 +16,8 @@
"search.result.none": "Cap document coincideix",
"search.result.one": "1 document coincident",
"search.result.other": "# documents coincidents",
"skip.link.title": "Salta el contingut",
"source.link.title": "Ves al repositori",
"source.file.date.updated": "Darrera actualització",
"source": "Ves al repositori",
"source.file.date.created": "Creada",
"toc.title": "Taula de continguts"
"source.file.date.updated": "Darrera actualització",
"toc": "Taula de continguts"
}[key] }}{% endmacro %}

View File

@ -3,11 +3,12 @@
-#}
{% macro t(key) %}{{ {
"language": "cs",
"action.edit": "Upravit tuto stránku",
"action.skip": "Přeskočit obsah",
"clipboard.copy": "Kopírovat do schránky",
"clipboard.copied": "Zkopírováno do schránky",
"edit.link.title": "Upravit tuto stránku",
"footer.previous": "Předchozí",
"footer.next": "Další",
"footer.previous": "Předchozí",
"meta.comments": "Komentáře",
"meta.source": "Zdroj",
"search.placeholder": "Hledat",
@ -15,9 +16,8 @@
"search.result.none": "Nenalezeny žádné dokumenty",
"search.result.one": "Nalezený dokument: 1",
"search.result.other": "Nalezené dokumenty: #",
"skip.link.title": "Přeskočit obsah",
"source.link.title": "Přejít do repozitáře",
"source.file.date.updated": "Poslední aktualizace",
"source": "Přejít do repozitáře",
"source.file.date.created": "Vytvořeno",
"toc.title": "Obsah"
"source.file.date.updated": "Poslední aktualizace",
"toc": "Obsah"
}[key] }}{% endmacro %}

View File

@ -3,11 +3,12 @@
-#}
{% macro t(key) %}{{ {
"language": "da",
"action.edit": "Redigér denne side",
"action.skip": "Gå til indholdet",
"clipboard.copy": "Kopiér til udklipsholderen",
"clipboard.copied": "Kopieret til udklipsholderen",
"edit.link.title": "Redigér denne side",
"footer.previous": "Forrige",
"footer.next": "Næste",
"footer.previous": "Forrige",
"meta.comments": "Kommentarer",
"meta.source": "Kilde",
"search.config.lang": "da",
@ -16,9 +17,8 @@
"search.result.none": "Ingen resultater fundet",
"search.result.one": "1 resultat",
"search.result.other": "# resultater",
"skip.link.title": "Gå til indholdet",
"source.link.title": "Åbn arkiv",
"source.file.date.updated": "Sidste ændring",
"source": "Åbn arkiv",
"source.file.date.created": "Oprettet",
"toc.title": "Indholdsfortegnelse"
"source.file.date.updated": "Sidste ændring",
"toc": "Indholdsfortegnelse"
}[key] }}{% endmacro %}

View File

@ -3,20 +3,23 @@
-#}
{% macro t(key) %}{{ {
"language": "de",
"action.edit": "Seite editieren",
"action.skip": "Zum Inhalt",
"action.view": "Quellcode der Seite anzeigen",
"announce.dismiss": "Nicht mehr anzeigen",
"clipboard.copy": "In Zwischenablage kopieren",
"clipboard.copied": "In Zwischenablage kopiert",
"consent.accept": "Akzeptieren",
"consent.manage": "Einstellungen",
"consent.reject": "Ablehnen",
"edit.link.title": "Seite editieren",
"footer.previous": "Zurück",
"footer": "Fußzeile",
"footer.next": "Weiter",
"footer.title": "Fußzeile",
"header.title": "Kopfzeile",
"footer.previous": "Zurück",
"header": "Kopfzeile",
"meta.comments": "Kommentare",
"meta.source": "Quellcode",
"nav.title": "Navigation",
"nav": "Navigation",
"search": "Suche",
"search.config.lang": "de",
"search.placeholder": "Suche",
"search.share": "Teilen",
@ -29,14 +32,12 @@
"search.result.more.one": "1 weiteres Suchergebnis auf dieser Seite",
"search.result.more.other": "# weitere Suchergebnisse auf dieser Seite",
"search.result.term.missing": "Es fehlt",
"search.title": "Suche",
"select.language.title": "Sprache wechseln",
"select.version.title": "Version auswählen",
"skip.link.title": "Zum Inhalt",
"source.link.title": "Zum Repository",
"source.file.date.updated": "Letztes Update",
"select.language": "Sprache wechseln",
"select.version": "Version auswählen",
"source": "Zum Repository",
"source.file.date.created": "Erstellt",
"tabs.title": "Hauptnavigation",
"toc.title": "Inhaltsverzeichnis",
"top.title": "Zurück zum Seitenanfang"
"source.file.date.updated": "Letztes Update",
"tabs": "Hauptnavigation",
"toc": "Inhaltsverzeichnis",
"top": "Zurück zum Seitenanfang"
}[key] }}{% endmacro %}

View File

@ -3,17 +3,18 @@
-#}
{% macro t(key) %}{{ {
"language": "el",
"action.edit": "Επεξεργασία αυτής της σελίδας",
"action.skip": "Μετάβαση στο περιεχόμενο",
"clipboard.copy": "Αντιγραφή στο πρόχειρο",
"clipboard.copied": "Αντιγράφηκε στο πρόχειρο",
"edit.link.title": "Επεξεργασία αυτής της σελίδας",
"footer.previous": "Προηγούμενο",
"footer": "Υποσέλιδο",
"footer.next": "Επόμενο",
"footer.title": "Υποσέλιδο",
"header.title": "Κεφαλίδα",
"footer.previous": "Προηγούμενο",
"header": "Κεφαλίδα",
"meta.comments": "Σχόλια",
"meta.source": "Πηγή",
"nav.title": "Πλοήγηση",
"search.config.pipeline": "stopWordFilter",
"nav": "Πλοήγηση",
"search": "Αναζήτηση",
"search.placeholder": "Αναζήτηση",
"search.share": "Διαμοίραση",
"search.reset": "Καθαρισμός",
@ -25,14 +26,12 @@
"search.result.more.one": "1 ακόμα σε αυτήν τη σελίδα",
"search.result.more.other": "# ακόμα σε αυτήν τη σελίδα",
"search.result.term.missing": "Λείπει",
"search.title": "Αναζήτηση",
"select.language.title": "Επιλογή γλώσσας",
"select.version.title": "Επιλογή έκδοσης",
"skip.link.title": "Μετάβαση στο περιεχόμενο",
"source.link.title": "Μετάβαση στο αποθετήριο",
"source.file.date.updated": "τελευταία ενημέρωση",
"select.language": "Επιλογή γλώσσας",
"select.version": "Επιλογή έκδοσης",
"source": "Μετάβαση στο αποθετήριο",
"source.file.date.created": "Δημιουργήθηκε",
"tabs.title": "Καρτέλες",
"toc.title": "Πίνακας περιεχομένων",
"top.title": "Επιστροφή στην αρχή"
"source.file.date.updated": "τελευταία ενημέρωση",
"tabs": "Καρτέλες",
"toc": "Πίνακας περιεχομένων",
"top": "Επιστροφή στην αρχή"
}[key] }}{% endmacro %}

View File

@ -4,22 +4,25 @@
{% macro t(key) %}{{ {
"language": "en",
"direction": "ltr",
"action.edit": "Edit this page",
"action.skip": "Skip to content",
"action.view": "View source of this page",
"announce.dismiss": "Don't show this again",
"clipboard.copy": "Copy to clipboard",
"clipboard.copied": "Copied to clipboard",
"consent.accept": "Accept",
"consent.manage": "Manage settings",
"consent.reject": "Reject",
"edit.link.title": "Edit this page",
"footer.previous": "Previous",
"footer": "Footer",
"footer.next": "Next",
"footer.title": "Footer",
"header.title": "Header",
"footer.previous": "Previous",
"header": "Header",
"meta.comments": "Comments",
"meta.source": "Source",
"nav.title": "Navigation",
"nav": "Navigation",
"search": "Search",
"search.config.lang": "en",
"search.config.pipeline": "trimmer, stopWordFilter",
"search.config.pipeline": "stopWordFilter",
"search.config.separator": "[\\s\\-]+",
"search.placeholder": "Search",
"search.share": "Share",
@ -32,14 +35,12 @@
"search.result.more.one": "1 more on this page",
"search.result.more.other": "# more on this page",
"search.result.term.missing": "Missing",
"search.title": "Search",
"select.language.title": "Select language",
"select.version.title": "Select version",
"skip.link.title": "Skip to content",
"source.link.title": "Go to repository",
"source.file.date.updated": "Last update",
"select.language": "Select language",
"select.version": "Select version",
"source": "Go to repository",
"source.file.date.created": "Created",
"tabs.title": "Tabs",
"toc.title": "Table of contents",
"top.title": "Back to top"
"source.file.date.updated": "Last update",
"tabs": "Tabs",
"toc": "Table of contents",
"top": "Back to top"
}[key] }}{% endmacro %}

View File

@ -3,16 +3,17 @@
-#}
{% macro t(key) %}{{ {
"language": "eo",
"action.edit": "Redakti ĉi tiun paĝon",
"action.skip": "Saltu al enhavo",
"clipboard.copy": "Kopii al tondujo",
"clipboard.copied": "Kopiado al klipo",
"edit.link.title": "Redakti ĉi tiun paĝon",
"footer.previous": "Antaŭa",
"footer": "Piedlinio",
"footer.next": "Sekva",
"footer.title": "Piedlinio",
"header.title": "Kaplinio",
"footer.previous": "Antaŭa",
"header": "Kaplinio",
"meta.comments": "Komentoj",
"meta.source": "Fontkodo",
"nav.title": "Navigado",
"nav": "Navigado",
"search.config.lang": "es",
"search.placeholder": "Serĉo",
"search.reset": "Klara",
@ -20,10 +21,9 @@
"search.result.none": "Neniuj kongruaj dokumentoj",
"search.result.one": "1 kongrua dokumento",
"search.result.other": "# kongruaj dokumentoj",
"skip.link.title": "Saltu al enhavo",
"source.link.title": "Iru al deponejo",
"source.file.date.updated": "Lasta ĝisdatigo",
"source": "Iru al deponejo",
"source.file.date.created": "Kreita",
"tabs.title": "Langetoj",
"toc.title": "Enhavtabelo"
"source.file.date.updated": "Lasta ĝisdatigo",
"tabs": "Langetoj",
"toc": "Enhavtabelo"
}[key] }}{% endmacro %}

View File

@ -3,18 +3,19 @@
-#}
{% macro t(key) %}{{ {
"language": "es",
"action.edit": "Editar esta página",
"action.skip": "Saltar a contenido",
"clipboard.copy": "Copiar al portapapeles",
"clipboard.copied": "Copiado al portapapeles",
"consent.accept": "Aceptar",
"consent.manage": "Gestionar cookies",
"edit.link.title": "Editar esta página",
"footer.previous": "Anterior",
"footer": "Pie",
"footer.next": "Siguiente",
"footer.title": "Pie",
"header.title": "Cabecera",
"footer.previous": "Anterior",
"header": "Cabecera",
"meta.comments": "Comentarios",
"meta.source": "Fuente",
"nav.title": "Navegación",
"nav": "Navegación",
"search.config.lang": "es",
"search.placeholder": "Búsqueda",
"search.reset": "Limpiar",
@ -26,13 +27,12 @@
"search.result.more.one": "1 más en esta página",
"search.result.more.other": "# más en esta página",
"search.result.term.missing": "Falta",
"select.language.title": "Seleccionar idioma",
"select.version.title": "Seleccionar versión",
"skip.link.title": "Saltar a contenido",
"source.link.title": "Ir al repositorio",
"source.file.date.updated": "Última actualización",
"select.language": "Seleccionar idioma",
"select.version": "Seleccionar versión",
"source": "Ir al repositorio",
"source.file.date.created": "Creado",
"tabs.title": "Pestañas",
"toc.title": "Tabla de contenidos",
"top.title": "Volver al principio"
"source.file.date.updated": "Última actualización",
"tabs": "Pestañas",
"toc": "Tabla de contenidos",
"top": "Volver al principio"
}[key] }}{% endmacro %}

View File

@ -3,11 +3,12 @@
-#}
{% macro t(key) %}{{ {
"language": "et",
"action.edit": "Muuda seda lehte",
"action.skip": "Keri sisuni",
"clipboard.copy": "Kopeeri lõikelauale",
"clipboard.copied": "Kopeeritud",
"edit.link.title": "Muuda seda lehte",
"footer.previous": "Eelmine",
"footer.next": "Järgmine",
"footer.previous": "Eelmine",
"meta.comments": "Kommentaarid",
"meta.source": "Lähtekood",
"search.placeholder": "Otsi",
@ -15,9 +16,8 @@
"search.result.none": "Otsingule ei leitud ühtegi vastet",
"search.result.one": "Leiti üks tulemus",
"search.result.other": "Leiti # tulemust",
"skip.link.title": "Keri sisuni",
"source.link.title": "Ava repositooriumis",
"source.file.date.updated": "Viimane uuendus",
"source": "Ava repositooriumis",
"source.file.date.created": "Loodud",
"toc.title": "Sisukord"
"source.file.date.updated": "Viimane uuendus",
"toc": "Sisukord"
}[key] }}{% endmacro %}

View File

@ -4,11 +4,12 @@
{% macro t(key) %}{{ {
"language": "fa",
"direction": "rtl",
"action.edit": "این صفحه را ویرایش کنید",
"action.skip": "پرش به محتویات",
"clipboard.copy": "کپی کردن",
"clipboard.copied": "کپی شد",
"edit.link.title": "این صفحه را ویرایش کنید",
"footer.previous": "قبلی",
"footer.next": "بعدی",
"footer.previous": "قبلی",
"meta.comments": "نظرات",
"meta.source": "منبع",
"search.config.pipeline": " ",
@ -17,9 +18,8 @@
"search.result.none": "سندی یافت نشد",
"search.result.one": "1 سند یافت شد",
"search.result.other": "# سند یافت شد",
"skip.link.title": "پرش به محتویات",
"source.link.title": "رفتن به مخزن",
"source.file.date.updated": "اخرین بروزرسانی",
"source": "رفتن به مخزن",
"source.file.date.created": "ایجاد شده",
"toc.title": "فهرست موضوعات"
"source.file.date.updated": "اخرین بروزرسانی",
"toc": "فهرست موضوعات"
}[key] }}{% endmacro %}

View File

@ -3,11 +3,12 @@
-#}
{% macro t(key) %}{{ {
"language": "fi",
"action.edit": "Muokkaa tätä sivua",
"action.skip": "Hyppää sisältöön",
"clipboard.copy": "Kopioi leikepöydälle",
"clipboard.copied": "Kopioitu leikepöydälle",
"edit.link.title": "Muokkaa tätä sivua",
"footer.previous": "Edellinen",
"footer.next": "Seuraava",
"footer.previous": "Edellinen",
"meta.comments": "Kommentit",
"meta.source": "Lähdekodi",
"search.config.lang": "fi",
@ -16,9 +17,8 @@
"search.result.none": "Ei täsmääviä dokumentteja",
"search.result.one": "1 täsmäävä dokumentti",
"search.result.other": "# täsmäävää dokumenttia",
"skip.link.title": "Hyppää sisältöön",
"source.link.title": "Mene repositoryyn",
"source.file.date.updated": "Viimeisin päivitys",
"source": "Mene repositoryyn",
"source.file.date.created": "Luotu",
"toc.title": "Sisällysluettelo"
"source.file.date.updated": "Viimeisin päivitys",
"toc": "Sisällysluettelo"
}[key] }}{% endmacro %}

View File

@ -3,19 +3,20 @@
-#}
{% macro t(key) %}{{ {
"language": "fr",
"action.edit": "Editer cette page",
"action.skip": "Aller au contenu",
"clipboard.copy": "Copier dans le presse-papier",
"clipboard.copied": "Copié dans le presse-papier",
"consent.accept": "Accepter",
"consent.manage": "Paramétrer vos choix",
"consent.reject": "Refuser",
"edit.link.title": "Editer cette page",
"footer.previous": "Précédent",
"footer": "Pied de page",
"footer.next": "Suivant",
"footer.title": "Pied de page",
"header.title": "En-tête",
"footer.previous": "Précédent",
"header": "En-tête",
"meta.comments": "Commentaires",
"meta.source": "Source",
"nav.title": "Navigation",
"nav": "Navigation",
"search.config.lang": "fr",
"search.placeholder": "Rechercher",
"search.reset": "Effacer",
@ -27,13 +28,12 @@
"search.result.more.one": "1 de plus sur cette page",
"search.result.more.other": "# de plus sur cette page",
"search.result.term.missing": "Non trouvé",
"select.language.title": "Sélectionner la langue",
"select.version.title": "Sélectionner la version",
"skip.link.title": "Aller au contenu",
"source.link.title": "Aller au dépôt",
"source.file.date.updated": "Dernière mise à jour",
"select.language": "Sélectionner la langue",
"select.version": "Sélectionner la version",
"source": "Aller au dépôt",
"source.file.date.created": "Créé",
"tabs.title": "Onglets",
"toc.title": "Table des matières",
"top.title": "Retour en haut de la page"
"source.file.date.updated": "Dernière mise à jour",
"tabs": "Onglets",
"toc": "Table des matières",
"top": "Retour en haut de la page"
}[key] }}{% endmacro %}

View File

@ -3,16 +3,17 @@
-#}
{% macro t(key) %}{{ {
"language": "gl",
"action.edit": "Editar esta páxina",
"action.skip": "Ir ao contido",
"clipboard.copy": "Copiar no cortapapeis",
"clipboard.copied": "Copiado no cortapapeis",
"edit.link.title": "Editar esta páxina",
"footer.previous": "Anterior",
"footer": "Pé",
"footer.next": "Seguinte",
"footer.title": "Pé",
"header.title": "Cabeceira",
"footer.previous": "Anterior",
"header": "Cabeceira",
"meta.comments": "Comentarios",
"meta.source": "Fonte",
"nav.title": "Navegación",
"nav": "Navegación",
"search.config.lang": "es",
"search.placeholder": "Procura",
"search.reset": "Limpar",
@ -24,13 +25,12 @@
"search.result.more.one": "1 máis nesta páxina",
"search.result.more.other": "# máis nesta páxina",
"search.result.term.missing": "Falta",
"select.language.title": "Seleccionar idioma",
"select.version.title": "Seleccionar version",
"skip.link.title": "Ir ao contido",
"source.link.title": "Ir ao repositorio",
"source.file.date.updated": "Última actualización",
"select.language": "Seleccionar idioma",
"select.version": "Seleccionar version",
"source": "Ir ao repositorio",
"source.file.date.created": "Creada",
"tabs.title": "Pestanas",
"toc.title": "Táboa de contidos",
"top.title": "Volver ao principio"
"source.file.date.updated": "Última actualización",
"tabs": "Pestanas",
"toc": "Táboa de contidos",
"top": "Volver ao principio"
}[key] }}{% endmacro %}

View File

@ -4,20 +4,22 @@
{% macro t(key) %}{{ {
"language": "he",
"direction": "rtl",
"action.edit": "עריכת הדף הזה",
"action.skip": "לדלג לתוכן",
"announce.dismiss": "לא להציג את זה שוב",
"clipboard.copy": "העתקה ללוח",
"clipboard.copied": "הועתק ללוח",
"consent.accept": "לקבל",
"consent.manage": "לנהל הגדרות",
"consent.reject": "לדחות",
"edit.link.title": "עריכת הדף הזה",
"footer.previous": "הקודם",
"footer": "כותרת תחתונה",
"footer.next": "הבא",
"footer.title": "כותרת תחתונה",
"header.title": "כותרת עליונה",
"footer.previous": "הקודם",
"header": "כותרת עליונה",
"meta.comments": "הערות",
"meta.source": "מקור",
"nav.title": "ניווט",
"nav": "ניווט",
"search": "חיפוש",
"search.config.pipeline": " ",
"search.placeholder": "חיפוש",
"search.share": "שיתוף",
@ -30,14 +32,12 @@
"search.result.more.one": "עוד אחד בדף הזה",
"search.result.more.other": "עוד # בדף הזה",
"search.result.term.missing": "חסר",
"search.title": "חיפוש",
"select.language.title": "בחירת שפה",
"select.version.title": "בחירת גרסה",
"skip.link.title": "לדלג לתוכן",
"source.link.title": "לעבור אל המאגר",
"source.file.date.updated": "עדכון אחרון",
"select.language": "בחירת שפה",
"select.version": "בחירת גרסה",
"source": "לעבור אל המאגר",
"source.file.date.created": "נוצר",
"tabs.title": "לשוניות",
"toc.title": "תוכן העניינים",
"top.title": "חזרה למעלה"
"source.file.date.updated": "עדכון אחרון",
"tabs": "לשוניות",
"toc": "תוכן העניינים",
"top": "חזרה למעלה"
}[key] }}{% endmacro %}

View File

@ -3,11 +3,12 @@
-#}
{% macro t(key) %}{{ {
"language": "hi",
"action.edit": "इस पृष्ठ को संपादित करें",
"action.skip": "विषय पर बढ़ें",
"clipboard.copy": "क्लिपबोर्ड पर कॉपी करें",
"clipboard.copied": "क्लिपबोर्ड पर कॉपी कर दिया गया",
"edit.link.title": "इस पृष्ठ को संपादित करें",
"footer.previous": "पिछला",
"footer.next": "आगामी",
"footer.previous": "पिछला",
"meta.comments": "टिप्पणियाँ",
"meta.source": "स्रोत",
"search.config.lang": "hi",
@ -16,9 +17,8 @@
"search.result.none": "कोई मिलान डॉक्यूमेंट नहीं",
"search.result.one": "1 मिलान डॉक्यूमेंट",
"search.result.other": "# मिलान डाक्यूमेंट्स",
"skip.link.title": "विषय पर बढ़ें",
"source.link.title": "रिपॉजिटरी पर जाएं",
"source.file.date.updated": "आखिरी अपडेट",
"source": "रिपॉजिटरी पर जाएं",
"source.file.date.created": "बनाया था",
"toc.title": "विषय - सूची"
"source.file.date.updated": "आखिरी अपडेट",
"toc": "विषय - सूची"
}[key] }}{% endmacro %}

View File

@ -3,20 +3,22 @@
-#}
{% macro t(key) %}{{ {
"language": "hr",
"action.edit": "Uredi stranicu",
"action.skip": "Preskočite na sadržaj",
"announce.dismiss": "Ne prikazuj ovo opet",
"clipboard.copy": "Kopirajte u međuspremnik",
"clipboard.copied": "Kopirano u međuspremnik",
"consent.accept": "Prihvati",
"consent.manage": "Upravljaj postavkama",
"consent.reject": "Odbij",
"edit.link.title": "Uredi stranicu",
"footer.previous": "Prethodno",
"footer": "Podnožje",
"footer.next": "Sljedeće",
"footer.title": "Podnožje",
"header.title": "Zaglavlje",
"footer.previous": "Prethodno",
"header": "Zaglavlje",
"meta.comments": "Komentari",
"meta.source": "Izvor",
"nav.title": "Navigacija",
"nav": "Navigacija",
"search": "Pretraživanje",
"search.placeholder": "Pretraživanje",
"search.share": "Podijeli",
"search.reset": "Očisti",
@ -28,14 +30,12 @@
"search.result.more.one": "1 rezultat na ovoj stranici",
"search.result.more.other": "# rezultata na ovoj stranici",
"search.result.term.missing": "Nedostaje",
"search.title": "Pretraživanje",
"select.language.title": "Odabir jezika",
"select.version.title": "Odabir verzije",
"skip.link.title": "Preskočite na sadržaj",
"source.link.title": "Idite u repozitorij",
"source.file.date.updated": "Zadnje ažuriranje",
"select.language": "Odabir jezika",
"select.version": "Odabir verzije",
"source": "Idite u repozitorij",
"source.file.date.created": "Stvoreno",
"tabs.title": "Kartice",
"toc.title": "Sadržaj",
"top.title": "Vratite se na vrh"
"source.file.date.updated": "Zadnje ažuriranje",
"tabs": "Kartice",
"toc": "Sadržaj",
"top": "Vratite se na vrh"
}[key] }}{% endmacro %}

View File

@ -3,16 +3,17 @@
-#}
{% macro t(key) %}{{ {
"language": "hu",
"action.edit": "Oldal szerkesztése",
"action.skip": "Kihagyás",
"clipboard.copy": "Másolás vágólapra",
"clipboard.copied": "Vágólapra másolva",
"edit.link.title": "Oldal szerkesztése",
"footer.previous": "Előző",
"footer": "Élőláb",
"footer.next": "Következő",
"footer.title": "Élőláb",
"header.title": "Élőfej",
"footer.previous": "Előző",
"header": "Élőfej",
"meta.comments": "Hozzászólások",
"meta.source": "Forrás",
"nav.title": "Navigáció",
"nav": "Navigáció",
"search.config.lang": "hu",
"search.placeholder": "Keresés",
"search.reset": "Törlés",
@ -24,10 +25,9 @@
"search.result.more.one": "1 további találat az oldalon",
"search.result.more.other": "# további találat az oldalon",
"search.result.term.missing": "Üres",
"skip.link.title": "Kihagyás",
"source.link.title": "Főoldalra ugrás",
"source.file.date.updated": "Utolsó frissítés",
"source": "Főoldalra ugrás",
"source.file.date.created": "Létrehozva",
"tabs.title": "Lapok",
"toc.title": "Tartalomjegyzék"
"source.file.date.updated": "Utolsó frissítés",
"tabs": "Lapok",
"toc": "Tartalomjegyzék"
}[key] }}{% endmacro %}

View File

@ -3,16 +3,18 @@
-#}
{% macro t(key) %}{{ {
"language": "hy",
"action.edit": "Խմբագրել այս էջը",
"action.skip": "Անցնել պարունակությանը",
"clipboard.copy": "Պատճենել",
"clipboard.copied": "Պատճենված է",
"edit.link.title": "Խմբագրել այս էջը",
"footer.previous": "Նախորդը",
"footer": "Վերջնագիր",
"footer.next": "Հաջորդը",
"footer.title": "Վերջնագիր",
"header.title": "Գլխագիր",
"footer.previous": "Նախորդը",
"header": "Գլխագիր",
"meta.comments": "Մեկնաբանությունները",
"meta.source": "Աղբյուր",
"nav.title": "Տեղորոշում",
"nav": "Տեղորոշում",
"search": "Փնտրում",
"search.config.pipeline": " ",
"search.placeholder": "Փնտրել",
"search.share": "Կիսվել",
@ -25,14 +27,12 @@
"search.result.more.one": "ևս 1-ը այս էջում",
"search.result.more.other": "ևս #-ը այս էջում",
"search.result.term.missing": "Բացակայում է",
"search.title": "Փնտրում",
"select.language.title": "Ընտրել լեզուն",
"select.version.title": "Ընտրել տարբերակը",
"skip.link.title": "Անցնել պարունակությանը",
"source.link.title": "Դեպի պահոց",
"source.file.date.updated": "Վերջին թարմացումը",
"select.language": "Ընտրել լեզուն",
"select.version": "Ընտրել տարբերակը",
"source": "Դեպի պահոց",
"source.file.date.created": "Ստեղծված է",
"tabs.title": "Ներդիրներ",
"toc.title": "Բովանդակություն",
"top.title": "Վերադառնալ սկիզբ"
"source.file.date.updated": "Վերջին թարմացումը",
"tabs": "Ներդիրներ",
"toc": "Բովանդակություն",
"top": "Վերադառնալ սկիզբ"
}[key] }}{% endmacro %}

View File

@ -3,11 +3,12 @@
-#}
{% macro t(key) %}{{ {
"language": "id",
"action.edit": "Ubah halaman ini",
"action.skip": "Lewati ke isi",
"clipboard.copy": "Salin ke memori",
"clipboard.copied": "Tersalin ke memori",
"edit.link.title": "Ubah halaman ini",
"footer.previous": "Sebelumnya",
"footer.next": "Selanjutnya",
"footer.previous": "Sebelumnya",
"meta.comments": "Komentar",
"meta.source": "Sumber",
"search.config.pipeline": " ",
@ -16,8 +17,7 @@
"search.result.none": "Tidak ada dokumen yang sesuai",
"search.result.one": "1 dokumen ditemukan",
"search.result.other": "# dokumen ditemukan",
"skip.link.title": "Lewati ke isi",
"source.link.title": "Menuju repositori",
"source": "Menuju repositori",
"source.file.date.created": "Dibuat",
"toc.title": "Daftar isi"
"toc": "Daftar isi"
}[key] }}{% endmacro %}

View File

@ -3,16 +3,17 @@
-#}
{% macro t(key) %}{{ {
"language": "is",
"action.edit": "Ritvinna þessa síðu",
"action.skip": "Hoppa yfir í efni",
"clipboard.copy": "Afrita í klemmuspjald",
"clipboard.copied": "Afritað í klemmuspjald",
"edit.link.title": "Ritvinna þessa síðu",
"footer.previous": "Fyrra",
"footer": "Síðufótur",
"footer.next": "Næsta",
"footer.title": "Síðufótur",
"header.title": "Haus",
"footer.previous": "Fyrra",
"header": "Haus",
"meta.comments": "Athugasemdir",
"meta.source": "Grunnur",
"nav.title": "Valmynd",
"nav": "Valmynd",
"search.placeholder": "Leit",
"search.reset": "Hreinsa",
"search.result.placeholder": "Sláðu inn til að hefja leit",
@ -21,10 +22,9 @@
"search.result.other": "# skjöl fundust",
"search.result.more.one": "1 til viðbótar á þessari síðu",
"search.result.more.other": "# til viðbótar á þessari síðu",
"skip.link.title": "Hoppa yfir í efni",
"source.link.title": "Fara í gagnahirslu (e. repository)",
"source.file.date.updated": "Síðasta uppfærsla",
"source": "Fara í gagnahirslu (e. repository)",
"source.file.date.created": "Búið til",
"tabs.title": "Flipar",
"toc.title": "Efnisyfirlit"
"source.file.date.updated": "Síðasta uppfærsla",
"tabs": "Flipar",
"toc": "Efnisyfirlit"
}[key] }}{% endmacro %}

View File

@ -3,20 +3,22 @@
-#}
{% macro t(key) %}{{ {
"language": "it",
"action.edit": "Modifica",
"action.skip": "Vai al contenuto",
"announce.dismiss": "Non mostrare più",
"clipboard.copy": "Copia",
"clipboard.copied": "Copiato",
"consent.accept": "Accettazione",
"consent.manage": "Gestisci le opzioni",
"consent.reject": "Rifiuta",
"edit.link.title": "Modifica",
"footer.previous": "Precedente",
"footer": "Piede",
"footer.next": "Prossimo",
"footer.title": "Piede",
"header.title": "Intestazione",
"footer.previous": "Precedente",
"header": "Intestazione",
"meta.comments": "Commenti",
"meta.source": "Sorgente",
"nav.title": "Navigazione",
"nav": "Navigazione",
"search": "Cerca",
"search.config.lang": "it",
"search.placeholder": "Cerca",
"search.share": "Condividi",
@ -29,14 +31,12 @@
"search.result.more.one": "1 altro in questa pagina",
"search.result.more.other": "# altri in questa pagina",
"search.result.term.missing": "Non presente",
"search.title": "Cerca",
"select.language.title": "Seleziona la lingua",
"select.version.title": "Seleziona la versione",
"skip.link.title": "Vai al contenuto",
"source.link.title": "Apri repository",
"source.file.date.updated": "Ultimo aggiornamento",
"select.language": "Seleziona la lingua",
"select.version": "Seleziona la versione",
"source": "Apri repository",
"source.file.date.created": "Creata",
"tabs.title": "Tabs",
"toc.title": "Indice",
"top.title": "Torna su"
"source.file.date.updated": "Ultimo aggiornamento",
"tabs": "Tabs",
"toc": "Indice",
"top": "Torna su"
}[key] }}{% endmacro %}

View File

@ -3,18 +3,19 @@
-#}
{% macro t(key) %}{{ {
"language": "ja",
"action.edit": "編集",
"action.skip": "コンテンツにスキップ",
"clipboard.copy": "クリップボードへコピー",
"clipboard.copied": "コピーしました",
"edit.link.title": "編集",
"footer.previous": "前",
"footer": "フッター",
"footer.next": "次",
"footer.title": "フッター",
"header.title": "ヘッダー",
"footer.previous": "前",
"header": "ヘッダー",
"meta.comments": "コメント",
"meta.source": "ソース",
"nav.title": "ナビゲーション",
"nav": "ナビゲーション",
"search.config.lang": "ja",
"search.config.pipeline": "trimmer, stemmer",
"search.config.pipeline": "stemmer",
"search.config.separator": "[\\s\\- 、。,.]+",
"search.placeholder": "検索",
"search.reset": "クリア",
@ -26,10 +27,9 @@
"search.result.more.one": "このページ内にもう1件見つかりました",
"search.result.more.other": "このページ内にあと#件見つかりました",
"search.result.term.missing": "検索に含まれない",
"skip.link.title": "コンテンツにスキップ",
"source.link.title": "リポジトリへ",
"source.file.date.updated": "最終更新日",
"source": "リポジトリへ",
"source.file.date.created": "作成した",
"tabs.title": "タブ",
"toc.title": "目次"
"source.file.date.updated": "最終更新日",
"tabs": "タブ",
"toc": "目次"
}[key] }}{% endmacro %}

View File

@ -3,14 +3,15 @@
-#}
{% macro t(key) %}{{ {
"language": "ka",
"action.edit": "გვერდის რედარქირება",
"action.skip": "კონტენტზე გადასვლა",
"clipboard.copy": "კოპირება",
"clipboard.copied": "კოპირებულია",
"edit.link.title": "გვერდის რედარქირება",
"footer.previous": "წინა",
"footer.next": "შემდეგი",
"footer.previous": "წინა",
"meta.comments": "კომენტარები",
"meta.source": "წყარო",
"nav.title": "ნავიგაცია",
"nav": "ნავიგაცია",
"search.config.pipeline": " ",
"search.placeholder": "ძებნა",
"search.reset": "გასუფთავება",
@ -20,10 +21,9 @@
"search.result.other": "მოიძებნა # დოკუმენტი",
"search.result.more.one": "კიდევ 1 ამ გვერდზე",
"search.result.more.other": "კიდევ # ამ გვერდზე",
"skip.link.title": "კონტენტზე გადასვლა",
"source.link.title": "საცავში გადასვლა",
"source.file.date.updated": "ბოლო განახლება",
"source": "საცავში გადასვლა",
"source.file.date.created": "შეიქმნა",
"tabs.title": "ტაბები",
"toc.title": "სარჩევი"
"source.file.date.updated": "ბოლო განახლება",
"tabs": "ტაბები",
"toc": "სარჩევი"
}[key] }}{% endmacro %}

View File

@ -2,14 +2,16 @@
This file was automatically generated - do not edit
-#}
{% macro t(key) %}{{ {
"language": "kr",
"language": "ko",
"action.edit": "이 페이지를 편집",
"action.skip": "콘텐츠로 이동",
"clipboard.copy": "클립보드로 복사",
"clipboard.copied": "클립보드에 복사됨",
"edit.link.title": "이 페이지를 편집",
"footer.previous": "이전",
"footer.next": "다음",
"footer.previous": "이전",
"meta.comments": "댓글",
"meta.source": "출처",
"search": "검색",
"search.config.pipeline": " ",
"search.placeholder": "검색",
"search.share": "공유",
@ -22,13 +24,11 @@
"search.result.more.one": "이 문서에서 1개의 검색 결과 더 보기",
"search.result.more.other": "이 문서에서 #개의 검색 결과 더 보기",
"search.result.term.missing": "포함되지 않은 검색어",
"search.title": "검색",
"select.language.title": "언어설정",
"select.version.title": "버전 선택",
"skip.link.title": "콘텐츠로 이동",
"source.link.title": "저장소로 이동",
"source.file.date.updated": "마지막 업데이트",
"select.language": "언어설정",
"select.version": "버전 선택",
"source": "저장소로 이동",
"source.file.date.created": "작성일",
"toc.title": "목차",
"top.title": "맨위로"
"source.file.date.updated": "마지막 업데이트",
"toc": "목차",
"top": "맨위로"
}[key] }}{% endmacro %}

View File

@ -3,16 +3,18 @@
-#}
{% macro t(key) %}{{ {
"language": "lt",
"action.edit": "Redaguoti šį puslapį",
"action.skip": "Pereiti prie turinio",
"clipboard.copy": "Kopijuoti į iškarpinę",
"clipboard.copied": "Nukopijuota į iškarpinę",
"edit.link.title": "Redaguoti šį puslapį",
"footer.previous": "Ankstesnis",
"footer": "Poraštė",
"footer.next": "Sekantis",
"footer.title": "Poraštė",
"header.title": "Antraštė",
"footer.previous": "Ankstesnis",
"header": "Antraštė",
"meta.comments": "Komentarai",
"meta.source": "Išeitinis kodas",
"nav.title": "Navigacija",
"nav": "Navigacija",
"search": "Paieška",
"search.config.pipeline": " ",
"search.placeholder": "Paieška",
"search.share": "Dalintis",
@ -25,14 +27,12 @@
"search.result.more.one": "Dar 1 šiame puslapyje",
"search.result.more.other": "Dar # šiame puslapyje",
"search.result.term.missing": "Nerasta",
"search.title": "Paieška",
"select.language.title": "Pasirinkti kalbą",
"select.version.title": "Pasrinkti versiją",
"skip.link.title": "Pereiti prie turinio",
"source.link.title": "Eiti į saugyklą",
"source.file.date.updated": "Paskutinis atnaujinimas",
"select.language": "Pasirinkti kalbą",
"select.version": "Pasrinkti versiją",
"source": "Eiti į saugyklą",
"source.file.date.created": "Sukurta",
"tabs.title": "Skirtukai",
"toc.title": "Turinys",
"top.title": "Grįžti į viršų"
"source.file.date.updated": "Paskutinis atnaujinimas",
"tabs": "Skirtukai",
"toc": "Turinys",
"top": "Grįžti į viršų"
}[key] }}{% endmacro %}

View File

@ -3,16 +3,17 @@
-#}
{% macro t(key) %}{{ {
"language": "lv",
"action.edit": "Rediģēt šo lapu",
"action.skip": "Pāriet uz saturu",
"clipboard.copy": "Kopēt starpliktuvē",
"clipboard.copied": "Kopēts starpliktuvē",
"edit.link.title": "Rediģēt šo lapu",
"footer.previous": "Iepriekšējais",
"footer": "Kājene",
"footer.next": "Nākamais",
"footer.title": "Kājene",
"header.title": "Galvene",
"footer.previous": "Iepriekšējais",
"header": "Galvene",
"meta.comments": "Komentārs",
"meta.source": "Avots",
"nav.title": "Navigācija",
"nav": "Navigācija",
"search.placeholder": "Meklēt",
"search.reset": "Notīrīt",
"search.result.initializer": "Notiek meklēšanas inicializācija",
@ -23,13 +24,12 @@
"search.result.more.one": "1 šajā lapā",
"search.result.more.other": "# un vairāk šajā lapā",
"search.result.term.missing": "Trūkstošs",
"select.language.title": "Izvēlies valodu",
"select.version.title": "Izvēlies versiju",
"skip.link.title": "Pāriet uz saturu",
"source.link.title": "Doties uz repozitoriju",
"source.file.date.updated": "Pēdējoreiz atjaunots",
"select.language": "Izvēlies valodu",
"select.version": "Izvēlies versiju",
"source": "Doties uz repozitoriju",
"source.file.date.created": "Izveidots",
"tabs.title": "Cilnes",
"toc.title": "Satura rādītājs",
"top.title": "Atpakaļ uz augšu"
"source.file.date.updated": "Pēdējoreiz atjaunots",
"tabs": "Cilnes",
"toc": "Satura rādītājs",
"top": "Atpakaļ uz augšu"
}[key] }}{% endmacro %}

View File

@ -3,16 +3,17 @@
-#}
{% macro t(key) %}{{ {
"language": "mk",
"action.edit": "Уредете ја оваа страница",
"action.skip": "Прескокнете до содржината",
"clipboard.copy": "Копирај во таблата",
"clipboard.copied": "Копирано",
"edit.link.title": "Уредете ја оваа страница",
"footer.previous": "Претходно",
"footer": "Подножје",
"footer.next": "Следно",
"footer.title": "Подножје",
"header.title": "Заглавје",
"footer.previous": "Претходно",
"header": "Заглавје",
"meta.comments": "Коментари",
"meta.source": "Извор",
"nav.title": "Наслов за навигација",
"nav": "Наслов за навигација",
"search.config.lang": "ru",
"search.placeholder": "Пребарување",
"search.reset": "Чисти",
@ -24,13 +25,12 @@
"search.result.more.one": "Уште 1 на оваа страница",
"search.result.more.other": "Уште # на оваа страница",
"search.result.term.missing": "Недостасува",
"select.language.title": "Изберете јазик",
"select.version.title": "Изберете верзија",
"skip.link.title": "Прескокнете до содржината",
"source.link.title": "Одете до складиштето",
"source.file.date.updated": "Последно ажурирање",
"select.language": "Изберете јазик",
"select.version": "Изберете верзија",
"source": "Одете до складиштето",
"source.file.date.created": "Создаден",
"tabs.title": "Јазичиња",
"toc.title": "Содржина",
"top.title": "Вратете се на почетокот"
"source.file.date.updated": "Последно ажурирање",
"tabs": "Јазичиња",
"toc": "Содржина",
"top": "Вратете се на почетокот"
}[key] }}{% endmacro %}

View File

@ -3,16 +3,17 @@
-#}
{% macro t(key) %}{{ {
"language": "mn",
"action.edit": "Хуудас засварлах",
"action.skip": "Агуулгыг алгасах",
"clipboard.copy": "Хуулах",
"clipboard.copied": "Санах ойд хуулах",
"edit.link.title": "Хуудас засварлах",
"footer.previous": "Өмнөх",
"footer": "Хөл",
"footer.next": "Дараах",
"footer.title": "Хөл",
"header.title": "Толгой",
"footer.previous": "Өмнөх",
"header": "Толгой",
"meta.comments": "Сэтгэгдэл",
"meta.source": "Эх үүсвэр",
"nav.title": "Чиглүүлэгч",
"nav": "Чиглүүлэгч",
"search.config.lang": "ru",
"search.placeholder": "Хайлт",
"search.reset": "Цэвэрлэх",
@ -22,10 +23,9 @@
"search.result.other": "# Тохирох баримт бичиг",
"search.result.more.one": "1 илүү хуудас байна",
"search.result.more.other": "# илүү хуудас байна",
"skip.link.title": "Агуулгыг алгасах",
"source.link.title": "Хадгалах сан руу очих",
"source.file.date.updated": "Сүүлийн шинэчлэлт",
"source": "Хадгалах сан руу очих",
"source.file.date.created": "Үүсгэсэн",
"tabs.title": "Табууд",
"toc.title": "Агуулга"
"source.file.date.updated": "Сүүлийн шинэчлэлт",
"tabs": "Табууд",
"toc": "Агуулга"
}[key] }}{% endmacro %}

View File

@ -3,16 +3,17 @@
-#}
{% macro t(key) %}{{ {
"language": "ms",
"action.edit": "Edit halaman ini",
"action.skip": "Langkau tajuk talian",
"clipboard.copy": "Salin ke papan keratan",
"clipboard.copied": "Disalin ke papan keratan",
"edit.link.title": "Edit halaman ini",
"footer.previous": "Sebelumnya",
"footer": "Pengaki",
"footer.next" : "Seterusnya",
"footer.title": "Pengaki",
"header.title": "Pengepala",
"footer.previous": "Sebelumnya",
"header": "Pengepala",
"meta.comments": "Komen",
"meta.source": "Sumber",
"nav.title": "Navigasi",
"nav": "Navigasi",
"search.placeholder": "Cari",
"search.reset": "Padam",
"search.result.initializer": "Siap carian",
@ -23,13 +24,12 @@
"search.result.more.one": "1 lagi di halaman ini",
"search.result.more.other": "# lagi di halaman ini",
"search.result.term.missing": "Hilang",
"select.language.title": "Pilih bahasa",
"select.version.title": "Pilih versi",
"skip.link.title": "Langkau tajuk talian",
"source.link.title": "tajuk talian asal",
"source.file.date.updated": "Tarikh fil dikemas kini",
"select.language": "Pilih bahasa",
"select.version": "Pilih versi",
"source": "tajuk talian asal",
"source.file.date.created": "tarikh fil asal dicipta",
"tabs.title": "Tab",
"toc.title": "Jadual kandungan",
"top.title": "Kembali ke atas"
"source.file.date.updated": "Tarikh fil dikemas kini",
"tabs": "Tab",
"toc": "Jadual kandungan",
"top": "Kembali ke atas"
}[key] }}{% endmacro %}

Some files were not shown because too many files have changed in this diff Show More