docs: try autobuild for local dev

Makefile

@@ -1,5 +1,6 @@
-.PHONY: clean test get-sphinx-template docs env data
+.PHONY: clean test get-sphinx-template docs live-docs env data
 
+export TOKENIZERS_PARALLELISM=false
 export FREEZE_REQUIREMENTS=1
 # assume you have installed need packages
 export SPHINX_MOCK_REQUIREMENTS=1
@@ -39,6 +40,10 @@ docs: clean get-sphinx-template
  # apt-get install -y texlive-latex-extra dvipng texlive-pictures texlive-fonts-recommended cm-super
  cd docs && make html --debug --jobs $(nproc) SPHINXOPTS="-W --keep-going"
 
+live-docs: get-sphinx-template
+ pip install -e . --quiet -r requirements/_docs.txt
+ cd docs && make livehtml --jobs $(nproc)
+
 env:
  pip install -e . -U -r requirements/_devel.txt
 

docs/Makefile

@@ -17,3 +17,6 @@ help:
 # "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS).
 %: Makefile
  @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+livehtml:
+ sphinx-autobuild "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

requirements/_docs.txt

@@ -9,6 +9,7 @@ sphinx-autodoc-typehints ==1.23.0
 sphinx-paramlinks ==0.6.0
 sphinx-togglebutton ==0.3.2
 sphinx-copybutton ==0.5.2
+sphinx-autobuild ==2024.10.3
 sphinx-gallery ==0.17.1
 
 lightning >=1.8.0, <2.5.0