.. ########## LEFT SIDE NAVIGATION ##########

.. uncomment/comment toctree to show/hide
.. toctree::
   :hidden:
   :caption: About Yambo

   about_yambo/index_yambocode.rst
   about_yambo/index_inputvariables.md

.. toctree::
   :hidden:
   :caption: Tutorials

   tutorials/index_overview.md
   tutorials/index_tutorialfiles.md
   tutorials/index_alltutorials.md

.. toctree::
   :hidden:
   :caption: Events and schools

   events_and_schools/index_2025_paris_workshop.md 
.. events_and_schools/index_YYYY_<place>_<event-type>.md/rst

.. uncomment/comment the following toctree line to show/hide in output
   .. toctree::
   :hidden:
   :caption: Wiki instructions

   wiki_instructions/index_contribute.rst
   wiki_instructions/index_kitchen_sink.rst


.. ########## CONTENT STARTS HERE ##########

==========
YAMBO-WIKI
==========

.. admonition:: Note to the user

   The new wiki is under construction! The old one is still `here <https://wiki.yambo-code.eu/wiki/index.php/Main_Page>`__.

Welcome! Here you will find information about how to run 
Yambo and, more generally, about the methods implemented in the code.

To navigate the contents of this *wiki* use the **side menu**.

Here are some quick links to relevant external pages:

.. grid:: 3

   .. grid-item-card::
      :width: 100%
      :img-background: ./media/card_website.png
      :img-alt: card_website_yambo-code
      :link: https://www.yambo-code.eu
      :text-align: center

   .. grid-item-card::
      :width: 100%
      :img-background: ./media/card_github.png
      :img-alt: card_github_yambo-code
      :link: https://github.com/yambo-code
      :text-align: center

   .. grid-item-card::
      :width: 100%
      :img-background: ./media/card_documentation.png
      :img-alt: card_documentation_yambo-code
      :link: https://github.com/yambo-code
      :text-align: center

.. todo::

   Add link to documentation when it's ready.

.. todo::

   .. important::

       Update (if needed) ``.github/workflows/sphinx.yml`` to use version ``8.3`` of ``sphinx`` when it becomes stable.