1
0
mirror of https://github.com/squidfunk/mkdocs-material.git synced 2024-11-28 01:10:58 +01:00

Added documentation on footer setup

This commit is contained in:
squidfunk 2020-10-11 12:20:36 +02:00
parent 58cb2a2690
commit 76a0b305ed
6 changed files with 65 additions and 56 deletions

View File

@ -72,7 +72,7 @@ icons and much more:
* [Setting up site search][8] * [Setting up site search][8]
* [Setting up site analytics][9] * [Setting up site analytics][9]
* [Setting up the header][10] * [Setting up the header][10]
* [Adding social links][11] * [Setting up the footer][11]
* [Adding a git repository][12] * [Adding a git repository][12]
* [Adding a comment system][13] * [Adding a comment system][13]
<!-- * [Adding a landing page][14] --> <!-- * [Adding a landing page][14] -->
@ -86,7 +86,7 @@ icons and much more:
[8]: setup/setting-up-site-search.md [8]: setup/setting-up-site-search.md
[9]: setup/setting-up-site-analytics.md [9]: setup/setting-up-site-analytics.md
[10]: setup/setting-up-the-header.md [10]: setup/setting-up-the-header.md
[11]: setup/adding-social-links.md [11]: setup/setting-up-the-footer.md
[12]: setup/adding-a-git-repository.md [12]: setup/adding-a-git-repository.md
[13]: setup/adding-a-comment-system.md [13]: setup/adding-a-comment-system.md
<!--[14]: setup/adding-a-landing-page.md--> <!--[14]: setup/adding-a-landing-page.md-->

View File

