Skip to content

Commit 7f23202

Browse files
committed
Add: Add sphinx- autobuild for rebuilding the docs automatically
cd docs && make livehtml can be used to start a web server that rebuilds the docs automatically if some file has changed.
1 parent 421f019 commit 7f23202

File tree

3 files changed

+63
-2
lines changed

3 files changed

+63
-2
lines changed

docs/Makefile

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,10 @@ BUILDDIR = _build
1212
help:
1313
@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
1414

15-
.PHONY: help Makefile
15+
.PHONY: help livehtml Makefile
16+
17+
livehtml:
18+
sphinx-autobuild "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
1619

1720
# Catch-all target: route all unknown targets to Sphinx using the new
1821
# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS).

poetry.lock

Lines changed: 58 additions & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

pyproject.toml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -54,6 +54,7 @@ coverage = "^7.2"
5454
myst-parser = "^0.19.1"
5555
Sphinx = "^5.3.0"
5656
furo = "^2022.12.7"
57+
sphinx-autobuild = "^2021.3.14"
5758

5859
[tool.black]
5960
line-length = 80

0 commit comments

Comments
 (0)