summaryrefslogtreecommitdiff
path: root/docs/Makefile
diff options
context:
space:
mode:
authorYuriy Andamasov <yuriy@vyos.io>2026-05-06 23:22:11 +0300
committerYuriy Andamasov <yuriy@vyos.io>2026-05-06 23:22:11 +0300
commitd1e5b5126af907215708fde817dcd309e579b725 (patch)
treee742f915863d78461ca7cc97ee9af355fa745f7e /docs/Makefile
parent4cd5e2cc3bb38b75d4e47aacd6768218daf8762a (diff)
parent7cf51e1c2901f6d1b01e9bff194f7188bc29e417 (diff)
downloadvyos-documentation-d1e5b5126af907215708fde817dcd309e579b725.tar.gz
vyos-documentation-d1e5b5126af907215708fde817dcd309e579b725.zip
Merge remote-tracking branch 'origin/current' into fix/codecopier-snippet-leak-and-clipboard-error
# Conflicts: # docs/_static/js/codecopier.js
Diffstat (limited to 'docs/Makefile')
-rw-r--r--docs/Makefile42
1 files changed, 32 insertions, 10 deletions
diff --git a/docs/Makefile b/docs/Makefile
index cb6226af..ae12b802 100644
--- a/docs/Makefile
+++ b/docs/Makefile
@@ -12,22 +12,44 @@ AUTOHOST = 0.0.0.0
AUTOPORT = 8000
AUTOOPTS = --watch .
+SWAP = python3 ../scripts/swap_sources.py
+
# Put it first so that "make" without argument is like "make help".
help:
@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
-.PHONY: help Makefile
+.PHONY: help Makefile swap restore html dirhtml pdf livehtml defaultvalue
-# Catch-all target: route all unknown targets to Sphinx using the new
-# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS).
-%: Makefile
- @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+swap:
+ $(SWAP) --swap
-livehtml:
- sphinx-autobuild --host $(AUTOHOST) --port $(AUTOPORT) $(AUTOOPTS) \
- "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+restore:
+ $(SWAP) --restore
+
+html: swap
+ @trap '$(SWAP) --restore' EXIT; \
+ $(SPHINXBUILD) -M html "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+dirhtml: swap
+ @trap '$(SWAP) --restore' EXIT; \
+ $(SPHINXBUILD) -M dirhtml "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+pdf: swap
+ @trap '$(SWAP) --restore' EXIT; \
+ $(SPHINXBUILD) -M latexpdf "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+livehtml: swap
+ @trap '$(SWAP) --restore' EXIT; \
+ sphinx-autobuild --host $(AUTOHOST) --port $(AUTOPORT) \
+ --ignore '$(BUILDDIR)/**' \
+ --ignore '**/_build/**' \
+ --ignore '**/md-*' \
+ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
defaultvalue: export VYOS_DEFAULT=True
-defaultvalue:
- @$(SPHINXBUILD) -M html "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) \ No newline at end of file
+defaultvalue: html
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+ @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)