sphinxcontrib-spelling is a Sphinx package that contains sphinxcontrb.spelling, a spelling checker for Sphinx-based documentation. It uses PyEnchant to produce a report showing misspelled words.
Installation:
1. Follow the instructions on the PyEnchant site to install enchant and then PyEnchant.
2. pip install sphinxcontrib-spelling
Configuration:
1. Add 'sphinxcontrib.spelling' to the extensions list in conf.py.
extensions = [ 'sphinxcontrib.spelling' ]
Configuration Options
spelling_show_suggestions
Boolean controlling whether suggestions for misspelled words are printed. Defaults to False.
spelling_lang
String specifying the language, as understood by PyEnchant and enchant. Defaults to en_US for US English.
spelling_word_list_filename
String specifying a file containing a list of words known to be spelled correctly but that do not appear in the language dictionary selected by spelling_lang. The file should contain one word per line. Refer to the PyEnchant tutoral for details.
Running
To process a document with the spell checker, use sphinx-build and specify spelling as the builder name using the -b option. The output includes the headings from the document and any misspelled words. If suggestions are enabled, they are shown on the same line as the misspelling.
sphinx-build -b spelling source output
virtualenvwrapper
Features
- "Plugin"
Introduction
- "plugins"
Details
Installation
Supported Shells
- "bitbucket"
What is new in this release:
- Warn but otherwise ignore unknown node types.
Requirements:
- Sphinx
- Python
Comments not found