Removed deprecated Markdown config format in docs

* Remove deprecated Markdown config format in docs.

Support for including Markdown extension configs in the extension name has been [deprecated][1] and will not work in any future released of Python-Markdown. MkDocs has offered full support for defining extension configs [since version 0.13][2] and everyone should be using that format.

[1]: https://pythonhosted.org/Markdown/release-2.6.html#extension-configuration-as-part-of-extension-name-deprecated
[2]: http://www.mkdocs.org/about/release-notes/#other-changes-and-additions-to-version-0130

* Update codehilite Markdown config

* Update TOC Markdown configs

* Update pymdown Markdown configs
This commit is contained in:
Waylan Limberg 2017-10-16 13:13:05 -04:00 committed by Martin Donath
parent 2e728cc9f6
commit b955abab6e
4 changed files with 18 additions and 9 deletions

View File

@ -115,7 +115,8 @@ Line numbers can be added by enabling the `linenums` flag in your `mkdocs.yml`:
``` yaml
markdown_extensions:
- codehilite(linenums=true)
- codehilite:
linenums:true
```
Example:

View File

@ -13,7 +13,8 @@ To enable permalinks, add the following to your `mkdocs.yml`:
``` yaml
markdown_extensions:
- toc(permalink=true)
- toc:
permalink: true
```
This will add a link containing the paragraph symbol `¶` at the end of each
@ -23,7 +24,8 @@ permalink, a string can be passed, e.g.:
``` markdown
markdown_extensions:
- toc(permalink=Link)
- toc:
permalink: Link
```
## Usage

View File

@ -21,7 +21,8 @@ package are recommended to be used together with the Material theme:
``` yaml
markdown_extensions:
- pymdownx.arithmatex
- pymdownx.betterem(smart_enable=all)
- pymdownx.betterem:
smart_enable: all
- pymdownx.caret
- pymdownx.critic
- pymdownx.details
@ -32,7 +33,8 @@ markdown_extensions:
- pymdownx.mark
- pymdownx.smartsymbols
- pymdownx.superfences
- pymdownx.tasklist(custom_checkbox=true)
- pymdownx.tasklist:
custom_checkbox: true
- pymdownx.tilde
```

View File

@ -486,8 +486,10 @@ but highly recommended, so they should be switched on at all times:
``` yaml
markdown_extensions:
- admonition
- codehilite(guess_lang=false)
- toc(permalink=true)
- codehilite:
guess_lang: false
- toc:
permalink: true
```
For more information, see the following list of extensions supported by the
@ -554,6 +556,8 @@ google_analytics:
# Extensions
markdown_extensions:
- admonition
- codehilite(guess_lang=false)
- toc(permalink=true)
- codehilite:
guess_lang: false
- toc:
permalink: true
```