@ -59,33 +59,33 @@ monthly subscription, which you can do at any time.__
The following list shows which features are currently only available in Material The following list shows which features are currently only available in Material
for MkDocs Insiders. You can click on each feature to learn more about it: for MkDocs Insiders. You can click on each feature to learn more about it:
- [x] [Support for user-toggleable themes (light/dark mode switch)][11] - [x] [Remove _Made with Material for MkDocs_ from footer][11]
- [x] [Highlighting of matched search terms in content area][12] - [x] [Support for user-toggleable themes (light/dark mode switch)][12]
- [x] [Navigation can always be expanded via configuration][13] - [x] [Highlighting of matched search terms in content area][13]
- [x] [Header can be automatically hidden on scrolling][14] - [x] [Navigation can always be expanded via configuration][14]
- [x] [Table of contents can be automatically hidden when empty][15] - [x] [Header can be automatically hidden on scrolling][15]
- [x] [Table of contents can be automatically hidden when empty][16]
[11]: setup/changing-the-colors.md#color-palette-toggle [11]: setup/setting-up-the-footer.md#remove-generator
[12]: setup/setting-up-site-search.md#highlighting-search [12]: setup/changing-the-colors.md#color-palette-toggle
[13]: setup/setting-up-navigation.md#navigation-expansion [13]: setup/setting-up-site-search.md#highlighting-search
[14]: setup/setting-up-the-header.md#automatic-hiding [14]: setup/setting-up-navigation.md#navigation-expansion
[15]: setup/setting-up-navigation.md#automatic-hiding [15]: setup/setting-up-the-header.md#automatic-hiding
[16]: setup/setting-up-navigation.md#automatic-hiding
## Roadmap ## Roadmap
The following list of funding goals named after varieties of chili peppers The following list of funding goals named after varieties of chili peppers
[I'm growing on my balcony][16] shows which features are already available [I'm growing on my balcony][17] shows which features are already available
in Material for MkDocs Insiders. in Material for MkDocs Insiders.
[16]: https://www.instagram.com/squidfunk/ [17]: https://www.instagram.com/squidfunk/
### Madame Jeanette ### Madame Jeanette :octicons-check-24:
[:octicons-flame-24: Funding goal: __$500__][6] · [:octicons-flame-24: Funding goal: __$500__][6] ·
:octicons-unlock-24: Status: _released_ :octicons-unlock-24: Status: _released_
New features and improvements for _search_, including:
- [x] Improved search result grouping (pages + headings) - [x] Improved search result grouping (pages + headings)
- [x] Improved search result relevance and scoring - [x] Improved search result relevance and scoring
- [x] Display of missing query terms in search results - [x] Display of missing query terms in search results
@ -95,12 +95,10 @@ New features and improvements for _search_, including:
[:octicons-flame-24: Funding goal: __$1,000__][6] · [:octicons-flame-24: Funding goal: __$1,000__][6] ·
:octicons-lock-24: Status: _exclusive_ :octicons-lock-24: Status: _exclusive_
New features and improvements for _content and toc_, including: - [x] [Highlighting of matched search terms in content area][13]
- [x] [Navigation can always be expanded via configuration][14]
- [x] [Highlighting of matched search terms in content area][12] - [x] [Header can be automatically hidden on scrolling][15]
- [x] [Navigation can always be expanded via configuration][13] - [x] [Table of contents can be automatically hidden when empty][16]
- [x] [Header can be automatically hidden on scrolling][14]
- [x] [Table of contents can be automatically hidden when empty][15]
- [ ] Table of contents can be moved into navigation for more space - [ ] Table of contents can be moved into navigation for more space
- [ ] Table of contents shows which sections have search results - [ ] Table of contents shows which sections have search results
- [ ] Table of contents auto-collapses and expands only the active section - [ ] Table of contents auto-collapses and expands only the active section
@ -111,8 +109,6 @@ New features and improvements for _content and toc_, including:
[:octicons-flame-24: Funding goal: __$1,500__][6] · [:octicons-flame-24: Funding goal: __$1,500__][6] ·
:octicons-lock-24: Status: _exclusive_ :octicons-lock-24: Status: _exclusive_
New features and improvements for _hosting multiple versions_, including:
- [ ] Support for multiple languages of documents - [ ] Support for multiple languages of documents
- [ ] Support for multiple versions of documents - [ ] Support for multiple versions of documents
- [ ] Support for one or more management plugins - [ ] Support for one or more management plugins
@ -122,9 +118,7 @@ New features and improvements for _hosting multiple versions_, including:
[:octicons-flame-24: Funding goal: __$2,000__][6] · [:octicons-flame-24: Funding goal: __$2,000__][6] ·
:octicons-lock-24: Status: _exclusive_ :octicons-lock-24: Status: _exclusive_
New features and improvements for _user preferences_, including: - [x] [Support for user-toggleable themes (light/dark mode switch)][12]
- [x] [Support for user-toggleable themes (light/dark mode switch)][11]
- [ ] Support for user-toggleable code-block styles (light/dark mode switch) - [ ] Support for user-toggleable code-block styles (light/dark mode switch)
### Biquinho Vermelho ### Biquinho Vermelho
@ -132,8 +126,6 @@ New features and improvements for _user preferences_, including:
[:octicons-flame-24: Funding goal: __$2,500__][6] · [:octicons-flame-24: Funding goal: __$2,500__][6] ·
:octicons-lock-24: Status: _exclusive_ :octicons-lock-24: Status: _exclusive_
Even more features and improvements for _search_, including:
- [ ] Support for search suggestions - [ ] Support for search suggestions
- [ ] Support for a user's last searches - [ ] Support for a user's last searches
- [ ] Improved search result summaries - [ ] Improved search result summaries
@ -143,9 +135,8 @@ Even more features and improvements for _search_, including:
[:octicons-flame-24: Funding goal: __$3,000__][6] · [:octicons-flame-24: Funding goal: __$3,000__][6] ·
:octicons-lock-24: Status: _exclusive_ :octicons-lock-24: Status: _exclusive_
Alternative, completely different _vertical layout_, optimized to read - [x] [Remove _Made with Material for MkDocs_ from footer][11]
documentation and code side-by-side, e.g. for the documentation of APIs with - [ ] Brand-new and exclusive vertical layout
the same functionality as Material for MkDocs.
## Frequently asked questions ## Frequently asked questions
@ -160,9 +151,11 @@ improvements (e.g. search) do not require any changes to existing configuration.
This means that your users will be able to build the docs locally with the This means that your users will be able to build the docs locally with the
regular version and when they push their changes to CI/CD, they will be built regular version and when they push their changes to CI/CD, they will be built
with Material for MkDocs Insiders. For this reason, it's recommended to with Material for MkDocs Insiders. For this reason, it's recommended to
[install Insiders][17] only in CI, as you don't want to expose your `GH_TOKEN` [install Insiders][18] only in CI, as you don't want to expose your `GH_TOKEN`
to users. to users.
[18]: publishing-your-site.md#github-pages
### Terms ### Terms
_We're using Material for MkDocs to build the developer documentation of a _We're using Material for MkDocs to build the developer documentation of a
@ -171,7 +164,7 @@ terms?_
Yes. Whether you're an individual or a company, you may use _Material for MkDocs Yes. Whether you're an individual or a company, you may use _Material for MkDocs
Insiders_ precisely under the same terms as Material for MkDocs, which are given Insiders_ precisely under the same terms as Material for MkDocs, which are given
by the [MIT license][18]. However, we kindly ask you to respect the following by the [MIT license][19]. However, we kindly ask you to respect the following
guidelines: guidelines:
- Please __don't distribute the source code__ from Material for MkDocs Insiders. - Please __don't distribute the source code__ from Material for MkDocs Insiders.
@ -182,8 +175,7 @@ guidelines:
- If you cancel your subscription, you're removed as a collaborator and will - If you cancel your subscription, you're removed as a collaborator and will
miss out on future updates of Material for MkDocs Insiders. However, you may miss out on future updates of Material for MkDocs Insiders. However, you may
__use the latest version__ that's available to you __as long as you like__. __use the latest version__ that's available to you __as long as you like__.
Just remember that __[GitHub deletes private forks][19]__. Just remember that __[GitHub deletes private forks][20]__.
[17]: publishing-your-site.md#github-pages [19]: license.md
[18]: license.md [20]: https://docs.github.com/en/github/setting-up-and-managing-your-github-user-account/removing-a-collaborator-from-a-personal-repository
[19]: https://docs.github.com/en/github/setting-up-and-managing-your-github-user-account/removing-a-collaborator-from-a-personal-repository

