Checks Markdown code blocks in a MkDocs site against user-defined actions
Project description
mkdocs-code-validator
Checks Markdown code blocks in a MkDocs site against user-defined actions
pip install mkdocs-code-validator
Usage
Activate the plugin in mkdocs.yml. The identifiers
config is mandatory. And the plugin doesn't work without pymdownx.superfences:
plugins:
- search
- code-validator:
identifiers:
bash:
validators:
- grep a
markdown_extensions:
- pymdownx.superfences
The above contrived config checks that every ```bash
code block in the Markdown files of this MkDocs site must contain the letter "a", otherwise a warning will appear.
The content of each code block is piped as stdin to the command. The exit code of the command is what's checked: a non-zero code will produce a warning (which in MkDocs you can make fatal with the --strict
flag). The output of the command is not used in any way, only preserved on the screen as part of a warning.
You can add any number of identifiers, and within them any number of validators
commands, each of them has the ability to produce a warning.
If stdin is not usable with your command, the input can be passed as a temporary file instead -- that is done if the command contains the exact argument $<
(which is then replaced with a file path). For the above example, changing the command to grep a $<
would be equivalent (other than technicalities).
The commands do not allow freeform shell syntax, it's just one subprocess to call with its arguments. To explicitly opt into a shell, just run it as (e.g.) sh -c 'if grep a; then exit 1; fi'
. Or, with a temporary file: sh -c 'if grep a "$1"; then exit 1; fi' $<
.
The definition of what a code block is is all according to the pymdownx.superfences extension. It must be enabled; the plugin won't do anything without it.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for mkdocs_code_validator-0.2.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 486fee004da88659bafe0dc2c0439792e067c181f5168d4b4be990261db4a14e |
|
MD5 | f925c98e3f00b0fe06722740d109b93b |
|
BLAKE2b-256 | fdb5dd7a910313fc66b6319f8647d930ff6d53612b87c112f9756e3ecaef556c |
Hashes for mkdocs_code_validator-0.2.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0ef5053c2fa839b22f611b5130868d738804d1b25826d6c21e7f58c9aec18167 |
|
MD5 | 46e362b7f922141f57c954da97c53351 |
|
BLAKE2b-256 | a83fab35145de20859a0332b5c0db8ecbf0f20994d4ae382c1bc356deb635822 |