From f2e0c05a468036ac4bfe26c49148552942d78104 Mon Sep 17 00:00:00 2001
From: tropf <tropf@users.noreply.github.com>
Date: Wed, 19 Mar 2025 17:58:21 +0100
Subject: [PATCH] doc: add section on inkscape plugins

---
 doc/packages/index.md            |  1 +
 doc/packages/inkscape.section.md | 29 +++++++++++++++++++++++++++++
 doc/redirects.json               |  6 ++++++
 3 files changed, 36 insertions(+)
 create mode 100644 doc/packages/inkscape.section.md

diff --git a/doc/packages/index.md b/doc/packages/index.md
index 89d7e477e76f..35bb6c1fe4ff 100644
--- a/doc/packages/index.md
+++ b/doc/packages/index.md
@@ -14,6 +14,7 @@ fish.section.md
 fuse.section.md
 geant4.section.md
 ibus.section.md
+inkscape.section.md
 kakoune.section.md
 krita.section.md
 linux.section.md
diff --git a/doc/packages/inkscape.section.md b/doc/packages/inkscape.section.md
new file mode 100644
index 000000000000..192c059cd2a0
--- /dev/null
+++ b/doc/packages/inkscape.section.md
@@ -0,0 +1,29 @@
+# Inkscape {#sec-inkscape}
+
+[Inkscape](https://inkscape.org) is a powerful vector graphics editor.
+
+## Plugins {#inkscape-plugins}
+Inkscape plugins are collected in the [`inkscape-extensions`](https://search.nixos.org/packages?channel=unstable&type=packages&query=cudaPackages) package set.
+To enable them, use an override on `inkscape-with-extensions`:
+
+```nix
+inkscape-with-extensions.override {
+  inkscapeExtensions = with inkscape-extensions; [
+    inkstitch
+  ];
+}
+```
+
+Similarly, this works in the shell:
+
+```bash
+$ nix-shell -p 'inkscape-with-extensions.override { inkscapeExtensions = with inkscape-extensions; [inkstitch]; }'
+[nix-shell:~]$ # Ink/Stitch is now available via the extension menu
+[nix-shell:~]$ inkscape
+```
+
+All available extension can be enabled by passing `inkscapeExtensions = null;`.
+
+::: {.note}
+Loading the Inkscape extensions stand-alone (without using `override`) does not affect Inkscape at all.
+:::
diff --git a/doc/redirects.json b/doc/redirects.json
index a229e00a1ec7..934c49877b97 100644
--- a/doc/redirects.json
+++ b/doc/redirects.json
@@ -17,6 +17,9 @@
   "ex-testEqualArrayOrMap-test-function-add-cowbell": [
     "index.html#ex-testEqualArrayOrMap-test-function-add-cowbell"
   ],
+  "inkscape-plugins": [
+    "index.html#inkscape-plugins"
+  ],
   "neovim": [
     "index.html#neovim"
   ],
@@ -62,6 +65,9 @@
   "sec-build-helper-extendMkDerivation": [
     "index.html#sec-build-helper-extendMkDerivation"
   ],
+  "sec-inkscape": [
+    "index.html#sec-inkscape"
+  ],
   "sec-language-cosmic": [
     "index.html#sec-language-cosmic"
   ],