suil: build documentation using sphinxygen and sphinx-lv2-theme

NixOS · Oct 25, 2024 · 8ad1fe0 · 8ad1fe0
2 parents 06d7dd0 + 5b97645
commit 8ad1fe0
Show file tree

Hide file tree

Showing 3 changed files with 41 additions and 2 deletions.
diff --git a/pkgs/development/libraries/audio/suil/default.nix b/pkgs/development/libraries/audio/suil/default.nix
@@ -7,6 +7,10 @@
   pkg-config,
   meson,
   ninja,
+  sphinxygen,
+  doxygen,
+  sphinx,
+  python3Packages,
 
   # runtime
   lv2,
@@ -40,11 +44,13 @@ stdenv.mkDerivation rec {
     meson
     ninja
     pkg-config
+    sphinxygen
+    doxygen
+    sphinx
+    python3Packages.sphinx-lv2-theme
   ];
 
   mesonFlags = [
-    # docs require sphinxygen
-    (mesonEnable "docs" false)
     (mesonEnable "gtk2" withGtk2)
     (mesonEnable "gtk3" withGtk3)
     (mesonEnable "qt5" withQt5)

diff --git a/pkgs/development/python-modules/sphinx-lv2-theme/default.nix b/pkgs/development/python-modules/sphinx-lv2-theme/default.nix
@@ -0,0 +1,31 @@
+{
+  lib,
+  python3Packages,
+  fetchPypi,
+  sphinx,
+}:
+
+python3Packages.buildPythonPackage rec {
+  pname = "sphinx-lv2-theme";
+  version = "1.4.2";
+  format = "setuptools";
+
+  src = fetchPypi {
+    pname = "sphinx_lv2_theme";
+    inherit version;
+    hash = "sha256-Sgma4gxCcXnAzwgfAdU2alVHeEgNicLXegM0Z+BufDg=";
+  };
+
+  propagatedBuildInputs = [
+    sphinx
+  ];
+
+  pythonImportsCheck = [ "sphinx_lv2_theme" ];
+
+  meta = with lib; {
+    description = "Sphinx theme in the style of the LV2 plugin";
+    homepage = "https://gitlab.com/lv2/sphinx_lv2_theme";
+    license = licenses.bsd0;
+    maintainers = with maintainers; [ samueltardieu ];
+  };
+}
diff --git a/pkgs/top-level/python-packages.nix b/pkgs/top-level/python-packages.nix
@@ -14773,6 +14773,8 @@ self: super: with self; {
 
   sphinx-jupyterbook-latex = callPackage ../development/python-modules/sphinx-jupyterbook-latex { };
 
+  sphinx-lv2-theme = callPackage ../development/python-modules/sphinx-lv2-theme { };
+
   sphinx-multitoc-numbering = callPackage ../development/python-modules/sphinx-multitoc-numbering { };
 
   sphinx-notfound-page = callPackage ../development/python-modules/sphinx-notfound-page { };