From ae1b8c607909d108d994386ad6e78f1f0422e174 Mon Sep 17 00:00:00 2001 From: Michael Opdenacker Date: Sat, 30 Mar 2024 17:32:47 +0100 Subject: 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: 9e1aeeddca06cb7d65631010ba0eebdcd8ecf9ee) Signed-off-by: Michael Opdenacker Signed-off-by: Richard Purdie --- documentation/README | 14 ++++++++++++++ 1 file changed, 14 insertions(+) (limited to 'documentation/README') 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: $ make stylecheck +Link checking the Yocto Project documentation +============================================= + +To fix errors which are not reported by Sphinx itself, +the project uses sphinx-lint (https://github.com/sphinx-contrib/sphinx-lint). + +To install sphinx-lint: + + $ pip install sphinx-lint + +To run sphinx-lint: + + $ make sphinx-lint + Sphinx theme and CSS customization ================================== -- cgit v1.2.3-54-g00ecf