diff --git a/README.md b/README.md
index 7cc20ce62..3f420bf8f 100644
--- a/README.md
+++ b/README.md
@@ -23,6 +23,16 @@ uv export --format requirements-txt > requirements.txt
```bash
pip install -r requirements.txt
```
+## Lucide icons
+
+Use `|icon download|` in RST (see `conf.py`). Icon names can be found in `lucide_icons.py`,
+generated from `_themes/theme/static/js/lucide.min.js`:
+
+```bash
+python scripts/generate_lucide_icons.py
+```
+
+Run again after replacing `lucide.min.js`.
## Build
English `en` is the default language.
diff --git a/_themes/theme/layout.html b/_themes/theme/layout.html
index 2681fd343..0da7e5f1c 100644
--- a/_themes/theme/layout.html
+++ b/_themes/theme/layout.html
@@ -78,6 +78,8 @@
{# Keep modernizr in head - http://modernizr.com/docs/#installing #}
+ {# Lucide icons #}
+
@@ -221,6 +223,9 @@
});
+ {# Lucide Icons #}
+
+
{%- block footer %} {% endblock %}