View File

@ -19,7 +19,7 @@ made available [offline][1].
[:octicons-cpu-24: Plugin][3] [:octicons-cpu-24: Plugin][3]
The [built-in search plugin][3] integrates seamlessly with Material for MkDocs, The [built-in search plugin][3] integrates seamlessly with Material for MkDocs,
adding multilingual client-side search with [lunr][5] and [lunr-languages][6]. adding multilingual client-side search with [lunr][4] and [lunr-languages][5].
It's enabled by default, but must be re-added to `mkdocs.yml` when other plugins It's enabled by default, but must be re-added to `mkdocs.yml` when other plugins
are used: are used:
@ -33,9 +33,9 @@ The following options are supported:
`lang`{: #lang } `lang`{: #lang }
: :octicons-milestone-24: Default: _automatically set_ This option allows : :octicons-milestone-24: Default: _automatically set_ This option allows
to include the language-specific stemmers provided by [lunr-languages][6]. to include the language-specific stemmers provided by [lunr-languages][5].
Note that Material for MkDocs will set this automatically based on the Note that Material for MkDocs will set this automatically based on the
[site language][7], but it may be overridden, e.g. to support multiple [site language][6], but it may be overridden, e.g. to support multiple
languages: languages:
=== "A single language" === "A single language"
@ -105,7 +105,7 @@ The following options are supported:
`prebuild_index`{: #prebuild-index } `prebuild_index`{: #prebuild-index }
: :octicons-milestone-24: Default: `false` · :octicons-beaker-24: : :octicons-milestone-24: Default: `false` · :octicons-beaker-24:
Experimental MkDocs can generate a [prebuilt index][8] of all pages during Experimental MkDocs can generate a [prebuilt index][7] of all pages during
build time, which provides performance improvements at the cost of more build time, which provides performance improvements at the cost of more
bandwidth, as it reduces the build time of the search index: bandwidth, as it reduces the build time of the search index:
@ -125,18 +125,17 @@ them at your own risk._
[2]: https://github.com/squidfunk/mkdocs-material/tree/master/src/assets/javascripts/integrations/search [2]: https://github.com/squidfunk/mkdocs-material/tree/master/src/assets/javascripts/integrations/search
[3]: https://www.mkdocs.org/user-guide/configuration/#search [3]: https://www.mkdocs.org/user-guide/configuration/#search
[4]: ../insiders.md [4]: https://lunrjs.com
[5]: https://lunrjs.com [5]: https://github.com/MihaiValentin/lunr-languages
[6]: https://github.com/MihaiValentin/lunr-languages [6]: changing-the-language.md#site-language
[7]: changing-the-language.md#site-language [7]: https://www.mkdocs.org/user-guide/configuration/#prebuild_index
[8]: https://www.mkdocs.org/user-guide/configuration/#prebuild_index
### Highlighting search ### Highlighting search
[:octicons-file-code-24: Source][4] · [:octicons-file-code-24: Source][8] ·
:octicons-unlock-24: Feature flag · :octicons-unlock-24: Feature flag ·
:octicons-beaker-24: Experimental · :octicons-beaker-24: Experimental ·
[:octicons-heart-fill-24:{: .tx-heart } Insiders only][4]{: .tx-insiders } [:octicons-heart-fill-24:{: .tx-heart } Insiders only][8]{: .tx-insiders }
When _search highlighting_ is activated and a user clicks on a search result, When _search highlighting_ is activated and a user clicks on a search result,
Material for MkDocs will highlight all occurrences after following the link. Material for MkDocs will highlight all occurrences after following the link.
@ -155,6 +154,7 @@ Searching for `"code blocks"` yields:
_Give this feature a try on [the official documentation][10] built with Material _Give this feature a try on [the official documentation][10] built with Material
for MkDocs Insiders!_ for MkDocs Insiders!_
[8]: ../insiders.md
[9]: ../assets/screenshots/search-highlighting.png [9]: ../assets/screenshots/search-highlighting.png
[10]: https://squidfunk.github.io/mkdocs-material-insiders/reference/code-blocks/?h=code+blocks [10]: https://squidfunk.github.io/mkdocs-material-insiders/reference/code-blocks/?h=code+blocks

View File

@ -2,7 +2,7 @@
template: overrides/main.html template: overrides/main.html
--- ---
# Adding social links # Setting up the footer
The footer of your project documentation is a great place to add links to The footer of your project documentation is a great place to add links to
websites or platforms you or your company are using as additional marketing websites or platforms you or your company are using as additional marketing
@ -89,6 +89,22 @@ For each entry, the following fields are available:
name: squidfunk on Twitter name: squidfunk on Twitter
``` ```
### Remove generator
[:octicons-file-code-24: Source][8] ·
[:octicons-heart-fill-24:{: .tx-heart } Insiders only][8]{: .tx-insiders }
The footer displays a __Made with Material for MkDocs__ notice to denote how
the site was generated. The notice can be removed with the following setting
via `mkdocs.yml`:
``` yaml
extra:
generator: false
```
[8]: ../insiders.md
## Customization ## Customization
### Custom icons ### Custom icons

View File

@ -72,8 +72,8 @@ The templates have undergone a set of changes to make them future-proof. If
you've used theme extension to override a block or template, make sure that it you've used theme extension to override a block or template, make sure that it
matches the new structure: matches the new structure:
- If you've overridden a **block**, check `base.html` for potential changes - If you've overridden a __block__, check `base.html` for potential changes
- If you've overridden a **template**, check the respective `*.html` file for - If you've overridden a __template__, check the respective `*.html` file for
potential changes potential changes
??? quote "`base.html`" ??? quote "`base.html`"
@ -433,8 +433,8 @@ The templates have undergone a set of changes to make them future-proof. If
you've used theme extension to override a block or template, make sure that it you've used theme extension to override a block or template, make sure that it
matches the new structure: matches the new structure:
- If you've overridden a **block**, check `base.html` for potential changes - If you've overridden a __block__, check `base.html` for potential changes
- If you've overridden a **template**, check the respective `*.html` file for - If you've overridden a __template__, check the respective `*.html` file for
potential changes potential changes
??? quote "`base.html`" ??? quote "`base.html`"

View File

@ -80,6 +80,7 @@ plugins:
releases/4.md: upgrading.md #upgrading-from-4x-to-5x releases/4.md: upgrading.md #upgrading-from-4x-to-5x
releases/5.md: upgrading.md #upgrading-from-3x-to-4x releases/5.md: upgrading.md #upgrading-from-3x-to-4x
releases/changelog.md: changelog.md releases/changelog.md: changelog.md
setup/adding-social-links.md: setup/setting-up-the-footer.md
sponsorship.md: insiders.md sponsorship.md: insiders.md
- minify: - minify:
minify_html: true minify_html: true
@ -162,7 +163,7 @@ nav:
- Setting up site search: setup/setting-up-site-search.md - Setting up site search: setup/setting-up-site-search.md
- Setting up site analytics: setup/setting-up-site-analytics.md - Setting up site analytics: setup/setting-up-site-analytics.md
- Setting up the header: setup/setting-up-the-header.md - Setting up the header: setup/setting-up-the-header.md
- Adding social links: setup/adding-social-links.md - Setting up the footer: setup/setting-up-the-footer.md
- Adding a git repository: setup/adding-a-git-repository.md - Adding a git repository: setup/adding-a-git-repository.md
- Adding a comment system: setup/adding-a-comment-system.md - Adding a comment system: setup/adding-a-comment-system.md
#- Adding a landing page: setup/adding-a-landing-page.md #- Adding a landing page: setup/adding-a-landing-page.md