mkdocs-spellcheck 1.2.0__tar.gz → 1.2.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (55) hide show
  1. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/CHANGELOG.md +8 -0
  2. mkdocs_spellcheck-1.2.1/PKG-INFO +197 -0
  3. mkdocs_spellcheck-1.2.1/README.md +156 -0
  4. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/docs/known_words.txt +2 -0
  5. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/pyproject.toml +1 -1
  6. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/scripts/gen_credits.py +1 -1
  7. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/src/mkdocs_spellcheck/_internal/words.py +8 -0
  8. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/tests/test_api.py +2 -2
  9. mkdocs_spellcheck-1.2.0/PKG-INFO +0 -145
  10. mkdocs_spellcheck-1.2.0/README.md +0 -104
  11. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/CODE_OF_CONDUCT.md +0 -0
  12. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/CONTRIBUTING.md +0 -0
  13. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/LICENSE +0 -0
  14. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/config/coverage.ini +0 -0
  15. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/config/git-changelog.toml +0 -0
  16. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/config/mypy.ini +0 -0
  17. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/config/pytest.ini +0 -0
  18. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/config/ruff.toml +0 -0
  19. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/config/vscode/launch.json +0 -0
  20. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/config/vscode/settings.json +0 -0
  21. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/config/vscode/tasks.json +0 -0
  22. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/docs/.overrides/partials/comments.html +0 -0
  23. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/docs/.overrides/partials/path-item.html +0 -0
  24. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/docs/changelog.md +0 -0
  25. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/docs/code_of_conduct.md +0 -0
  26. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/docs/contributing.md +0 -0
  27. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/docs/credits.md +0 -0
  28. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/docs/css/material.css +0 -0
  29. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/docs/css/mkdocstrings.css +0 -0
  30. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/docs/index.md +0 -0
  31. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/docs/js/feedback.js +0 -0
  32. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/docs/license.md +0 -0
  33. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/docs/reference/api.md +0 -0
  34. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/docs/schema.json +0 -0
  35. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/duties.py +0 -0
  36. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/mkdocs.yml +0 -0
  37. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/scripts/get_version.py +0 -0
  38. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/scripts/make +0 -0
  39. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/scripts/make.py +0 -0
  40. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/src/mkdocs_spellcheck/__init__.py +0 -0
  41. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/src/mkdocs_spellcheck/_internal/__init__.py +0 -0
  42. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/src/mkdocs_spellcheck/_internal/backends/__init__.py +0 -0
  43. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/src/mkdocs_spellcheck/_internal/backends/codespell.py +0 -0
  44. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/src/mkdocs_spellcheck/_internal/backends/symspellpy.py +0 -0
  45. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/src/mkdocs_spellcheck/_internal/debug.py +0 -0
  46. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/src/mkdocs_spellcheck/_internal/plugin.py +0 -0
  47. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/src/mkdocs_spellcheck/backends/__init__.py +0 -0
  48. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/src/mkdocs_spellcheck/backends/codespell.py +0 -0
  49. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/src/mkdocs_spellcheck/backends/symspellpy.py +0 -0
  50. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/src/mkdocs_spellcheck/plugin.py +0 -0
  51. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/src/mkdocs_spellcheck/py.typed +0 -0
  52. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/src/mkdocs_spellcheck/words.py +0 -0
  53. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/tests/__init__.py +0 -0
  54. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/tests/conftest.py +0 -0
  55. {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/tests/test_words.py +0 -0
@@ -5,6 +5,14 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
5
5
  and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
6
6
 
7
7
  <!-- insertion marker -->
8
+ ## [1.2.1](https://github.com/pawamoy/mkdocs-spellcheck/releases/tag/1.2.1) - 2026-02-11
9
+
10
+ <small>[Compare with 1.2.0](https://github.com/pawamoy/mkdocs-spellcheck/compare/1.2.0...1.2.1)</small>
11
+
12
+ ### Bug Fixes
13
+
14
+ - Ignore contents of `<script>` tags ([80c72bc](https://github.com/pawamoy/mkdocs-spellcheck/commit/80c72bc8af46fd114cea75ba2628df2d46495d98) by Tino Wagner). [PR-40](https://github.com/pawamoy/mkdocs-spellcheck/pull/40)
15
+
8
16
  ## [1.2.0](https://github.com/pawamoy/mkdocs-spellcheck/releases/tag/1.2.0) - 2025-12-01
9
17
 
10
18
  <small>[Compare with 1.1.2](https://github.com/pawamoy/mkdocs-spellcheck/compare/1.1.2...1.2.0)</small>
@@ -0,0 +1,197 @@
1
+ Metadata-Version: 2.4
2
+ Name: mkdocs-spellcheck
3
+ Version: 1.2.1
4
+ Summary: A spell checker plugin for MkDocs.
5
+ Author-Email: =?utf-8?q?Timoth=C3=A9e_Mazzucotelli?= <dev@pawamoy.fr>
6
+ License-Expression: ISC
7
+ License-File: LICENSE
8
+ Classifier: Development Status :: 4 - Beta
9
+ Classifier: Intended Audience :: Developers
10
+ Classifier: Programming Language :: Python
11
+ Classifier: Programming Language :: Python :: 3
12
+ Classifier: Programming Language :: Python :: 3 :: Only
13
+ Classifier: Programming Language :: Python :: 3.10
14
+ Classifier: Programming Language :: Python :: 3.11
15
+ Classifier: Programming Language :: Python :: 3.12
16
+ Classifier: Programming Language :: Python :: 3.13
17
+ Classifier: Programming Language :: Python :: 3.14
18
+ Classifier: Topic :: Documentation
19
+ Classifier: Topic :: Software Development
20
+ Classifier: Topic :: Software Development :: Documentation
21
+ Classifier: Topic :: Utilities
22
+ Classifier: Typing :: Typed
23
+ Project-URL: Homepage, https://pawamoy.github.io/mkdocs-spellcheck
24
+ Project-URL: Documentation, https://pawamoy.github.io/mkdocs-spellcheck
25
+ Project-URL: Changelog, https://pawamoy.github.io/mkdocs-spellcheck/changelog
26
+ Project-URL: Repository, https://github.com/pawamoy/mkdocs-spellcheck
27
+ Project-URL: Issues, https://github.com/pawamoy/mkdocs-spellcheck/issues
28
+ Project-URL: Discussions, https://github.com/pawamoy/mkdocs-spellcheck/discussions
29
+ Project-URL: Gitter, https://gitter.im/mkdocs-spellcheck/community
30
+ Project-URL: Funding, https://github.com/sponsors/pawamoy
31
+ Requires-Python: >=3.10
32
+ Requires-Dist: mkdocs>=1.5
33
+ Provides-Extra: all
34
+ Requires-Dist: mkdocs-spellcheck[codespell,symspellpy]; extra == "all"
35
+ Provides-Extra: codespell
36
+ Requires-Dist: codespell>=2.2.2; extra == "codespell"
37
+ Provides-Extra: symspellpy
38
+ Requires-Dist: symspellpy>=6.7.6; extra == "symspellpy"
39
+ Requires-Dist: importlib-resources>=6.4; python_version < "3.9" and extra == "symspellpy"
40
+ Description-Content-Type: text/markdown
41
+
42
+ # MkDocs SpellCheck
43
+
44
+ > [!WARNING]
45
+ > This project is in maintenance mode. I'm now dedicating my time to [Zensical](https://zensical.org/). Feel free to reach out for a responsible transfer of maintainership.
46
+
47
+ [![ci](https://github.com/pawamoy/mkdocs-spellcheck/workflows/ci/badge.svg)](https://github.com/pawamoy/mkdocs-spellcheck/actions?query=workflow%3Aci)
48
+ [![documentation](https://img.shields.io/badge/docs-mkdocs-708FCC.svg?style=flat)](https://pawamoy.github.io/mkdocs-spellcheck/)
49
+ [![pypi version](https://img.shields.io/pypi/v/mkdocs-spellcheck.svg)](https://pypi.org/project/mkdocs-spellcheck/)
50
+ [![gitter](https://img.shields.io/badge/matrix-chat-4DB798.svg?style=flat)](https://app.gitter.im/#/room/#mkdocs-spellcheck:gitter.im)
51
+
52
+ A spell checker plugin for MkDocs.
53
+
54
+ This plugin can use different backends
55
+ to check the spelling of words in your final HTML pages.
56
+ These backends are:
57
+
58
+ - [`codespell`](https://github.com/codespell-project/codespell)
59
+ - [`symspellpy`](https://github.com/mammothb/symspellpy)
60
+
61
+ ## Installation
62
+
63
+ To install all backends, use the `all` extra. Otherwise specify the name(s) of the backend(s) as extra.
64
+
65
+ ```bash
66
+ pip install 'mkdocs-spellcheck[all]'
67
+ pip install 'mkdocs-spellcheck[codespell]'
68
+ pip install 'mkdocs-spellcheck[symspellpy]'
69
+ pip install 'mkdocs-spellcheck[codespell,symspellpy]'
70
+ ```
71
+
72
+ ## Usage
73
+
74
+ ```yaml
75
+ # mkdocs.yml
76
+ plugins:
77
+ - search
78
+ - spellcheck:
79
+ backends: # the backends you want to use
80
+ - symspellpy # as strings
81
+ - codespell: # or nested configs
82
+ dictionaries: [clear, rare]
83
+
84
+ # known_words can also be a list of words
85
+ known_words: known_words.txt
86
+
87
+ # ignore words in <code> tags
88
+ ignore_code: yes
89
+
90
+ # minimum length of words to consider
91
+ min_length: 2
92
+
93
+ # maximum number of capital letters in a word
94
+ max_capital: 1
95
+
96
+ # keep unicode characters
97
+ allow_unicode: no
98
+
99
+ # skip files entirely (supports Unix shell-style wildcards)
100
+ skip_files:
101
+ - credits.md
102
+ - coverage.md
103
+ - reference/*
104
+
105
+ # whether to only check in strict mode
106
+ strict_only: yes
107
+ ```
108
+
109
+ By default, the `symspellpy` backend is used.
110
+
111
+ Once your configuration is ready, just run `mkdocs build -s` to check the spelling inside your pages.
112
+
113
+ ### `codespell`
114
+
115
+ The builtin dictionaries are:
116
+
117
+ - `clear` for unambiguous errors
118
+ - `rare` for rare (but valid) words that are likely to be errors
119
+ - `informal` for making informal words more formal
120
+ - `usage` for replacing phrasing with recommended terms
121
+ - `code` for words from code and/or mathematics that are likely
122
+ to be typos in other contexts (such as `uint`)
123
+ - `names` for valid proper names that might be typos
124
+ - `en-GB_to_en-US` for corrections from `en-GB` to `en-US`
125
+
126
+ ### On-off regions
127
+
128
+ In some situations it can be useful to temporarily disable spell checking for a document.
129
+ To this end, MkDocs SpellCheck recognizes special guards `mkdocs-spellcheck-{on,off}`:
130
+
131
+ ```md
132
+ Here MkDocs SpellCheck checks for correct spelling.
133
+
134
+ <!-- mkdocs-spellcheck-off -->
135
+ In this block it doesn't.
136
+ <!-- mkdocs-spellcheck-on -->
137
+
138
+ Here spelling checks are performed again.
139
+ ```
140
+
141
+ ## Sponsors
142
+
143
+ <!-- sponsors-start -->
144
+
145
+ <div id="premium-sponsors" style="text-align: center;">
146
+
147
+ <div id="silver-sponsors"><b>Silver sponsors</b><p>
148
+ <a href="https://fastapi.tiangolo.com/"><img alt="FastAPI" src="https://raw.githubusercontent.com/tiangolo/fastapi/master/docs/en/docs/img/logo-margin/logo-teal.png" style="height: 200px; "></a><br>
149
+ </p></div>
150
+
151
+ <div id="bronze-sponsors"><b>Bronze sponsors</b><p>
152
+ <a href="https://www.nixtla.io/"><picture><source media="(prefers-color-scheme: light)" srcset="https://www.nixtla.io/img/logo/full-black.svg"><source media="(prefers-color-scheme: dark)" srcset="https://www.nixtla.io/img/logo/full-white.svg"><img alt="Nixtla" src="https://www.nixtla.io/img/logo/full-black.svg" style="height: 60px; "></picture></a><br>
153
+ </p></div>
154
+ </div>
155
+
156
+ ---
157
+
158
+ <div id="sponsors"><p>
159
+ <a href="https://github.com/ofek"><img alt="ofek" src="https://avatars.githubusercontent.com/u/9677399?u=386c330f212ce467ce7119d9615c75d0e9b9f1ce&v=4" style="height: 32px; border-radius: 100%;"></a>
160
+ <a href="https://github.com/samuelcolvin"><img alt="samuelcolvin" src="https://avatars.githubusercontent.com/u/4039449?u=42eb3b833047c8c4b4f647a031eaef148c16d93f&v=4" style="height: 32px; border-radius: 100%;"></a>
161
+ <a href="https://github.com/tlambert03"><img alt="tlambert03" src="https://avatars.githubusercontent.com/u/1609449?u=922abf0524b47739b37095e553c99488814b05db&v=4" style="height: 32px; border-radius: 100%;"></a>
162
+ <a href="https://github.com/ssbarnea"><img alt="ssbarnea" src="https://avatars.githubusercontent.com/u/102495?u=c7bd9ddf127785286fc939dd18cb02db0a453bce&v=4" style="height: 32px; border-radius: 100%;"></a>
163
+ <a href="https://github.com/femtomc"><img alt="femtomc" src="https://avatars.githubusercontent.com/u/34410036?u=f13a71daf2a9f0d2da189beaa94250daa629e2d8&v=4" style="height: 32px; border-radius: 100%;"></a>
164
+ <a href="https://github.com/cmarqu"><img alt="cmarqu" src="https://avatars.githubusercontent.com/u/360986?v=4" style="height: 32px; border-radius: 100%;"></a>
165
+ <a href="https://github.com/kolenaIO"><img alt="kolenaIO" src="https://avatars.githubusercontent.com/u/77010818?v=4" style="height: 32px; border-radius: 100%;"></a>
166
+ <a href="https://github.com/ramnes"><img alt="ramnes" src="https://avatars.githubusercontent.com/u/835072?u=3fca03c3ba0051e2eb652b1def2188a94d1e1dc2&v=4" style="height: 32px; border-radius: 100%;"></a>
167
+ <a href="https://github.com/machow"><img alt="machow" src="https://avatars.githubusercontent.com/u/2574498?u=c41e3d2f758a05102d8075e38d67b9c17d4189d7&v=4" style="height: 32px; border-radius: 100%;"></a>
168
+ <a href="https://github.com/BenHammersley"><img alt="BenHammersley" src="https://avatars.githubusercontent.com/u/99436?u=4499a7b507541045222ee28ae122dbe3c8d08ab5&v=4" style="height: 32px; border-radius: 100%;"></a>
169
+ <a href="https://github.com/trevorWieland"><img alt="trevorWieland" src="https://avatars.githubusercontent.com/u/28811461?u=74cc0e3756c1d4e3d66b5c396e1d131ea8a10472&v=4" style="height: 32px; border-radius: 100%;"></a>
170
+ <a href="https://github.com/MarcoGorelli"><img alt="MarcoGorelli" src="https://avatars.githubusercontent.com/u/33491632?u=7de3a749cac76a60baca9777baf71d043a4f884d&v=4" style="height: 32px; border-radius: 100%;"></a>
171
+ <a href="https://github.com/analog-cbarber"><img alt="analog-cbarber" src="https://avatars.githubusercontent.com/u/7408243?u=642fc2bdcc9904089c62fe5aec4e03ace32da67d&v=4" style="height: 32px; border-radius: 100%;"></a>
172
+ <a href="https://github.com/OdinManiac"><img alt="OdinManiac" src="https://avatars.githubusercontent.com/u/22727172?u=36ab20970f7f52ae8e7eb67b7fcf491fee01ac22&v=4" style="height: 32px; border-radius: 100%;"></a>
173
+ <a href="https://github.com/rstudio-sponsorship"><img alt="rstudio-sponsorship" src="https://avatars.githubusercontent.com/u/58949051?u=0c471515dd18111be30dfb7669ed5e778970959b&v=4" style="height: 32px; border-radius: 100%;"></a>
174
+ <a href="https://github.com/schlich"><img alt="schlich" src="https://avatars.githubusercontent.com/u/21191435?u=6f1240adb68f21614d809ae52d66509f46b1e877&v=4" style="height: 32px; border-radius: 100%;"></a>
175
+ <a href="https://github.com/butterlyn"><img alt="butterlyn" src="https://avatars.githubusercontent.com/u/53323535?v=4" style="height: 32px; border-radius: 100%;"></a>
176
+ <a href="https://github.com/livingbio"><img alt="livingbio" src="https://avatars.githubusercontent.com/u/10329983?v=4" style="height: 32px; border-radius: 100%;"></a>
177
+ <a href="https://github.com/NemetschekAllplan"><img alt="NemetschekAllplan" src="https://avatars.githubusercontent.com/u/912034?v=4" style="height: 32px; border-radius: 100%;"></a>
178
+ <a href="https://github.com/EricJayHartman"><img alt="EricJayHartman" src="https://avatars.githubusercontent.com/u/9259499?u=7e58cc7ec0cd3e85b27aec33656aa0f6612706dd&v=4" style="height: 32px; border-radius: 100%;"></a>
179
+ <a href="https://github.com/15r10nk"><img alt="15r10nk" src="https://avatars.githubusercontent.com/u/44680962?u=f04826446ff165742efa81e314bd03bf1724d50e&v=4" style="height: 32px; border-radius: 100%;"></a>
180
+ <a href="https://github.com/activeloopai"><img alt="activeloopai" src="https://avatars.githubusercontent.com/u/34816118?v=4" style="height: 32px; border-radius: 100%;"></a>
181
+ <a href="https://github.com/roboflow"><img alt="roboflow" src="https://avatars.githubusercontent.com/u/53104118?v=4" style="height: 32px; border-radius: 100%;"></a>
182
+ <a href="https://github.com/cmclaughlin"><img alt="cmclaughlin" src="https://avatars.githubusercontent.com/u/1061109?u=ddf6eec0edd2d11c980f8c3aa96e3d044d4e0468&v=4" style="height: 32px; border-radius: 100%;"></a>
183
+ <a href="https://github.com/blaisep"><img alt="blaisep" src="https://avatars.githubusercontent.com/u/254456?u=97d584b7c0a6faf583aa59975df4f993f671d121&v=4" style="height: 32px; border-radius: 100%;"></a>
184
+ <a href="https://github.com/RapidataAI"><img alt="RapidataAI" src="https://avatars.githubusercontent.com/u/104209891?v=4" style="height: 32px; border-radius: 100%;"></a>
185
+ <a href="https://github.com/rodolphebarbanneau"><img alt="rodolphebarbanneau" src="https://avatars.githubusercontent.com/u/46493454?u=6c405452a40c231cdf0b68e97544e07ee956a733&v=4" style="height: 32px; border-radius: 100%;"></a>
186
+ <a href="https://github.com/theSymbolSyndicate"><img alt="theSymbolSyndicate" src="https://avatars.githubusercontent.com/u/111542255?v=4" style="height: 32px; border-radius: 100%;"></a>
187
+ <a href="https://github.com/blakeNaccarato"><img alt="blakeNaccarato" src="https://avatars.githubusercontent.com/u/20692450?u=bb919218be30cfa994514f4cf39bb2f7cf952df4&v=4" style="height: 32px; border-radius: 100%;"></a>
188
+ <a href="https://github.com/ChargeStorm"><img alt="ChargeStorm" src="https://avatars.githubusercontent.com/u/26000165?v=4" style="height: 32px; border-radius: 100%;"></a>
189
+ <a href="https://github.com/Alphadelta14"><img alt="Alphadelta14" src="https://avatars.githubusercontent.com/u/480845?v=4" style="height: 32px; border-radius: 100%;"></a>
190
+ <a href="https://github.com/Cusp-AI"><img alt="Cusp-AI" src="https://avatars.githubusercontent.com/u/178170649?v=4" style="height: 32px; border-radius: 100%;"></a>
191
+ </p></div>
192
+
193
+
194
+ *And 7 more private sponsor(s).*
195
+
196
+ <!-- sponsors-end -->
197
+
@@ -0,0 +1,156 @@
1
+ # MkDocs SpellCheck
2
+
3
+ > [!WARNING]
4
+ > This project is in maintenance mode. I'm now dedicating my time to [Zensical](https://zensical.org/). Feel free to reach out for a responsible transfer of maintainership.
5
+
6
+ [![ci](https://github.com/pawamoy/mkdocs-spellcheck/workflows/ci/badge.svg)](https://github.com/pawamoy/mkdocs-spellcheck/actions?query=workflow%3Aci)
7
+ [![documentation](https://img.shields.io/badge/docs-mkdocs-708FCC.svg?style=flat)](https://pawamoy.github.io/mkdocs-spellcheck/)
8
+ [![pypi version](https://img.shields.io/pypi/v/mkdocs-spellcheck.svg)](https://pypi.org/project/mkdocs-spellcheck/)
9
+ [![gitter](https://img.shields.io/badge/matrix-chat-4DB798.svg?style=flat)](https://app.gitter.im/#/room/#mkdocs-spellcheck:gitter.im)
10
+
11
+ A spell checker plugin for MkDocs.
12
+
13
+ This plugin can use different backends
14
+ to check the spelling of words in your final HTML pages.
15
+ These backends are:
16
+
17
+ - [`codespell`](https://github.com/codespell-project/codespell)
18
+ - [`symspellpy`](https://github.com/mammothb/symspellpy)
19
+
20
+ ## Installation
21
+
22
+ To install all backends, use the `all` extra. Otherwise specify the name(s) of the backend(s) as extra.
23
+
24
+ ```bash
25
+ pip install 'mkdocs-spellcheck[all]'
26
+ pip install 'mkdocs-spellcheck[codespell]'
27
+ pip install 'mkdocs-spellcheck[symspellpy]'
28
+ pip install 'mkdocs-spellcheck[codespell,symspellpy]'
29
+ ```
30
+
31
+ ## Usage
32
+
33
+ ```yaml
34
+ # mkdocs.yml
35
+ plugins:
36
+ - search
37
+ - spellcheck:
38
+ backends: # the backends you want to use
39
+ - symspellpy # as strings
40
+ - codespell: # or nested configs
41
+ dictionaries: [clear, rare]
42
+
43
+ # known_words can also be a list of words
44
+ known_words: known_words.txt
45
+
46
+ # ignore words in <code> tags
47
+ ignore_code: yes
48
+
49
+ # minimum length of words to consider
50
+ min_length: 2
51
+
52
+ # maximum number of capital letters in a word
53
+ max_capital: 1
54
+
55
+ # keep unicode characters
56
+ allow_unicode: no
57
+
58
+ # skip files entirely (supports Unix shell-style wildcards)
59
+ skip_files:
60
+ - credits.md
61
+ - coverage.md
62
+ - reference/*
63
+
64
+ # whether to only check in strict mode
65
+ strict_only: yes
66
+ ```
67
+
68
+ By default, the `symspellpy` backend is used.
69
+
70
+ Once your configuration is ready, just run `mkdocs build -s` to check the spelling inside your pages.
71
+
72
+ ### `codespell`
73
+
74
+ The builtin dictionaries are:
75
+
76
+ - `clear` for unambiguous errors
77
+ - `rare` for rare (but valid) words that are likely to be errors
78
+ - `informal` for making informal words more formal
79
+ - `usage` for replacing phrasing with recommended terms
80
+ - `code` for words from code and/or mathematics that are likely
81
+ to be typos in other contexts (such as `uint`)
82
+ - `names` for valid proper names that might be typos
83
+ - `en-GB_to_en-US` for corrections from `en-GB` to `en-US`
84
+
85
+ ### On-off regions
86
+
87
+ In some situations it can be useful to temporarily disable spell checking for a document.
88
+ To this end, MkDocs SpellCheck recognizes special guards `mkdocs-spellcheck-{on,off}`:
89
+
90
+ ```md
91
+ Here MkDocs SpellCheck checks for correct spelling.
92
+
93
+ <!-- mkdocs-spellcheck-off -->
94
+ In this block it doesn't.
95
+ <!-- mkdocs-spellcheck-on -->
96
+
97
+ Here spelling checks are performed again.
98
+ ```
99
+
100
+ ## Sponsors
101
+
102
+ <!-- sponsors-start -->
103
+
104
+ <div id="premium-sponsors" style="text-align: center;">
105
+
106
+ <div id="silver-sponsors"><b>Silver sponsors</b><p>
107
+ <a href="https://fastapi.tiangolo.com/"><img alt="FastAPI" src="https://raw.githubusercontent.com/tiangolo/fastapi/master/docs/en/docs/img/logo-margin/logo-teal.png" style="height: 200px; "></a><br>
108
+ </p></div>
109
+
110
+ <div id="bronze-sponsors"><b>Bronze sponsors</b><p>
111
+ <a href="https://www.nixtla.io/"><picture><source media="(prefers-color-scheme: light)" srcset="https://www.nixtla.io/img/logo/full-black.svg"><source media="(prefers-color-scheme: dark)" srcset="https://www.nixtla.io/img/logo/full-white.svg"><img alt="Nixtla" src="https://www.nixtla.io/img/logo/full-black.svg" style="height: 60px; "></picture></a><br>
112
+ </p></div>
113
+ </div>
114
+
115
+ ---
116
+
117
+ <div id="sponsors"><p>
118
+ <a href="https://github.com/ofek"><img alt="ofek" src="https://avatars.githubusercontent.com/u/9677399?u=386c330f212ce467ce7119d9615c75d0e9b9f1ce&v=4" style="height: 32px; border-radius: 100%;"></a>
119
+ <a href="https://github.com/samuelcolvin"><img alt="samuelcolvin" src="https://avatars.githubusercontent.com/u/4039449?u=42eb3b833047c8c4b4f647a031eaef148c16d93f&v=4" style="height: 32px; border-radius: 100%;"></a>
120
+ <a href="https://github.com/tlambert03"><img alt="tlambert03" src="https://avatars.githubusercontent.com/u/1609449?u=922abf0524b47739b37095e553c99488814b05db&v=4" style="height: 32px; border-radius: 100%;"></a>
121
+ <a href="https://github.com/ssbarnea"><img alt="ssbarnea" src="https://avatars.githubusercontent.com/u/102495?u=c7bd9ddf127785286fc939dd18cb02db0a453bce&v=4" style="height: 32px; border-radius: 100%;"></a>
122
+ <a href="https://github.com/femtomc"><img alt="femtomc" src="https://avatars.githubusercontent.com/u/34410036?u=f13a71daf2a9f0d2da189beaa94250daa629e2d8&v=4" style="height: 32px; border-radius: 100%;"></a>
123
+ <a href="https://github.com/cmarqu"><img alt="cmarqu" src="https://avatars.githubusercontent.com/u/360986?v=4" style="height: 32px; border-radius: 100%;"></a>
124
+ <a href="https://github.com/kolenaIO"><img alt="kolenaIO" src="https://avatars.githubusercontent.com/u/77010818?v=4" style="height: 32px; border-radius: 100%;"></a>
125
+ <a href="https://github.com/ramnes"><img alt="ramnes" src="https://avatars.githubusercontent.com/u/835072?u=3fca03c3ba0051e2eb652b1def2188a94d1e1dc2&v=4" style="height: 32px; border-radius: 100%;"></a>
126
+ <a href="https://github.com/machow"><img alt="machow" src="https://avatars.githubusercontent.com/u/2574498?u=c41e3d2f758a05102d8075e38d67b9c17d4189d7&v=4" style="height: 32px; border-radius: 100%;"></a>
127
+ <a href="https://github.com/BenHammersley"><img alt="BenHammersley" src="https://avatars.githubusercontent.com/u/99436?u=4499a7b507541045222ee28ae122dbe3c8d08ab5&v=4" style="height: 32px; border-radius: 100%;"></a>
128
+ <a href="https://github.com/trevorWieland"><img alt="trevorWieland" src="https://avatars.githubusercontent.com/u/28811461?u=74cc0e3756c1d4e3d66b5c396e1d131ea8a10472&v=4" style="height: 32px; border-radius: 100%;"></a>
129
+ <a href="https://github.com/MarcoGorelli"><img alt="MarcoGorelli" src="https://avatars.githubusercontent.com/u/33491632?u=7de3a749cac76a60baca9777baf71d043a4f884d&v=4" style="height: 32px; border-radius: 100%;"></a>
130
+ <a href="https://github.com/analog-cbarber"><img alt="analog-cbarber" src="https://avatars.githubusercontent.com/u/7408243?u=642fc2bdcc9904089c62fe5aec4e03ace32da67d&v=4" style="height: 32px; border-radius: 100%;"></a>
131
+ <a href="https://github.com/OdinManiac"><img alt="OdinManiac" src="https://avatars.githubusercontent.com/u/22727172?u=36ab20970f7f52ae8e7eb67b7fcf491fee01ac22&v=4" style="height: 32px; border-radius: 100%;"></a>
132
+ <a href="https://github.com/rstudio-sponsorship"><img alt="rstudio-sponsorship" src="https://avatars.githubusercontent.com/u/58949051?u=0c471515dd18111be30dfb7669ed5e778970959b&v=4" style="height: 32px; border-radius: 100%;"></a>
133
+ <a href="https://github.com/schlich"><img alt="schlich" src="https://avatars.githubusercontent.com/u/21191435?u=6f1240adb68f21614d809ae52d66509f46b1e877&v=4" style="height: 32px; border-radius: 100%;"></a>
134
+ <a href="https://github.com/butterlyn"><img alt="butterlyn" src="https://avatars.githubusercontent.com/u/53323535?v=4" style="height: 32px; border-radius: 100%;"></a>
135
+ <a href="https://github.com/livingbio"><img alt="livingbio" src="https://avatars.githubusercontent.com/u/10329983?v=4" style="height: 32px; border-radius: 100%;"></a>
136
+ <a href="https://github.com/NemetschekAllplan"><img alt="NemetschekAllplan" src="https://avatars.githubusercontent.com/u/912034?v=4" style="height: 32px; border-radius: 100%;"></a>
137
+ <a href="https://github.com/EricJayHartman"><img alt="EricJayHartman" src="https://avatars.githubusercontent.com/u/9259499?u=7e58cc7ec0cd3e85b27aec33656aa0f6612706dd&v=4" style="height: 32px; border-radius: 100%;"></a>
138
+ <a href="https://github.com/15r10nk"><img alt="15r10nk" src="https://avatars.githubusercontent.com/u/44680962?u=f04826446ff165742efa81e314bd03bf1724d50e&v=4" style="height: 32px; border-radius: 100%;"></a>
139
+ <a href="https://github.com/activeloopai"><img alt="activeloopai" src="https://avatars.githubusercontent.com/u/34816118?v=4" style="height: 32px; border-radius: 100%;"></a>
140
+ <a href="https://github.com/roboflow"><img alt="roboflow" src="https://avatars.githubusercontent.com/u/53104118?v=4" style="height: 32px; border-radius: 100%;"></a>
141
+ <a href="https://github.com/cmclaughlin"><img alt="cmclaughlin" src="https://avatars.githubusercontent.com/u/1061109?u=ddf6eec0edd2d11c980f8c3aa96e3d044d4e0468&v=4" style="height: 32px; border-radius: 100%;"></a>
142
+ <a href="https://github.com/blaisep"><img alt="blaisep" src="https://avatars.githubusercontent.com/u/254456?u=97d584b7c0a6faf583aa59975df4f993f671d121&v=4" style="height: 32px; border-radius: 100%;"></a>
143
+ <a href="https://github.com/RapidataAI"><img alt="RapidataAI" src="https://avatars.githubusercontent.com/u/104209891?v=4" style="height: 32px; border-radius: 100%;"></a>
144
+ <a href="https://github.com/rodolphebarbanneau"><img alt="rodolphebarbanneau" src="https://avatars.githubusercontent.com/u/46493454?u=6c405452a40c231cdf0b68e97544e07ee956a733&v=4" style="height: 32px; border-radius: 100%;"></a>
145
+ <a href="https://github.com/theSymbolSyndicate"><img alt="theSymbolSyndicate" src="https://avatars.githubusercontent.com/u/111542255?v=4" style="height: 32px; border-radius: 100%;"></a>
146
+ <a href="https://github.com/blakeNaccarato"><img alt="blakeNaccarato" src="https://avatars.githubusercontent.com/u/20692450?u=bb919218be30cfa994514f4cf39bb2f7cf952df4&v=4" style="height: 32px; border-radius: 100%;"></a>
147
+ <a href="https://github.com/ChargeStorm"><img alt="ChargeStorm" src="https://avatars.githubusercontent.com/u/26000165?v=4" style="height: 32px; border-radius: 100%;"></a>
148
+ <a href="https://github.com/Alphadelta14"><img alt="Alphadelta14" src="https://avatars.githubusercontent.com/u/480845?v=4" style="height: 32px; border-radius: 100%;"></a>
149
+ <a href="https://github.com/Cusp-AI"><img alt="Cusp-AI" src="https://avatars.githubusercontent.com/u/178170649?v=4" style="height: 32px; border-radius: 100%;"></a>
150
+ </p></div>
151
+
152
+
153
+ *And 7 more private sponsor(s).*
154
+
155
+ <!-- sponsors-end -->
156
+
@@ -36,3 +36,5 @@ symspellpy
36
36
  autolinks
37
37
  deprecations
38
38
  submodules
39
+ maintainership
40
+ zensical
@@ -38,7 +38,7 @@ classifiers = [
38
38
  dependencies = [
39
39
  "mkdocs>=1.5",
40
40
  ]
41
- version = "1.2.0"
41
+ version = "1.2.1"
42
42
 
43
43
  [project.optional-dependencies]
44
44
  all = [
@@ -55,7 +55,7 @@ def _extra_marker(req: Requirement) -> str | None:
55
55
  if not req.marker:
56
56
  return None
57
57
  try:
58
- return next(marker[2].value for marker in req.marker._markers if getattr(marker[0], "value", None) == "extra")
58
+ return next(marker[2].value for marker in req.marker._markers if getattr(marker[0], "value", None) == "extra") # type: ignore[union-attr]
59
59
  except StopIteration:
60
60
  return None
61
61
 
@@ -21,16 +21,21 @@ class _MLStripper(HTMLParser):
21
21
  self.text = StringIO()
22
22
  self.ignore_code = ignore_code
23
23
  self.in_code_tag = False
24
+ self.in_script_tag = False
24
25
  self.in_guard = False
25
26
 
26
27
  def handle_starttag(self, tag: str, attrs: list[tuple[str, str | None]]) -> None: # noqa: ARG002
27
28
  if tag == "code":
28
29
  self.in_code_tag = True
30
+ if tag == "script":
31
+ self.in_script_tag = True
29
32
  self.text.write(" ")
30
33
 
31
34
  def handle_endtag(self, tag: str) -> None:
32
35
  if tag == "code":
33
36
  self.in_code_tag = False
37
+ if tag == "script":
38
+ self.in_script_tag = False
34
39
 
35
40
  def handle_comment(self, data: str) -> None:
36
41
  data = data.strip()
@@ -45,6 +50,9 @@ class _MLStripper(HTMLParser):
45
50
  if self.ignore_code and self.in_code_tag:
46
51
  return
47
52
 
53
+ if self.in_script_tag:
54
+ return
55
+
48
56
  if self.in_guard:
49
57
  return
50
58
 
@@ -50,7 +50,7 @@ def _yield_public_objects(
50
50
  if modules:
51
51
  yield member
52
52
  yield from _yield_public_objects(
53
- member, # type: ignore[arg-type]
53
+ member,
54
54
  modules=modules,
55
55
  modulelevel=modulelevel,
56
56
  inherited=inherited,
@@ -62,7 +62,7 @@ def _yield_public_objects(
62
62
  continue
63
63
  if member.is_class and not modulelevel:
64
64
  yield from _yield_public_objects(
65
- member, # type: ignore[arg-type]
65
+ member,
66
66
  modules=modules,
67
67
  modulelevel=False,
68
68
  inherited=inherited,
@@ -1,145 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: mkdocs-spellcheck
3
- Version: 1.2.0
4
- Summary: A spell checker plugin for MkDocs.
5
- Author-Email: =?utf-8?q?Timoth=C3=A9e_Mazzucotelli?= <dev@pawamoy.fr>
6
- License-Expression: ISC
7
- License-File: LICENSE
8
- Classifier: Development Status :: 4 - Beta
9
- Classifier: Intended Audience :: Developers
10
- Classifier: Programming Language :: Python
11
- Classifier: Programming Language :: Python :: 3
12
- Classifier: Programming Language :: Python :: 3 :: Only
13
- Classifier: Programming Language :: Python :: 3.10
14
- Classifier: Programming Language :: Python :: 3.11
15
- Classifier: Programming Language :: Python :: 3.12
16
- Classifier: Programming Language :: Python :: 3.13
17
- Classifier: Programming Language :: Python :: 3.14
18
- Classifier: Topic :: Documentation
19
- Classifier: Topic :: Software Development
20
- Classifier: Topic :: Software Development :: Documentation
21
- Classifier: Topic :: Utilities
22
- Classifier: Typing :: Typed
23
- Project-URL: Homepage, https://pawamoy.github.io/mkdocs-spellcheck
24
- Project-URL: Documentation, https://pawamoy.github.io/mkdocs-spellcheck
25
- Project-URL: Changelog, https://pawamoy.github.io/mkdocs-spellcheck/changelog
26
- Project-URL: Repository, https://github.com/pawamoy/mkdocs-spellcheck
27
- Project-URL: Issues, https://github.com/pawamoy/mkdocs-spellcheck/issues
28
- Project-URL: Discussions, https://github.com/pawamoy/mkdocs-spellcheck/discussions
29
- Project-URL: Gitter, https://gitter.im/mkdocs-spellcheck/community
30
- Project-URL: Funding, https://github.com/sponsors/pawamoy
31
- Requires-Python: >=3.10
32
- Requires-Dist: mkdocs>=1.5
33
- Provides-Extra: all
34
- Requires-Dist: mkdocs-spellcheck[codespell,symspellpy]; extra == "all"
35
- Provides-Extra: codespell
36
- Requires-Dist: codespell>=2.2.2; extra == "codespell"
37
- Provides-Extra: symspellpy
38
- Requires-Dist: symspellpy>=6.7.6; extra == "symspellpy"
39
- Requires-Dist: importlib-resources>=6.4; python_version < "3.9" and extra == "symspellpy"
40
- Description-Content-Type: text/markdown
41
-
42
- # MkDocs SpellCheck
43
-
44
- > [!WARNING]
45
- > This project is in maintenance mode. I'm now dedicating my time to [Zensical](https://zensical.org/). Feel free to reach out for a responsible transfer of maintainership.
46
-
47
- [![ci](https://github.com/pawamoy/mkdocs-spellcheck/workflows/ci/badge.svg)](https://github.com/pawamoy/mkdocs-spellcheck/actions?query=workflow%3Aci)
48
- [![documentation](https://img.shields.io/badge/docs-mkdocs-708FCC.svg?style=flat)](https://pawamoy.github.io/mkdocs-spellcheck/)
49
- [![pypi version](https://img.shields.io/pypi/v/mkdocs-spellcheck.svg)](https://pypi.org/project/mkdocs-spellcheck/)
50
- [![gitter](https://img.shields.io/badge/matrix-chat-4DB798.svg?style=flat)](https://app.gitter.im/#/room/#mkdocs-spellcheck:gitter.im)
51
-
52
- A spell checker plugin for MkDocs.
53
-
54
- This plugin can use different backends
55
- to check the spelling of words in your final HTML pages.
56
- These backends are:
57
-
58
- - [`codespell`](https://github.com/codespell-project/codespell)
59
- - [`symspellpy`](https://github.com/mammothb/symspellpy)
60
-
61
- ## Installation
62
-
63
- To install all backends, use the `all` extra. Otherwise specify the name(s) of the backend(s) as extra.
64
-
65
- ```bash
66
- pip install 'mkdocs-spellcheck[all]'
67
- pip install 'mkdocs-spellcheck[codespell]'
68
- pip install 'mkdocs-spellcheck[symspellpy]'
69
- pip install 'mkdocs-spellcheck[codespell,symspellpy]'
70
- ```
71
-
72
- ## Usage
73
-
74
- ```yaml
75
- # mkdocs.yml
76
- plugins:
77
- - search
78
- - spellcheck:
79
- backends: # the backends you want to use
80
- - symspellpy # as strings
81
- - codespell: # or nested configs
82
- dictionaries: [clear, rare]
83
-
84
- # known_words can also be a list of words
85
- known_words: known_words.txt
86
-
87
- # ignore words in <code> tags
88
- ignore_code: yes
89
-
90
- # minimum length of words to consider
91
- min_length: 2
92
-
93
- # maximum number of capital letters in a word
94
- max_capital: 1
95
-
96
- # keep unicode characters
97
- allow_unicode: no
98
-
99
- # skip files entirely (supports Unix shell-style wildcards)
100
- skip_files:
101
- - credits.md
102
- - coverage.md
103
- - reference/*
104
-
105
- # whether to only check in strict mode
106
- strict_only: yes
107
- ```
108
-
109
- By default, the `symspellpy` backend is used.
110
-
111
- Once your configuration is ready, just run `mkdocs build -s` to check the spelling inside your pages.
112
-
113
- ### `codespell`
114
-
115
- The builtin dictionaries are:
116
-
117
- - `clear` for unambiguous errors
118
- - `rare` for rare (but valid) words that are likely to be errors
119
- - `informal` for making informal words more formal
120
- - `usage` for replacing phrasing with recommended terms
121
- - `code` for words from code and/or mathematics that are likely
122
- to be typos in other contexts (such as `uint`)
123
- - `names` for valid proper names that might be typos
124
- - `en-GB_to_en-US` for corrections from `en-GB` to `en-US`
125
-
126
- ### On-off regions
127
-
128
- In some situations it can be useful to temporarily disable spell checking for a document.
129
- To this end, MkDocs SpellCheck recognizes special guards `mkdocs-spellcheck-{on,off}`:
130
-
131
- ```md
132
- Here MkDocs SpellCheck checks for correct spelling.
133
-
134
- <!-- mkdocs-spellcheck-off -->
135
- In this block it doesn't.
136
- <!-- mkdocs-spellcheck-on -->
137
-
138
- Here spelling checks are performed again.
139
- ```
140
-
141
- ## Sponsors
142
-
143
- <!-- sponsors-start -->
144
- <!-- sponsors-end -->
145
-
@@ -1,104 +0,0 @@
1
- # MkDocs SpellCheck
2
-
3
- > [!WARNING]
4
- > This project is in maintenance mode. I'm now dedicating my time to [Zensical](https://zensical.org/). Feel free to reach out for a responsible transfer of maintainership.
5
-
6
- [![ci](https://github.com/pawamoy/mkdocs-spellcheck/workflows/ci/badge.svg)](https://github.com/pawamoy/mkdocs-spellcheck/actions?query=workflow%3Aci)
7
- [![documentation](https://img.shields.io/badge/docs-mkdocs-708FCC.svg?style=flat)](https://pawamoy.github.io/mkdocs-spellcheck/)
8
- [![pypi version](https://img.shields.io/pypi/v/mkdocs-spellcheck.svg)](https://pypi.org/project/mkdocs-spellcheck/)
9
- [![gitter](https://img.shields.io/badge/matrix-chat-4DB798.svg?style=flat)](https://app.gitter.im/#/room/#mkdocs-spellcheck:gitter.im)
10
-
11
- A spell checker plugin for MkDocs.
12
-
13
- This plugin can use different backends
14
- to check the spelling of words in your final HTML pages.
15
- These backends are:
16
-
17
- - [`codespell`](https://github.com/codespell-project/codespell)
18
- - [`symspellpy`](https://github.com/mammothb/symspellpy)
19
-
20
- ## Installation
21
-
22
- To install all backends, use the `all` extra. Otherwise specify the name(s) of the backend(s) as extra.
23
-
24
- ```bash
25
- pip install 'mkdocs-spellcheck[all]'
26
- pip install 'mkdocs-spellcheck[codespell]'
27
- pip install 'mkdocs-spellcheck[symspellpy]'
28
- pip install 'mkdocs-spellcheck[codespell,symspellpy]'
29
- ```
30
-
31
- ## Usage
32
-
33
- ```yaml
34
- # mkdocs.yml
35
- plugins:
36
- - search
37
- - spellcheck:
38
- backends: # the backends you want to use
39
- - symspellpy # as strings
40
- - codespell: # or nested configs
41
- dictionaries: [clear, rare]
42
-
43
- # known_words can also be a list of words
44
- known_words: known_words.txt
45
-
46
- # ignore words in <code> tags
47
- ignore_code: yes
48
-
49
- # minimum length of words to consider
50
- min_length: 2
51
-
52
- # maximum number of capital letters in a word
53
- max_capital: 1
54
-
55
- # keep unicode characters
56
- allow_unicode: no
57
-
58
- # skip files entirely (supports Unix shell-style wildcards)
59
- skip_files:
60
- - credits.md
61
- - coverage.md
62
- - reference/*
63
-
64
- # whether to only check in strict mode
65
- strict_only: yes
66
- ```
67
-
68
- By default, the `symspellpy` backend is used.
69
-
70
- Once your configuration is ready, just run `mkdocs build -s` to check the spelling inside your pages.
71
-
72
- ### `codespell`
73
-
74
- The builtin dictionaries are:
75
-
76
- - `clear` for unambiguous errors
77
- - `rare` for rare (but valid) words that are likely to be errors
78
- - `informal` for making informal words more formal
79
- - `usage` for replacing phrasing with recommended terms
80
- - `code` for words from code and/or mathematics that are likely
81
- to be typos in other contexts (such as `uint`)
82
- - `names` for valid proper names that might be typos
83
- - `en-GB_to_en-US` for corrections from `en-GB` to `en-US`
84
-
85
- ### On-off regions
86
-
87
- In some situations it can be useful to temporarily disable spell checking for a document.
88
- To this end, MkDocs SpellCheck recognizes special guards `mkdocs-spellcheck-{on,off}`:
89
-
90
- ```md
91
- Here MkDocs SpellCheck checks for correct spelling.
92
-
93
- <!-- mkdocs-spellcheck-off -->
94
- In this block it doesn't.
95
- <!-- mkdocs-spellcheck-on -->
96
-
97
- Here spelling checks are performed again.
98
- ```
99
-
100
- ## Sponsors
101
-
102
- <!-- sponsors-start -->
103
- <!-- sponsors-end -->
104
-