2021-02-14 18:54:27 +03:00
|
|
|
# Copyright (c) 2016-2021 Martin Donath <martin.donath@squidfunk.com>
|
2016-02-04 17:03:20 +03:00
|
|
|
|
|
|
|
# Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
|
|
# of this software and associated documentation files (the "Software"), to
|
|
|
|
# deal in the Software without restriction, including without limitation the
|
|
|
|
# rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
|
|
|
|
# sell copies of the Software, and to permit persons to whom the Software is
|
|
|
|
# furnished to do so, subject to the following conditions:
|
|
|
|
|
|
|
|
# The above copyright notice and this permission notice shall be included in
|
|
|
|
# all copies or substantial portions of the Software.
|
|
|
|
|
|
|
|
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
|
|
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
|
|
# FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE
|
|
|
|
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
|
|
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
|
|
|
|
# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
|
|
|
|
# IN THE SOFTWARE.
|
|
|
|
|
|
|
|
# Project information
|
2016-12-28 18:20:52 +03:00
|
|
|
site_name: Material for MkDocs
|
2020-03-29 16:28:00 +03:00
|
|
|
site_url: https://squidfunk.github.io/mkdocs-material/
|
2016-02-04 17:03:20 +03:00
|
|
|
site_author: Martin Donath
|
2020-03-26 17:23:22 +03:00
|
|
|
site_description: >-
|
|
|
|
Create a branded static site from a set of Markdown files to host the
|
2021-07-24 18:58:48 +03:00
|
|
|
documentation of your Open Source or commercial project
|
2016-02-04 17:03:20 +03:00
|
|
|
|
|
|
|
# Repository
|
2016-09-23 12:56:25 +03:00
|
|
|
repo_name: squidfunk/mkdocs-material
|
2016-02-09 14:58:55 +03:00
|
|
|
repo_url: https://github.com/squidfunk/mkdocs-material
|
2017-10-31 23:00:46 +03:00
|
|
|
edit_uri: ""
|
2016-02-04 17:03:20 +03:00
|
|
|
|
|
|
|
# Copyright
|
2021-01-06 19:19:59 +03:00
|
|
|
copyright: Copyright © 2016 - 2021 Martin Donath
|
2016-02-04 17:03:20 +03:00
|
|
|
|
2017-11-03 16:25:37 +03:00
|
|
|
# Configuration
|
2017-10-31 19:03:42 +03:00
|
|
|
theme:
|
|
|
|
name: null
|
2021-06-15 12:35:14 +03:00
|
|
|
custom_dir: !ENV [THEME_DIR, "material"]
|
2017-10-31 19:03:42 +03:00
|
|
|
|
2021-02-25 19:29:11 +03:00
|
|
|
# Static files
|
2017-11-08 01:56:08 +03:00
|
|
|
static_templates:
|
|
|
|
- 404.html
|
|
|
|
|
2017-10-31 22:25:30 +03:00
|
|
|
# Don't include MkDocs' JavaScript
|
|
|
|
include_search_page: false
|
|
|
|
search_index_only: true
|
|
|
|
|
2017-10-31 21:06:19 +03:00
|
|
|
# Default values, taken from mkdocs_theme.yml
|
2021-05-30 13:40:01 +03:00
|
|
|
language: en
|
2020-03-05 18:44:55 +03:00
|
|
|
features:
|
2021-07-18 18:57:45 +03:00
|
|
|
- content.code.annotate
|
2021-06-15 11:55:13 +03:00
|
|
|
- content.tabs.link
|
2021-07-24 18:58:48 +03:00
|
|
|
# - header.autohide
|
|
|
|
# - navigation.expand
|
2021-09-12 17:41:19 +03:00
|
|
|
- navigation.indexes
|
2021-08-07 12:10:15 +03:00
|
|
|
# - navigation.instant
|
2020-12-20 17:00:21 +03:00
|
|
|
- navigation.sections
|
2020-09-27 11:13:41 +03:00
|
|
|
- navigation.tabs
|
2021-07-24 18:58:48 +03:00
|
|
|
# - navigation.tabs.sticky
|
2021-07-01 20:12:40 +03:00
|
|
|
- navigation.top
|
2021-06-15 11:55:13 +03:00
|
|
|
- navigation.tracking
|
|
|
|
- search.highlight
|
|
|
|
- search.share
|
|
|
|
- search.suggest
|
2021-07-24 18:58:48 +03:00
|
|
|
# - toc.integrate
|
2017-10-31 20:51:54 +03:00
|
|
|
palette:
|
2021-03-30 10:06:05 +03:00
|
|
|
- scheme: default
|
2021-03-29 19:46:57 +03:00
|
|
|
primary: indigo
|
|
|
|
accent: indigo
|
|
|
|
toggle:
|
|
|
|
icon: material/toggle-switch-off-outline
|
|
|
|
name: Switch to dark mode
|
2021-03-30 10:06:05 +03:00
|
|
|
- scheme: slate
|
2021-03-29 19:46:57 +03:00
|
|
|
primary: red
|
|
|
|
accent: red
|
|
|
|
toggle:
|
|
|
|
icon: material/toggle-switch
|
|
|
|
name: Switch to light mode
|
2017-10-31 20:21:09 +03:00
|
|
|
font:
|
|
|
|
text: Roboto
|
|
|
|
code: Roboto Mono
|
2020-07-23 11:23:32 +03:00
|
|
|
favicon: assets/favicon.png
|
2020-02-27 13:37:02 +03:00
|
|
|
icon:
|
2020-03-18 14:46:50 +03:00
|
|
|
logo: logo
|
2016-02-04 17:03:20 +03:00
|
|
|
|
2019-06-15 16:16:14 +03:00
|
|
|
# Plugins
|
|
|
|
plugins:
|
2020-01-08 20:17:19 +03:00
|
|
|
- search
|
2020-07-22 14:59:05 +03:00
|
|
|
- redirects:
|
|
|
|
redirect_maps:
|
2021-04-04 11:34:49 +03:00
|
|
|
changelog/insiders.md: insiders/changelog.md
|
2020-07-22 14:59:05 +03:00
|
|
|
extensions/admonition.md: reference/admonitions.md
|
|
|
|
extensions/codehilite.md: reference/code-blocks.md
|
|
|
|
extensions/footnotes.md: reference/footnotes.md
|
|
|
|
extensions/metadata.md: reference/meta-tags.md
|
2020-07-22 15:05:07 +03:00
|
|
|
extensions/permalinks.md: setup/setting-up-navigation.md #permalink
|
2020-07-27 10:22:53 +03:00
|
|
|
extensions/pymdown.md: reference/admonitions.md
|
2020-08-01 21:21:42 +03:00
|
|
|
plugins/revision-date.md: setup/adding-a-git-repository.md #revision-date
|
2020-10-11 13:38:10 +03:00
|
|
|
plugins/search.md: setup/setting-up-site-search.md
|
2020-07-22 15:05:07 +03:00
|
|
|
releases/4.md: upgrading.md #upgrading-from-4x-to-5x
|
|
|
|
releases/5.md: upgrading.md #upgrading-from-3x-to-4x
|
2020-07-22 14:59:05 +03:00
|
|
|
releases/changelog.md: changelog.md
|
2020-10-11 13:20:36 +03:00
|
|
|
setup/adding-social-links.md: setup/setting-up-the-footer.md
|
2021-03-21 16:04:29 +03:00
|
|
|
sponsorship.md: insiders/index.md
|
2019-12-22 19:42:58 +03:00
|
|
|
- minify:
|
|
|
|
minify_html: true
|
2019-06-15 16:16:14 +03:00
|
|
|
|
2017-11-03 16:25:37 +03:00
|
|
|
# Customization
|
2016-02-04 17:03:20 +03:00
|
|
|
extra:
|
2021-06-06 18:32:30 +03:00
|
|
|
analytics:
|
|
|
|
provider: google
|
2021-06-15 12:35:14 +03:00
|
|
|
property: !ENV GOOGLE_ANALYTICS_KEY
|
2016-12-26 20:26:34 +03:00
|
|
|
social:
|
2020-03-09 23:14:47 +03:00
|
|
|
- icon: fontawesome/brands/github
|
2016-12-26 20:26:34 +03:00
|
|
|
link: https://github.com/squidfunk
|
2020-03-09 23:14:47 +03:00
|
|
|
- icon: fontawesome/brands/gitter
|
|
|
|
link: https://gitter.im/squidfunk/mkdocs-material
|
|
|
|
- icon: fontawesome/brands/docker
|
|
|
|
link: https://hub.docker.com/r/squidfunk/mkdocs-material/
|
2020-02-27 13:37:02 +03:00
|
|
|
- icon: fontawesome/brands/twitter
|
2016-12-26 20:26:34 +03:00
|
|
|
link: https://twitter.com/squidfunk
|
2020-02-27 13:37:02 +03:00
|
|
|
- icon: fontawesome/brands/linkedin
|
2020-03-09 23:14:47 +03:00
|
|
|
link: https://linkedin.com/in/squidfunk/
|
2020-02-27 13:37:02 +03:00
|
|
|
- icon: fontawesome/brands/instagram
|
2020-02-02 18:19:01 +03:00
|
|
|
link: https://instagram.com/squidfunk
|
2016-02-04 17:03:20 +03:00
|
|
|
|
|
|
|
# Extensions
|
|
|
|
markdown_extensions:
|
2020-10-04 15:08:50 +03:00
|
|
|
- admonition
|
|
|
|
- abbr
|
|
|
|
- attr_list
|
|
|
|
- def_list
|
|
|
|
- footnotes
|
|
|
|
- meta
|
2020-12-21 19:38:58 +03:00
|
|
|
- md_in_html
|
2020-10-04 15:08:50 +03:00
|
|
|
- toc:
|
2017-10-20 10:37:18 +03:00
|
|
|
permalink: true
|
2020-07-24 17:11:42 +03:00
|
|
|
- pymdownx.arithmatex:
|
|
|
|
generic: true
|
2017-10-20 10:37:18 +03:00
|
|
|
- pymdownx.betterem:
|
|
|
|
smart_enable: all
|
2016-11-02 21:21:14 +03:00
|
|
|
- pymdownx.caret
|
2017-08-29 09:17:26 +03:00
|
|
|
- pymdownx.details
|
2017-01-10 00:25:15 +03:00
|
|
|
- pymdownx.emoji:
|
2020-04-12 20:58:22 +03:00
|
|
|
emoji_index: !!python/name:materialx.emoji.twemoji
|
|
|
|
emoji_generator: !!python/name:materialx.emoji.to_svg
|
2020-07-19 23:23:26 +03:00
|
|
|
- pymdownx.highlight
|
2016-11-02 21:21:14 +03:00
|
|
|
- pymdownx.inlinehilite
|
2018-01-12 01:17:33 +03:00
|
|
|
- pymdownx.keys
|
2019-01-29 13:07:18 +03:00
|
|
|
- pymdownx.magiclink:
|
|
|
|
repo_url_shorthand: true
|
|
|
|
user: squidfunk
|
|
|
|
repo: mkdocs-material
|
2016-11-02 21:21:14 +03:00
|
|
|
- pymdownx.mark
|
|
|
|
- pymdownx.smartsymbols
|
2020-08-30 14:05:58 +03:00
|
|
|
- pymdownx.superfences:
|
|
|
|
custom_fences:
|
|
|
|
- name: mermaid
|
2021-06-15 13:14:11 +03:00
|
|
|
class: mermaid-experimental
|
2020-08-30 14:05:58 +03:00
|
|
|
format: !!python/name:pymdownx.superfences.fence_code_format
|
2021-08-08 11:46:45 +03:00
|
|
|
- pymdownx.tabbed:
|
|
|
|
alternate_style: true
|
2017-10-20 10:37:18 +03:00
|
|
|
- pymdownx.tasklist:
|
|
|
|
custom_checkbox: true
|
2016-11-02 21:21:14 +03:00
|
|
|
- pymdownx.tilde
|
|
|
|
|
2016-02-04 17:03:20 +03:00
|
|
|
# Page tree
|
2018-08-04 20:53:13 +03:00
|
|
|
nav:
|
2020-03-09 21:03:48 +03:00
|
|
|
- Home: index.md
|
2020-05-31 16:40:41 +03:00
|
|
|
- Getting started:
|
|
|
|
- Installation: getting-started.md
|
2020-07-17 14:08:27 +03:00
|
|
|
- Creating your site: creating-your-site.md
|
|
|
|
- Publishing your site: publishing-your-site.md
|
|
|
|
- Customization: customization.md
|
2020-07-22 19:30:00 +03:00
|
|
|
- Troubleshooting: troubleshooting.md
|
2020-07-17 14:08:27 +03:00
|
|
|
- Data privacy: data-privacy.md
|
2020-07-22 14:37:14 +03:00
|
|
|
- License: license.md
|
2021-03-21 16:04:29 +03:00
|
|
|
- Releases:
|
|
|
|
- Changelog: changelog.md
|
2021-03-21 19:14:32 +03:00
|
|
|
- Upgrade guide: upgrading.md
|
2021-03-21 16:04:29 +03:00
|
|
|
- Deprecations: deprecations.md
|
2020-07-21 17:01:22 +03:00
|
|
|
- Setup:
|
|
|
|
- Changing the colors: setup/changing-the-colors.md
|
|
|
|
- Changing the fonts: setup/changing-the-fonts.md
|
|
|
|
- Changing the language: setup/changing-the-language.md
|
|
|
|
- Changing the logo and icons: setup/changing-the-logo-and-icons.md
|
|
|
|
- Setting up navigation: setup/setting-up-navigation.md
|
|
|
|
- Setting up site search: setup/setting-up-site-search.md
|
2020-07-22 10:54:17 +03:00
|
|
|
- Setting up site analytics: setup/setting-up-site-analytics.md
|
2021-07-25 16:40:40 +03:00
|
|
|
- Setting up social cards: setup/setting-up-social-cards.md
|
2021-05-01 18:53:39 +03:00
|
|
|
- Setting up tags: setup/setting-up-tags.md
|
2020-10-25 18:14:02 +03:00
|
|
|
- Setting up versioning: setup/setting-up-versioning.md
|
2020-08-30 17:51:03 +03:00
|
|
|
- Setting up the header: setup/setting-up-the-header.md
|
2020-10-11 13:20:36 +03:00
|
|
|
- Setting up the footer: setup/setting-up-the-footer.md
|
2020-07-22 14:37:14 +03:00
|
|
|
- Adding a git repository: setup/adding-a-git-repository.md
|
2020-07-21 17:01:22 +03:00
|
|
|
- Adding a comment system: setup/adding-a-comment-system.md
|
2020-07-21 14:33:44 +03:00
|
|
|
- Reference:
|
2020-09-19 15:34:40 +03:00
|
|
|
- Abbreviations: reference/abbreviations.md
|
2020-07-21 14:33:44 +03:00
|
|
|
- Admonitions: reference/admonitions.md
|
2020-07-27 13:32:24 +03:00
|
|
|
- Buttons: reference/buttons.md
|
2020-07-21 14:33:44 +03:00
|
|
|
- Code blocks: reference/code-blocks.md
|
|
|
|
- Content tabs: reference/content-tabs.md
|
2020-08-04 23:22:47 +03:00
|
|
|
- Data tables: reference/data-tables.md
|
2021-01-02 17:55:31 +03:00
|
|
|
- Diagrams: reference/diagrams.md
|
2020-07-21 14:33:44 +03:00
|
|
|
- Footnotes: reference/footnotes.md
|
2020-07-27 13:05:07 +03:00
|
|
|
- Formatting: reference/formatting.md
|
2020-07-24 10:59:16 +03:00
|
|
|
- Icons + Emojis: reference/icons-emojis.md
|
2020-07-27 17:49:39 +03:00
|
|
|
- Images: reference/images.md
|
2020-07-21 14:33:44 +03:00
|
|
|
- Lists: reference/lists.md
|
2020-07-24 17:11:42 +03:00
|
|
|
- MathJax: reference/mathjax.md
|
2020-07-22 14:37:14 +03:00
|
|
|
- Meta tags: reference/meta-tags.md
|
2020-09-20 12:24:46 +03:00
|
|
|
- Variables: reference/variables.md
|
2021-03-21 16:04:29 +03:00
|
|
|
- Insiders:
|
2021-09-23 09:53:51 +03:00
|
|
|
- insiders/index.md
|
2021-03-21 16:04:29 +03:00
|
|
|
- Getting started:
|
|
|
|
- Installation: insiders/getting-started.md
|
|
|
|
- Changelog: insiders/changelog.md
|
2021-09-13 17:13:05 +03:00
|
|
|
- Blog:
|
|
|
|
- blog/index.md
|
|
|
|
- 2021:
|
|
|
|
- blog/2021/search-better-faster-smaller.md
|