Contribution to refactoring of the Docs

docs/basic_concepts.rst

@@ -0,0 +1,65 @@
+.. _basic_concepts_label:
+
+~~~~~~~~~~~~~~
+Basic Concepts
+~~~~~~~~~~~~~~
+
+The following sections give a detailed overview on the basic concepts of
+oemof.solph. This includes all important components like the energy system,
+buses and flows as well as the basic components.
+
+.. toctree::
+    :maxdepth: 1
+    :glob:
+    :hidden:
+
+    basic_concepts/energy_system.rst
+    basic_concepts/buses.rst
+    basic_concepts/flows.rst
+    basic_concepts/components.rst
+
+.. grid:: 2
+    :gutter: 1
+
+    .. grid-item-card::  Energy System
+        :link: basic_concepts_energy_system_label
+        :link-type: ref
+
+        .. image:: /_static/_logo/logo_oemof_solph_NOTEXT.svg
+            :class: only-light
+
+        .. image:: /_static/_logo/logo_oemof_solph_NOTEXT_darkmode.svg
+            :class: only-dark
+
+    .. grid-item-card::  Buses
+        :link: basic_concepts_buses_label
+        :link-type: ref
+
+        .. image:: /_static/_logo/logo_oemof_solph_NOTEXT.svg
+            :class: only-light
+
+        .. image:: /_static/_logo/logo_oemof_solph_NOTEXT_darkmode.svg
+            :class: only-dark
+
+.. grid:: 2
+    :gutter: 1
+
+    .. grid-item-card::  Flows
+        :link: basic_concepts_flows_label
+        :link-type: ref
+
+        .. image:: /_static/_logo/logo_oemof_solph_NOTEXT.svg
+            :class: only-light
+
+        .. image:: /_static/_logo/logo_oemof_solph_NOTEXT_darkmode.svg
+            :class: only-dark
+
+    .. grid-item-card::  Components
+        :link: basic_concepts_components_label
+        :link-type: ref
+
+        .. image:: /_static/_logo/logo_oemof_solph_NOTEXT.svg
+            :class: only-light
+
+        .. image:: /_static/_logo/logo_oemof_solph_NOTEXT_darkmode.svg
+            :class: only-dark

docs/basic_concepts/buses.rst

@@ -0,0 +1,7 @@
+.. _basic_concepts_buses_label:
+
+~~~~~
+Buses
+~~~~~
+
+Here could a nice and short explanation of oemof.solphs buses.

docs/basic_concepts/components.rst

@@ -0,0 +1,8 @@
+.. _basic_concepts_components_label:
+
+~~~~~~~~~~
+Components
+~~~~~~~~~~
+
+Here could a nice and short explanation of oemof.solphs components like sinks
+and sources as well as converters and storages.

docs/basic_concepts/energy_system.rst

@@ -0,0 +1,7 @@
+.. _basic_concepts_energy_system_label:
+
+~~~~~~~~~~~~~
+Energy System
+~~~~~~~~~~~~~
+
+Here could a nice and short explanation of oemof.solphs energy systems.

docs/basic_concepts/flows.rst

@@ -0,0 +1,7 @@
+.. _basic_concepts_flows_label:
+
+~~~~~
+Flows
+~~~~~
+
+Here could a nice and short explanation of oemof.solphs flows.