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.
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/CHANGELOG.md +8 -0
- mkdocs_spellcheck-1.2.1/PKG-INFO +197 -0
- mkdocs_spellcheck-1.2.1/README.md +156 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/docs/known_words.txt +2 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/pyproject.toml +1 -1
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/scripts/gen_credits.py +1 -1
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/src/mkdocs_spellcheck/_internal/words.py +8 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/tests/test_api.py +2 -2
- mkdocs_spellcheck-1.2.0/PKG-INFO +0 -145
- mkdocs_spellcheck-1.2.0/README.md +0 -104
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/CODE_OF_CONDUCT.md +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/CONTRIBUTING.md +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/LICENSE +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/config/coverage.ini +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/config/git-changelog.toml +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/config/mypy.ini +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/config/pytest.ini +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/config/ruff.toml +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/config/vscode/launch.json +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/config/vscode/settings.json +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/config/vscode/tasks.json +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/docs/.overrides/partials/comments.html +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/docs/.overrides/partials/path-item.html +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/docs/changelog.md +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/docs/code_of_conduct.md +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/docs/contributing.md +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/docs/credits.md +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/docs/css/material.css +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/docs/css/mkdocstrings.css +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/docs/index.md +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/docs/js/feedback.js +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/docs/license.md +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/docs/reference/api.md +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/docs/schema.json +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/duties.py +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/mkdocs.yml +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/scripts/get_version.py +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/scripts/make +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/scripts/make.py +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/src/mkdocs_spellcheck/__init__.py +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/src/mkdocs_spellcheck/_internal/__init__.py +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/src/mkdocs_spellcheck/_internal/backends/__init__.py +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/src/mkdocs_spellcheck/_internal/backends/codespell.py +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/src/mkdocs_spellcheck/_internal/backends/symspellpy.py +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/src/mkdocs_spellcheck/_internal/debug.py +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/src/mkdocs_spellcheck/_internal/plugin.py +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/src/mkdocs_spellcheck/backends/__init__.py +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/src/mkdocs_spellcheck/backends/codespell.py +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/src/mkdocs_spellcheck/backends/symspellpy.py +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/src/mkdocs_spellcheck/plugin.py +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/src/mkdocs_spellcheck/py.typed +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/src/mkdocs_spellcheck/words.py +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/tests/__init__.py +0 -0
- {mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/tests/conftest.py +0 -0
- {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
|
+
[](https://github.com/pawamoy/mkdocs-spellcheck/actions?query=workflow%3Aci)
|
|
48
|
+
[](https://pawamoy.github.io/mkdocs-spellcheck/)
|
|
49
|
+
[](https://pypi.org/project/mkdocs-spellcheck/)
|
|
50
|
+
[](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
|
+
[](https://github.com/pawamoy/mkdocs-spellcheck/actions?query=workflow%3Aci)
|
|
7
|
+
[](https://pawamoy.github.io/mkdocs-spellcheck/)
|
|
8
|
+
[](https://pypi.org/project/mkdocs-spellcheck/)
|
|
9
|
+
[](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
|
+
|
|
@@ -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
|
|
{mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/src/mkdocs_spellcheck/_internal/words.py
RENAMED
|
@@ -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,
|
|
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,
|
|
65
|
+
member,
|
|
66
66
|
modules=modules,
|
|
67
67
|
modulelevel=False,
|
|
68
68
|
inherited=inherited,
|
mkdocs_spellcheck-1.2.0/PKG-INFO
DELETED
|
@@ -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
|
-
[](https://github.com/pawamoy/mkdocs-spellcheck/actions?query=workflow%3Aci)
|
|
48
|
-
[](https://pawamoy.github.io/mkdocs-spellcheck/)
|
|
49
|
-
[](https://pypi.org/project/mkdocs-spellcheck/)
|
|
50
|
-
[](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
|
-
[](https://github.com/pawamoy/mkdocs-spellcheck/actions?query=workflow%3Aci)
|
|
7
|
-
[](https://pawamoy.github.io/mkdocs-spellcheck/)
|
|
8
|
-
[](https://pypi.org/project/mkdocs-spellcheck/)
|
|
9
|
-
[](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
|
-
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
{mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/src/mkdocs_spellcheck/_internal/__init__.py
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
{mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/src/mkdocs_spellcheck/_internal/debug.py
RENAMED
|
File without changes
|
{mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/src/mkdocs_spellcheck/_internal/plugin.py
RENAMED
|
File without changes
|
{mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/src/mkdocs_spellcheck/backends/__init__.py
RENAMED
|
File without changes
|
{mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/src/mkdocs_spellcheck/backends/codespell.py
RENAMED
|
File without changes
|
{mkdocs_spellcheck-1.2.0 → mkdocs_spellcheck-1.2.1}/src/mkdocs_spellcheck/backends/symspellpy.py
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|