From 365d06c5389b669dd6b006c9b854b1f5720c5455 Mon Sep 17 00:00:00 2001 From: Matt Davis Date: Fri, 2 Jun 2017 11:11:28 -0700 Subject: [PATCH] add Makefile target for single HTML page (#25313) --- docs/docsite/Makefile | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/docs/docsite/Makefile b/docs/docsite/Makefile index 31e5895b10d..321aed07b00 100644 --- a/docs/docsite/Makefile +++ b/docs/docsite/Makefile @@ -8,6 +8,11 @@ else CPUS ?= $(shell nproc) endif +assertrst: +ifndef rst + $(error specify document or pattern with rst=somefile.rst) +endif + all: docs docs: clean htmldocs @@ -50,4 +55,8 @@ staticmin: cat _themes/srtd/static/css/theme.css | sed -e 's/^[ ]*//g; s/[ ]*$$//g; s/\([:{;,]\) /\1/g; s/ {/{/g; s/\/\*.*\*\///g; /^$$/d' | sed -e :a -e '$$!N; s/\n\(.\)/\1/; ta' > _themes/srtd/static/css/theme.min.css epub: - (CPUS=$(CPUS) make -f Makefile.sphinx epub) + (CPUS=$(CPUS) make -f Makefile.sphinx epub) + +htmlsingle: assertrst + sphinx-build -j $(CPUS) -b html -d _build/doctrees ./rst _build/html rst/$(rst) + @echo "Output is in _build/html/$(rst)"