doc: conf: add sphinx-design extension

Add sphinx-design to the list of Sphinx extensions in conf.py to enable
additional design components for documentation, starting with cards.

https://sphinx-design.readthedocs.io/en/latest/
Signed-off-by: Benjamin Cabé <[email protected]>

Author: kartben

doc/_static/css/custom.css

@@ -1181,3 +1181,34 @@ li>a.code-sample-link.reference.internal {
 li>a.code-sample-link.reference.internal.current {
     text-decoration: underline;
 }
+
+/* sphinx-design classes */
+
+.sd-card {
+    background-color: var(--navbar-background-color) !important;
+    border-radius: 0.75rem !important;
+    border: 1px solid transparent !important;
+    transition: all 0.15s ease;
+    box-shadow: none !important;
+}
+
+.sd-card:hover {
+    transform: translateY(-3px);
+    box-shadow: 0 6px 12px rgba(0, 0, 0, 0.25) !important;
+    border-color: rgba(255, 255, 255, 0.05);
+}
+
+.sd-card-title {
+    font-size: 1.125rem !important;
+    font-weight: bold !important;
+    margin-bottom: 0.25rem !important;
+    color: #fff !important;
+}
+
+.sd-card-text {
+    color: var(--navbar-level-1-color) !important;
+    font-weight: 300 !important;
+    font-size: 0.9rem !important;
+    margin: 0 !important;
+    opacity: 0.85;
+}

doc/conf.py

@@ -77,6 +77,7 @@
     "sphinx.ext.graphviz",
     "sphinxcontrib.jquery",
     "sphinxcontrib.programoutput",
+    "sphinx_design",
     "zephyr.application",
     "zephyr.html_redirects",
     "zephyr.kconfig",

doc/requirements.in

@@ -12,6 +12,7 @@ sphinx-togglebutton
 sphinx-sitemap
 sphinx-autobuild
 sphinxcontrib.programoutput
+sphinx-design
 
 # YAML validation. Used by zephyr_module.
 PyYAML>=6.0

doc/requirements.txt

@@ -537,6 +537,7 @@ sphinx==8.2.3 \
     #   -r requirements.in
     #   sphinx-autobuild
     #   sphinx-copybutton
+    #   sphinx-design
     #   sphinx-last-updated-by-git
     #   sphinx-notfound-page
     #   sphinx-rtd-theme
@@ -553,6 +554,10 @@ sphinx-copybutton==0.5.2 \
     --hash=sha256:4cf17c82fb9646d1bc9ca92ac280813a3b605d8c421225fd9913154103ee1fbd \
     --hash=sha256:fb543fd386d917746c9a2c50360c7905b605726b9355cd26e9974857afeae06e
     # via -r requirements.in
+sphinx-design==0.6.1 \
+    --hash=sha256:b11f37db1a802a183d61b159d9a202314d4d2fe29c163437001324fe2f19549c \
+    --hash=sha256:b44eea3719386d04d765c1a8257caca2b3e6f8421d7b3a5e742c0fd45f84e632
+    # via -r requirements.in
 sphinx-last-updated-by-git==0.3.8 \
     --hash=sha256:6382c8285ac1f222483a58569b78c0371af5e55f7fbf9c01e5e8a72d6fdfa499 \
     --hash=sha256:c145011f4609d841805b69a9300099fc02fed8f5bb9e5bcef77d97aea97b7761