feat: add full-width CSS and examples documentation

Author: Alexboiboi

docs/_static/fullwidth.css

@@ -0,0 +1,24 @@
+/* PyData Sphinx Theme Full Width CSS - Simplest Approach */
+/* Apply full-width to all main containers */
+
+.bd-container,
+.bd-container__inner {
+    max-width: 100% !important;
+}
+
+.bd-main,
+.bd-content {
+    max-width: 100% !important;
+}
+
+.bd-article-container,
+.bd-article {
+    max-width: 100em !important;
+}
+
+/* Ensure notebook cells use full width */
+.cell,
+.cell_input,
+.cell_output {
+    max-width: 100% !important;
+}

docs/conf.py

@@ -33,8 +33,9 @@
 html_theme_options: dict[str, Any] = {
     # "announcement": announcement,
     "logo": {
-        "text": "Magpylib",
-        "image_dark": "./_static/images/magpylib_logo.png",
+        "text": "Magpylib-Material-Response",
+        "image_light": "_static/images/magpylib_logo.png",
+        "image_dark": "_static/images/magpylib_logo.png",
     },
     "header_links_before_dropdown": 4,
     "show_version_warning_banner": True,
@@ -94,5 +95,8 @@
 
 html_js_files = [
     "https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js",
-    # "https://unpkg.com/thebe@latest/lib/index.js",
 ]
+
+# Static files (CSS/JS)
+html_static_path = ["_static"]
+html_css_files = ["fullwidth.css"]

docs/examples/index.md

@@ -0,0 +1,10 @@
+# Examples
+
+This section contains examples demonstrating the use of Magpylib-Material-Response.
+
+```{toctree}
+:maxdepth: 1
+:glob:
+
+*
+```

docs/index.md

@@ -1,4 +1,4 @@
-# magpylib-material-response
+# Documentation
 
 ```{include} ../README.md
 :start-after: <!-- SPHINX-START -->
@@ -8,14 +8,8 @@
 :caption: CONTENT
 :glob: true
 :maxdepth: 2
-```
-
-```{toctree}
-:caption: EXAMPLES
-:glob: true
-:maxdepth: 2
 
-examples/*
+examples/index
 ```
 
 ## Indices and tables