Try using sphinx-autobuild for live preview

stevepiercy · stevepiercy · commit 2d3a68723f6e · 2022-01-19T22:34:20.000-08:00
diff --git a/Makefile b/Makefile
@@ -190,3 +190,9 @@ deploy: clean html
 
 .PHONY: all
 all: clean spellcheck linkcheck html ## Run checks and build html
+
+.PHONY: livehtml
+livehtml:
+	cd "$(DOCS_DIR)" && sphinx-autobuild \
+		--ignore "*.swp" \
+		-b html . "$(BUILDDIR)/html" $(SPHINXOPTS) $(O)
diff --git a/requirements.txt b/requirements.txt
@@ -3,6 +3,7 @@ jsx-lexer
 lesscpy
 linkify-it-py
 myst-parser
+sphinx-autobuild
 sphinx-book-theme
 sphinx-copybutton
 sphinx-togglebutton
