Documentation

This commit is contained in:
squidfunk 2021-11-14 08:46:35 +01:00
parent b4e0467878
commit 0f5cba40ac
3 changed files with 9 additions and 11 deletions

View File

@ -103,6 +103,7 @@ assets may also be put in the `overrides` directory:
│ │ ├─ analytics/ # Analytics integrations │ │ ├─ analytics/ # Analytics integrations
│ │ └─ analytics.html # Analytics setup │ │ └─ analytics.html # Analytics setup
│ ├─ languages/ # Translation languages │ ├─ languages/ # Translation languages
│ ├─ content.html # Page content
│ ├─ copyright.html # Copyright and theme information │ ├─ copyright.html # Copyright and theme information
│ ├─ footer.html # Footer bar │ ├─ footer.html # Footer bar
│ ├─ header.html # Header bar │ ├─ header.html # Header bar
@ -110,9 +111,6 @@ assets may also be put in the `overrides` directory:
│ ├─ logo.html # Logo in header and sidebar │ ├─ logo.html # Logo in header and sidebar
│ ├─ nav.html # Main navigation │ ├─ nav.html # Main navigation
│ ├─ nav-item.html # Main navigation item │ ├─ nav-item.html # Main navigation item
│ ├─ page.html # Page
│ ├─ page-footer.html # Page footer
│ ├─ page-header.html # Page header
│ ├─ palette.html # Color palette │ ├─ palette.html # Color palette
│ ├─ search.html # Search interface │ ├─ search.html # Search interface
│ ├─ social.html # Social links │ ├─ social.html # Social links

View File

@ -17,13 +17,13 @@ can be integrate with the same principles
In order to integrate a third-party comment provider offering a JavaScript-based In order to integrate a third-party comment provider offering a JavaScript-based
solution, follow the guide on [theme extension], copy the contents from the solution, follow the guide on [theme extension], copy the contents from the
[`page-footer.html`][page-footer partial] partial and create a file [`content.html`][content partial] partial and create a file at the same location
at the same location in the `overrides` folder: in the `overrides` folder:
=== ":octicons-file-code-16: overrides/partials/page-footer.html" === ":octicons-file-code-16: overrides/partials/content.html"
``` html ``` html
<!-- Add copied contents from original page-footer.html here --> <!-- Add copied contents from original content.html here -->
<!-- Get setting from mkdocs.yml, but allow page-level overrides --> <!-- Get setting from mkdocs.yml, but allow page-level overrides -->
{% set disqus = config.extra.disqus %} {% set disqus = config.extra.disqus %}
@ -75,7 +75,7 @@ at the same location in the `overrides` folder:
1. Add your Disqus [shortname] here. 1. Add your Disqus [shortname] here.
[theme extension]: ../customization.md#extending-the-theme [theme extension]: ../customization.md#extending-the-theme
[page-footer partial]: https://github.com/squidfunk/mkdocs-material/blob/master/src/partials/page-footer.html [content partial]: https://github.com/squidfunk/mkdocs-material/blob/master/src/partials/content.html
[shortname]: https://help.disqus.com/en/articles/1717111-what-s-a-shortname [shortname]: https://help.disqus.com/en/articles/1717111-what-s-a-shortname
#### on a single page #### on a single page

View File

@ -399,9 +399,9 @@ The following configuration options are supported:
`linenums_style`{ #highlight-linenums-style } `linenums_style`{ #highlight-linenums-style }
: :octicons-milestone-24: Default: `table` The [Highlight] extension : :octicons-milestone-24: Default: `table` The [Highlight] extension
provides three ways to add line numbers, all of which are supported by provides three ways to add line numbers, two of which are supported by
Material for MkDocs. While `table` wraps a code block in a table, `inline` Material for MkDocs. While `table` wraps a code block in a `<table>`
and `pymdownx-inline` render line numbers as part of the line itself: element, `pymdownx-inline` renders line numbers as part of the line itself:
``` yaml ``` yaml
markdown_extensions: markdown_extensions: