A mkdocs plugin that lets you exclude selected files or sections from the search index.
Project description
mkdocs-exclude-search
A mkdocs plugin that lets you exclude selected files or sections from the search index.
Setup
Install the plugin using pip:
pip install mkdocs-exclude-search
Activate the search
and exclude-search
plugins in mkdocs.yml
. search
is required, otherwise exclude-search
has no effect!
plugins:
- search
- exclude-search
More information about plugins in the MkDocs documentation.
Configuration
- List the markdown files to be excluded under
exclude
using the format<path>/<to>/filename.md
in the docs folder. - Exclude specific heading subsections using the format
<path>/<to>/filename.md#some-heading
. Chapter names are all lowercase,-
as separator, no spaces. - Exclude all markdown files within a directory (and its children) with
dirname/*
. - Exclude all markdown files with a specific name within all subdirectories with
dirname/*/filename.md
or/*/filename.md
. - To still include a subsection of an excluded file, list the subsection heading under
ignore
using the format<path>/<to>/filename.md#some-heading
. - To exclude all unreferenced files (markdown files not listed in mkdocs.yml nav section), use
exclude-unreferenced: true
. Default false.
plugins:
- search
- exclude-search:
exclude:
- first.md
- dir/second.md
- third.md#some-heading
- dir2/*
- /*/fifth.md
ignore:
- dir/second.md#some-heading
exclude-unreferenced: true
nav:
- Home: index.md
- First chapter: first.md
- Second chapter: dir/second.md
- Third chapter: third.md
- Fourth chapter: dir2/fourth.md
- Fifth chapter: subdir/fifth.md
This example would exclude:
- the first chapter.
- the second chapter (but still include its
some-heading
section). - the
some-heading
section of the third chapter. - all markdown files within
dir2
(and its children directories). - all markdown files named
fifth.md
within all subdirectories. - all unreferenced files
See Also
More information about templates here.
More information about blocks here.
Project details
Release history Release notifications | RSS feed
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
Close
Hashes for mkdocs-exclude-search-0.6.3.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0dd01ad126288166acc8831a8b193766018cd254cb52a3b3eda2d3095f02fa74 |
|
MD5 | a724bfac47567bd0cd865e6942eb2571 |
|
BLAKE2b-256 | 407f9bc818436addba357c905136b24ee840266df77236869c24e5ef0f2e9e77 |
Close
Hashes for mkdocs_exclude_search-0.6.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 048f84c8d90d4503a3f8ec17adea4520f435a83ae8c569d024cee4a1fb1f91c1 |
|
MD5 | c9dcb1916b6127683bb20034f5ec8582 |
|
BLAKE2b-256 | 4b01ef87eaf9e60be4ed773f5656ec2d7c35465ef5b9147d221b2ebdb4638084 |