diff options
author | Michael Opdenacker <michael.opdenacker@bootlin.com> | 2024-03-30 17:32:47 +0100 |
---|---|---|
committer | Steve Sakoman <steve@sakoman.com> | 2024-04-19 04:50:39 -0700 |
commit | a6fdddf8c44367a5bd82ba9d979e708bd710db79 (patch) | |
tree | 887e4a04e9bc399663e8807961e5e259ba195427 | |
parent | ccbfa27d19f6dbce2c9880f128ed1eac0cf30a5a (diff) | |
download | poky-a6fdddf8c44367a5bd82ba9d979e708bd710db79.tar.gz |
manuals: add initial sphinx-lint support
Makes it possible to catch errors not reported by sphinx,
such as idle spaces. After customization, this should be used
to enforce our syntax conventions, such as two spaces after a "-"
character to introduce a list item.
Just run "make sphinx-lint".
(From yocto-docs rev: a735549a764f7cfebdc7534761b4d75dc523371a)
Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
Signed-off-by: Steve Sakoman <steve@sakoman.com>
-rw-r--r-- | documentation/Makefile | 3 | ||||
-rw-r--r-- | documentation/README | 14 |
2 files changed, 17 insertions, 0 deletions
diff --git a/documentation/Makefile b/documentation/Makefile index 20dab5725c..4e0af4bd30 100644 --- a/documentation/Makefile +++ b/documentation/Makefile | |||
@@ -53,6 +53,9 @@ stylecheck: | |||
53 | vale sync | 53 | vale sync |
54 | vale $(VALEOPTS) $(VALEDOCS) | 54 | vale $(VALEOPTS) $(VALEDOCS) |
55 | 55 | ||
56 | sphinx-lint: | ||
57 | sphinx-lint $(SOURCEDIR) | ||
58 | |||
56 | epub: $(PNGs) | 59 | epub: $(PNGs) |
57 | @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) | 60 | @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) |
58 | 61 | ||
diff --git a/documentation/README b/documentation/README index 8035418cac..b60472fcbf 100644 --- a/documentation/README +++ b/documentation/README | |||
@@ -165,6 +165,20 @@ To run Vale: | |||
165 | 165 | ||
166 | $ make stylecheck | 166 | $ make stylecheck |
167 | 167 | ||
168 | Link checking the Yocto Project documentation | ||
169 | ============================================= | ||
170 | |||
171 | To fix errors which are not reported by Sphinx itself, | ||
172 | the project uses sphinx-lint (https://github.com/sphinx-contrib/sphinx-lint). | ||
173 | |||
174 | To install sphinx-lint: | ||
175 | |||
176 | $ pip install sphinx-lint | ||
177 | |||
178 | To run sphinx-lint: | ||
179 | |||
180 | $ make sphinx-lint | ||
181 | |||
168 | Sphinx theme and CSS customization | 182 | Sphinx theme and CSS customization |
169 | ================================== | 183 | ================================== |
170 | 184 | ||