mirror of
https://github.com/squidfunk/mkdocs-material.git
synced 2026-07-29 17:22:37 -04:00
Added docs on extended formatting
This commit is contained in:
@@ -59,16 +59,16 @@ theme:
|
||||
|
||||
Some popular choices:
|
||||
|
||||
- :fontawesome-brands-git: – `fontawesome/brands/git`
|
||||
- :fontawesome-brands-git-alt: – `fontawesome/brands/git-alt`
|
||||
- :fontawesome-brands-git-square: – `fontawesome/brands/git-square`
|
||||
- :fontawesome-brands-github: – `fontawesome/brands/github`
|
||||
- :fontawesome-brands-github-alt: – `fontawesome/brands/github-alt`
|
||||
- :fontawesome-brands-github-square: – `fontawesome/brands/github-square`
|
||||
- :fontawesome-brands-gitlab: – `fontawesome/brands/gitlab`
|
||||
- :fontawesome-brands-gitkraken: – `fontawesome/brands/gitkraken`
|
||||
- :fontawesome-brands-bitbucket: – `fontawesome/brands/bitbucket`
|
||||
- :fontawesome-solid-trash: – `fontawesome/solid/trash`
|
||||
* :fontawesome-brands-git: – `fontawesome/brands/git`
|
||||
* :fontawesome-brands-git-alt: – `fontawesome/brands/git-alt`
|
||||
* :fontawesome-brands-git-square: – `fontawesome/brands/git-square`
|
||||
* :fontawesome-brands-github: – `fontawesome/brands/github`
|
||||
* :fontawesome-brands-github-alt: – `fontawesome/brands/github-alt`
|
||||
* :fontawesome-brands-github-square: – `fontawesome/brands/github-square`
|
||||
* :fontawesome-brands-gitlab: – `fontawesome/brands/gitlab`
|
||||
* :fontawesome-brands-gitkraken: – `fontawesome/brands/gitkraken`
|
||||
* :fontawesome-brands-bitbucket: – `fontawesome/brands/bitbucket`
|
||||
* :fontawesome-solid-trash: – `fontawesome/solid/trash`
|
||||
|
||||
[4]: https://github.com/squidfunk/mkdocs-material/tree/master/material/.icons
|
||||
|
||||
|
||||
@@ -37,16 +37,16 @@ For each entry, the following fields are available:
|
||||
This field must point to a valid icon path referencing [any icon bundled
|
||||
with the theme][2], or the build will not succeed. Some popular choices:
|
||||
|
||||
- :fontawesome-brands-behance: – `fontawesome/brands/behance`
|
||||
- :fontawesome-brands-docker: – `fontawesome/brands/docker`
|
||||
- :fontawesome-brands-github: – `fontawesome/brands/github`
|
||||
- :fontawesome-brands-instagram: – `fontawesome/brands/instagram`
|
||||
- :fontawesome-brands-linkedin: – `fontawesome/brands/linkedin`
|
||||
- :fontawesome-brands-medium: – `fontawesome/brands/medium`
|
||||
- :fontawesome-brands-pied-piper-alt: – `fontawesome/brands/pied-piper-alt`
|
||||
- :fontawesome-brands-product-hunt: – `fontawesome/brands/product-hunt`
|
||||
- :fontawesome-brands-slack: – `fontawesome/brands/slack`
|
||||
- :fontawesome-brands-twitter: – `fontawesome/brands/twitter`
|
||||
* :fontawesome-brands-behance: – `fontawesome/brands/behance`
|
||||
* :fontawesome-brands-docker: – `fontawesome/brands/docker`
|
||||
* :fontawesome-brands-github: – `fontawesome/brands/github`
|
||||
* :fontawesome-brands-instagram: – `fontawesome/brands/instagram`
|
||||
* :fontawesome-brands-linkedin: – `fontawesome/brands/linkedin`
|
||||
* :fontawesome-brands-medium: – `fontawesome/brands/medium`
|
||||
* :fontawesome-brands-pied-piper-alt: – `fontawesome/brands/pied-piper-alt`
|
||||
* :fontawesome-brands-product-hunt: – `fontawesome/brands/product-hunt`
|
||||
* :fontawesome-brands-slack: – `fontawesome/brands/slack`
|
||||
* :fontawesome-brands-twitter: – `fontawesome/brands/twitter`
|
||||
|
||||
[1]: https://github.com/squidfunk/mkdocs-material/blob/master/src/partials/social.html
|
||||
[2]: https://github.com/squidfunk/mkdocs-material/tree/master/material/.icons
|
||||
|
||||
@@ -196,9 +196,9 @@ to navigate your project documentation via keyboard. There're two modes:
|
||||
: This mode is active when the _search is focused_. It provides several key
|
||||
bindings to make search accessible and navigable via keyboard:
|
||||
|
||||
- ++arrow-down++ , ++arrow-up++ : select next / previous result
|
||||
- ++esc++ , ++tab++ : close search dialog
|
||||
- ++enter++ : follow selected result
|
||||
* ++arrow-down++ , ++arrow-up++ : select next / previous result
|
||||
* ++esc++ , ++tab++ : close search dialog
|
||||
* ++enter++ : follow selected result
|
||||
|
||||
`global`{: #global }
|
||||
|
||||
@@ -206,9 +206,9 @@ to navigate your project documentation via keyboard. There're two modes:
|
||||
focussed element that is susceptible to keyboard input. The following keys
|
||||
are bound:
|
||||
|
||||
- ++f++ , ++s++ , ++slash++ : open search dialog
|
||||
- ++p++ , ++comma++ : go to previous page
|
||||
- ++n++ , ++period++ : go to next page
|
||||
* ++f++ , ++s++ , ++slash++ : open search dialog
|
||||
* ++p++ , ++comma++ : go to previous page
|
||||
* ++n++ , ++period++ : go to next page
|
||||
|
||||
Let's say you want to bind some action to the ++x++ key. By using [additional
|
||||
JavaScript][11], you can subscribe to the `keyboard$` observable and attach
|
||||
|
||||
@@ -256,15 +256,15 @@ 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`][17]
|
||||
- [:octicons-file-code-24: `SearchIndex` and `SearchResult`][18]
|
||||
* [:octicons-file-code-24: `SearchMessage`][17]
|
||||
* [:octicons-file-code-24: `SearchIndex` and `SearchResult`][18]
|
||||
|
||||
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`
|
||||
* :octicons-arrow-right-24: `SearchSetupMessage`
|
||||
* :octicons-arrow-left-24: `SearchReadyMessage`
|
||||
* :octicons-arrow-right-24: `SearchQueryMessage`
|
||||
* :octicons-arrow-left-24: `SearchResultMessage`
|
||||
|
||||
[15]: https://github.com/squidfunk/mkdocs-material/blob/master/src/assets/javascripts/integrations/search/worker
|
||||
[16]: https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Using_web_workers
|
||||
|
||||
Reference in New Issue
Block a user