Skip to content

tobiasah/mkdocs-spellcheck

 
 

Repository files navigation

MkDocs SpellCheck

ci documentation pypi version gitpod gitter

A spell checker plugin for MkDocs.

This plugin can use different backends to check the spelling of words in your final HTML pages. These backends are:

Installation

To install all backends, use the all extra. Otherwise specify the name(s) of the backend(s) as extra.

pip install mkdocs-spellcheck[all]
pip install mkdocs-spellcheck[codespell]
pip install mkdocs-spellcheck[symspellpy]
pip install mkdocs-spellcheck[codespell,symspellpy]

Usage

# mkdocs.yml
plugins:
- search
- spellcheck:
    backends:  # the backends you want to use
    - symspellpy  # as strings
    - codespell:  # or nested configs
        dictionaries: [clear, rare]

    # known_words can also be a list of words
    known_words: known_words.txt

    # ignore words in <code> tags
    ignore_code: yes

    # minimum length of words to consider
    min_length: 2

    # maximum number of capital letters in a word
    max_capital: 1

    # keep unicode characters
    allow_unicode: no

    # skip files entirely
    skip_files:
    - credits.md
    - coverage.md

    # whether to only check in strict mode
    strict_only: yes

By default, the symspellpy backend is used.

codespell

The builtin dictionaries are:

  • clear for unambiguous errors
  • rare for rare (but valid) words that are likely to be errors
  • informal for making informal words more formal
  • usage for replacing phrasing with recommended terms
  • code for words from code and/or mathematics that are likely to be typos in other contexts (such as uint)
  • names for valid proper names that might be typos
  • en-GB_to_en-US for corrections from en-GB to en-US

About

A spell checker plugin for MkDocs.

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 95.7%
  • Makefile 2.7%
  • Shell 1.2%
  • Dockerfile 0.4%