From bb99c0152c357fd3f03f5ea4383b0c0e0e6b9a6b Mon Sep 17 00:00:00 2001
From: Dima Tisnek <dima.tisnek@canonical.com>
Date: Tue, 20 Aug 2024 15:20:56 +0900
Subject: [PATCH] docs: Live reload with sphinx-autobuild

---
 tox.ini | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/tox.ini b/tox.ini
index 68acc7e2a..251c7a1da 100644
--- a/tox.ini
+++ b/tox.ini
@@ -49,6 +49,16 @@ commands_pre =
 commands =
     sphinx-build -W --keep-going docs/ docs/_build/html
 
+[testenv:docs-live]
+description = Live development: build the Sphinx docs with autoreloading enabled
+deps = {[testenv:docs]deps}
+commands_pre =
+    {[testenv:docs]commands_pre}
+# https://github.com/sphinx-doc/sphinx-autobuild/issues/170
+change_dir = {tox_root}/docs
+commands =
+    sphinx-autobuild ./ ./_build/html --watch . --port 8000
+
 [testenv:fmt]
 description = Apply coding style standards to code
 deps =