Docs: build directly using sphinx

meson.options

@@ -17,6 +17,13 @@ option(
   description: 'Build the HTML / PDF documentation'
 )
 
+option(
+  'legacy-docs',
+  type: 'boolean',
+  value: false,
+  description: 'Use the legacy doc build pipeline (build-docs.py)'
+)
+
 #
 # Features
 #

src/doc/common/templates-furo/autosummary/base.rst

@@ -0,0 +1,7 @@
+.. _{{ fullname }}:
+
+{{ fullname | escape | underline}}
+
+.. currentmodule:: {{ module }}
+
+.. auto{{ objtype }}:: {{ objname }}

src/doc/common/templates-furo/autosummary/module.rst

@@ -0,0 +1,21 @@
+.. _{{ fullname }}:
+
+{{ fullname | escape | underline}}
+
+.. automodule:: {{ fullname }}
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+{%- block modules %}
+{%- if modules %}
+.. rubric:: Modules
+
+.. autosummary::
+   :toctree:
+   :recursive:
+{% for item in modules %}
+   {{ item }}
+{%- endfor %}
+{% endif %}
+{%- endblock %}