diff mbox series

[5/8] Makefile: use splithtml tag for html target

Message ID 20261028-tags-v1-5-d5ad01019eae@bootlin.com
State New
Headers show
Series Add support for documentation tags | expand

Commit Message

Antonin Godard Oct. 28, 2026, 8:04 a.m. UTC
Sphinx has the ability to include content based on tags in the
documentation with the '.. only::' directive. As '.. only:: html' is
common to _all_ HTML-based documents (html, singlehtml, epub), there was
no way to differentiate the split HTML build from the others.

For that reason, add the splithtml tag when building it. The goal is be
able to to include content _only_ for this build type.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/Makefile | 4 ++++
 1 file changed, 4 insertions(+)
diff mbox series

Patch

diff --git a/documentation/Makefile b/documentation/Makefile
index f165e36c2..2f2d6213d 100644
--- a/documentation/Makefile
+++ b/documentation/Makefile
@@ -55,6 +55,10 @@  latexpdf:
 
 all: html epub latexpdf
 
+html:
+	$(SOURCEDIR)/set_versions.py
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" --tag splithtml $(SPHINXOPTS)
+
 %:
 	$(SOURCEDIR)/set_versions.py
 	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS)