Support plone-sphinx-theme

Makefile

@@ -7,6 +7,16 @@ CACHIX_CACHE ?= datakurre
 TEST = $(wildcard tests/*.py)
 SRC = $(wildcard src/sphinxcontrib/httpexample/*.py)
 
+# Sphinx variables
+# You can set these variables from the command line.
+SPHINXOPTS      ?=
+# Internal variables.
+SPHINXBUILD     = "$(realpath env/bin/sphinx-build)"
+SPHINXAUTOBUILD = "$(realpath env/bin/sphinx-autobuild)"
+DOCS_DIR        = ./docs/
+BUILDDIR        = ../_build/
+ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(SPHINXOPTS) .
+
 .PHONY: all
 all: test coverage
 
@@ -27,10 +37,14 @@ cache:
 
 .PHONY: docs
 docs:
-	sphinx-build -b html docs docs/html
-ifeq "$(PYTHON)" "python27"
-	sphinx-build -b pdf docs docs/pdf
-endif
+	cd $(DOCS_DIR) && $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
+
+.PHONY: livehtml
+livehtml:  ## Rebuild Sphinx documentation on changes, with live-reload in the browser
+	cd "$(DOCS_DIR)" && ${SPHINXAUTOBUILD} \
+		--ignore "*.swp" \
+		--port 8050 \
+		-b html . "$(BUILDDIR)/html" $(SPHINXOPTS) $(O)
 
 .PHONY: coverage
 coverage: .coverage

docs/conf.py

@@ -125,7 +125,8 @@
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
-html_theme = 'sphinx_rtd_theme'
+# html_theme = 'sphinx_rtd_theme'
+html_theme = 'plone_sphinx_theme'
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the
@@ -135,6 +136,10 @@
 # Add any paths that contain custom themes here, relative to this directory.
 #html_theme_path = []
 
+html_js_files = [
+    'jquery-3.6.0.min.js',
+]
+
 # The name for this set of Sphinx documents.  If None, it defaults to
 # "<project> v<release> documentation".
 #html_title = None

requirements.txt

@@ -3,7 +3,8 @@ MarkupSafe
 astunparse
 coverage
 coveralls
-docutils==0.17.1
+docutils
+#docutils==0.17.1
 flake8-blind-except
 flake8-coding
 flake8-debugger
@@ -19,7 +20,9 @@ pyyaml
 rst2pdf
 snapshottest==0.5.0
 sphinx
+sphinx-autobuild
 sphinx-testing
 sphinx_rtd_theme
+plone-sphinx-theme
 sphinxcontrib-httpdomain
 toml

src/sphinxcontrib/httpexample/static/sphinxcontrib-httpexample.js

@@ -1,7 +1,9 @@
 (function() {
   var jQuery = window.jQuery || function() {};
 
+  console.log("1");
   jQuery(function($) {
+    console.log("2");
     $('.http-example.container').each(function() {
       var $container = $(this),
           $blocks = $(this).children(),