Add pip install option to documentation

doc/htmldoc/.gitignore

@@ -6,3 +6,4 @@ auto_examples/
 static/examples
 # json data is produced at build time by Sphinx
 static/data/filter_model.json
+sg_execution_times.rst

doc/htmldoc/index.rst

@@ -22,6 +22,12 @@ Welcome to the NEST Simulator documentation!
           ranging from algorithmically determined connections to data-driven connectivity.
           Create connections between neurons using numerous synapse models from STDP to gap junctions.
 
+          To get started you can:
+
+          ``pip install nest-simulator``
+
+          see :ref:`here <install_nest>` for all installation options!
+
 
        .. grid-item::
 

doc/htmldoc/installation/index.rst

@@ -1,35 +1,46 @@
 .. _install_nest:
 
-Install NEST
-============
+Install and run NEST
+====================
 
-
-.. grid:: 2
+.. grid::
    :gutter: 1
 
-   .. grid-item-card:: |user|  Install a pre-built NEST package using
-      :class-title: sd-d-flex-row sd-align-minor-center
-      :columns: 4
 
-      * :ref:`Docker (cross-platform) <docker>`
-        (Includes NESTML)
-      * :ref:`conda-forge (Linux/macOS) <conda_forge_install>`
-      * :ref:`Ubuntu PPA (Linux) <ubuntu_install>`
-      * :ref:`Homebrew (macOS) <macos_install>`
-      * :ref:`Options for Windows users <windows_install>`
+   .. grid-item-card:: |user| I want to run NEST on my laptop
+       :class-title: sd-d-flex-row sd-align-minor-center
+
+       You can ``pip install nest-simulator``
+
+       See our :ref`detailed instructions` including installing NEST with
+       |nestml| and |desktop|.
+
+       .. dropdown:: Other options for pre-packaged NEST
+          :class-title: sd-font-weight-light sd-fs-7 sd-text-secondary
+          :class-container: sd-align-major-center
+          :color: light
 
+          * :ref:`Docker (cross-platform) <docker>`
+            (Includes NESTML)
+          * :ref:`conda-forge (Linux/macOS) <conda_forge_install>`
+          * :ref:`Ubuntu PPA (Linux) <ubuntu_install>`
+          * :ref:`Homebrew (macOS) <macos_install>`
+          * :ref:`Options for Windows users <windows_install>`
 
-   .. grid-item-card:: |dev| Source install
+   .. grid-item-card:: |dev| I want to do development with NEST
       :class-title: sd-d-flex-row sd-align-minor-center
-      :columns: 4
 
-      If you want to do development with NEST
+      For customizing the build (e.g., adding MPI support), you can
 
       * :ref:`dev_install`
 
-   .. grid-item-card:: |launch| Try NEST installation-free
+
+.. grid::
+   :gutter: 1
+
+
+   .. grid-item-card:: |launch| I want to try out NEST without installing anything
       :class-title: sd-d-flex-row sd-align-minor-center
-      :columns: 4
 
       With the JupyterHub service from EBRAINS, you can
       try out NEST (and many other tools) directly in your browser.
@@ -42,48 +53,51 @@ Install NEST
 
       * For more info see :ref:`our guide to running Jupyter notebooks on EBRAINS <run_jupyter>`
 
-Install related tools
-~~~~~~~~~~~~~~~~~~~~~
 
-.. grid:: 2
-   :gutter: 1
-
-   .. grid-item-card:: |desktop|
+   .. grid-item-card:: |teach| I want to use NEST in the classroom/for a workshop
       :class-title: sd-d-flex-row sd-align-minor-center
-      :columns: 4
 
-      A graphical user interface, ideal for learning and teaching concepts
+
+      Use |desktop| -
+      a graphical user interface, ideal for learning and teaching concepts
       regarding neural networks in classrooms and workshops.
 
-      * :doc:`NEST Desktop documentation <desktop:index>` :octicon:`link-external`
+      * :doc:`Lecturer guide <desktop:lecturer/index>`
+      * :ref:`Introduction to PyNEST tutorial <pynest_tutorial>`
+      * :doc:`NESTML tutorials <nestml:tutorials/index>`
 
-      * :ref:`Install docker container with NEST + NEST Desktop <docker_compose>`
 
-   .. grid-item-card:: |nestml|
-      :class-title: sd-d-flex-row sd-align-minor-center
-      :columns: 4
 
-      Install the NEST modeling language to create and customize models
+.. grid::
+   :gutter: 1
 
+   .. grid-item-card:: |hpc| I want to run NEST on an HPC system
+     :class-title: sd-d-flex-row sd-align-minor-center
+     :columns: 6
 
-      * :doc:`NESTML documentation <nestml:index>` :octicon:`link-external`
+      We have provided some helpful guides to understanding and optimizing NEST
+      in HPC environments:
 
-      * :ref:`Install docker container for NEST + NESTML <docker>`
+      * :ref:`optimize_performance`
+      * :ref:`parallel_computing`
 
 
-   .. grid-item-card:: |hpc| Configure HPC systems
-      :class-title: sd-d-flex-row sd-align-minor-center
-      :columns: 4
+What's next?
+-------------
 
-      Find out how to set up and optimize HPC systems for NEST
 
-      * :ref:`optimize_performance`
+.. grid::
+   :gutter: 1
 
+   .. grid-item-card::
+     :columns: 6
 
+     See our :ref:`tutorials and guides <tutorials_guides>` to get started with NEST
+     or
+     explore are vast catalog of :ref:`examples <pynest_examples>`.
 
 ----
 
-
 If installation didn't work, see the :ref:`troubleshooting section <troubleshooting>`.
 
 
@@ -101,5 +115,10 @@ If installation didn't work, see the :ref:`troubleshooting section <troubleshoot
 .. |launch| image:: ../static/img/001-shuttle.svg
 .. |dev| image:: ../static/img/dev_orange.svg
 .. |desktop| image:: ../static/img/nestdesktop022023.svg
+   :width: 120px
+   :target: https://nest-desktop.readthedocs.io/en/latest/
 .. |nestml| image:: ../static/img/nestml022023.svg
+   :width: 80px
+   :target: https://nestml.readthedocs.io/en/latest/
 .. |hpc| image:: ../static/img/hpc_orange128.svg
+.. |teach| image:: ../static/img/014-teacher.svg

doc/htmldoc/static/css/custom.css

@@ -29,6 +29,7 @@
     --sd-color-info: var(--nest-blue);
     --sd-color-card-border-hover: var(--nest-orange);
     --sd-color-tabs-underline: #fff;
+    --sd-fontsize-dropdown-title: 0.8rem;
 }
 /* Define base font color and style */
 body{
@@ -360,6 +361,9 @@ nav.md-nav.md-nav--secondary label.md-nav__title:after{
 
 }
 
+details.sd-dropdown:not([open]).sd-card {
+  width: max-content;
+}
 #welcome-to-the-nest-simulator-documentation .sd-row-cols-lg-1 > *{
 width: 85%;
 }