Add emoji support to docs using sphinxemoji ✨

.readthedocs.yaml → .readthedocs.yml

@@ -17,11 +17,16 @@ sphinx:
 
 # Set the version of python needed to build these docs.
 build:
-  os: "ubuntu-22.04"
+  os: ubuntu-22.04
   tools:
     python: "3.12"
-  apt_packages:
-    - graphviz
+  jobs:
+    install:
+      - pip install -r requirements/base.txt
+    build:
+      html:
+        - make html SPHINXOPTS="-D language=en" BUILDDIR=$READTHEDOCS_OUTPUT
+
 
 # Optionally set the requirements required to build your docs
 python:

Makefile

@@ -6,7 +6,13 @@
 SPHINXOPTS    ?= -W --keep-going
 SPHINXBUILD   ?= sphinx-build
 SOURCEDIR     = source
-BUILDDIR      = build
+
+ifeq ($(READTHEDOCS),True)
+BUILDDIR = $(READTHEDOCS_OUTPUT)
+else
+BUILDDIR = build
+endif
+
 
 # Put it first so that "make" without argument is like "make help".
 help:
@@ -37,4 +43,4 @@ serve_docs: ## serve the built docs locally to preview the site in the browser
 # 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)
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)/html" $(SPHINXOPTS) $(O)

_build/html/.buildinfo

@@ -0,0 +1,4 @@
+# Sphinx build info version 1
+# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
+config: f8dc3f07afbd8177e8e4d1e2ca3387f3
+tags: 645f666f9bcd5a90fca523b33c5a78b7