toctree-toggle styled dropdown + responsive grid

story645 · story645 · commit 9d45b89e6a1f · 2022-11-21T20:50:37.000-05:00
diff --git a/doc/_static/mpl.css b/doc/_static/mpl.css
@@ -110,3 +110,21 @@ table.property-table td {
     list-style:none;
     padding-inline-start:0em;
 }
+
+/* styles dropdown like toctree-toggle */
+details.sd-dropdown{
+    box-shadow: none !important;
+}
+
+details.sd-dropdown summary.sd-card-header,
+details.sd-dropdown summary.sd-card-header+div.sd-summary-content {
+    --pst-sd-dropdown-color: none;
+}
+
+details.sd-dropdown summary {
+    /* padding: 1em; */
+    padding: 0;
+  }
+
+  .sd-dropdown>.sd-card-body{
+    padding: 0;}
diff --git a/doc/users/explain/index.rst b/doc/users/explain/index.rst
@@ -2,8 +2,9 @@
 
 .. redirect-from:: /users/explain
 
-Explanations
-------------
+
+API Documentation
+=================
 
 .. toctree::
     :maxdepth: 2
diff --git a/doc/users/index.rst b/doc/users/index.rst
@@ -2,36 +2,41 @@
 
 .. redirect-from:: /contents
 
-..
-.. grid:: 3
+==========
+User guide
+==========
+
+.. grid:: 1 1 3 3
 
    .. grid-item-card:: Information
+      :shadow: none
+      :class-card: sd-border-0
 
-      .. dropdown:: Getting Started
+      .. dropdown:: :doc:`getting_started/index`
          :open:
 
          .. toctree::
             :maxdepth: 2
 
             getting_started/index.rst
 
-      .. dropdown:: Installation
+      .. dropdown:: :doc:`installing/index`
          :open:
 
          .. toctree::
             :maxdepth: 2
 
             installing/index.rst
 
-      .. dropdown:: Contributing
+      .. dropdown:: :doc:`../devel/index`
          :open:
 
          .. toctree::
             :maxdepth: 2
 
             ../devel/index.rst
 
-      .. dropdown:: About
+      .. dropdown:: :doc:`project/index`
          :open:
 
          .. toctree::
@@ -41,32 +46,34 @@
 
 
    .. grid-item-card:: Explanations & Examples
+      :shadow: none
+      :class-card: sd-border-0
 
-      .. dropdown:: API Explanations
+      .. dropdown:: :doc:`explain/index`
          :open:
 
          .. toctree::
             :maxdepth: 2
 
             explain/index.rst
 
-      .. dropdown:: Plot Types
+      .. dropdown:: :doc:`../plot_types/index`
          :open:
 
          .. toctree::
             :maxdepth: 2
 
             ../plot_types/index.rst
 
-      .. dropdown:: Tutorials
+      .. dropdown:: :doc:`../tutorials/index`
          :open:
 
          .. toctree::
             :maxdepth: 2
 
             ../tutorials/index.rst
 
-      .. dropdown:: Example Gallery
+      .. dropdown:: :doc:`../gallery/index`
          :open:
 
          .. toctree::
@@ -76,32 +83,34 @@
 
 
    .. grid-item-card:: References & Resources
+      :shadow: none
+      :class-card: sd-border-0
 
-      .. dropdown:: API Reference
+      .. dropdown:: :doc:`../api/index`
          :open:
 
          .. toctree::
             :maxdepth: 2
 
             ../api/index.rst
 
-      .. dropdown:: Release Notes
+      .. dropdown:: :doc:`release_notes`
          :open:
 
          .. toctree::
             :maxdepth: 2
 
             release_notes.rst
 
-      .. dropdown:: Troubleshooting
+      .. dropdown:: :doc:`faq/index`
          :open:
 
          .. toctree::
             :maxdepth: 2
 
             faq/index.rst
 
-      .. dropdown:: External Resources
+      .. dropdown:: :doc:`resources/index`
          :open:
 
          .. toctree::
diff --git a/doc/users/project/index.rst b/doc/users/project/index.rst
@@ -1,7 +1,8 @@
 .. redirect-from:: /users/backmatter
 
+===================
 Project information
--------------------
+===================
 
 .. toctree::
     :maxdepth: 2
