Separate ESMValTool and ESMValCore documentation

doc/sphinx/source/_templates/cross_proj_navbar.html

@@ -0,0 +1,32 @@
+{# Displays links to the top-level TOCtree elements, in the header navbar. #}
+{% set href = pathto(root_doc) %}
+<nav>
+  <ul class="bd-navbar-elements navbar-nav">
+    {# { generate_header_nav_html(n_links_before_dropdown=theme_header_links_before_dropdown, dropdown_text=theme_header_dropdown_text) } #}
+        <li class="nav-item current active">
+            <a class="nav-link nav-internal" href="{{ href }}">
+            {{ (" ESMValTOOL ") }}
+            </a>
+        </li>
+        <li class="nav-item ">
+            <a class="nav-link nav-external" href="https://docs.esmvaltool.org/projects/ESMValCore/en/latest/index.html">
+             ESMValCORE
+            </a>
+        </li>
+        <li class="nav-item ">
+            <a class="nav-link nav-external" href="https://esmvaltool.dkrz.de/shared/esmvaltool/stable_release/">
+            Latest Release Gallery
+            </a>
+        </li>
+        <li class="nav-item ">
+            <a class="nav-link nav-external" href="https://tutorial.esmvaltool.org/">
+            Tutorial
+            </a>
+        </li>
+        <li class="nav-item ">
+            <a class="nav-link nav-external" href="https://esmvaltool.org/">
+            Main site
+            </a>
+        </li>
+  </ul>
+</nav>

doc/sphinx/source/_templates/sidebar_nav_lv1.html

@@ -0,0 +1,17 @@
+{# Displays the TOC-subtree for pages nested under the currently active top-level TOCtree element. EDITED #}
+<nav class="bd-docs-nav bd-links"
+     aria-label="{{ _('Section Navigation') }}">
+  <p class="bd-links__title" role="heading" aria-level="1">{{ _("Documentation Navigation") }}</p>
+  <div class="bd-toc-item navbar-nav">
+    {{- generate_toctree_html(
+      startdepth=0,
+      kind="sidebar",
+      show_nav_level=theme_show_nav_level | int,
+      maxdepth=theme_navigation_depth | int,
+      collapse=theme_collapse_navigation | tobool,
+      includehidden=theme_sidebar_includehidden | tobool,
+      titles_only=True
+      )
+    -}}
+  </div>
+</nav>

doc/sphinx/source/conf.py

@@ -174,6 +174,8 @@
         "image_light": "figures/ESMValTool-logo-2.png",
         "image_dark": "figures/ESMValTool-logo-2-dark.png",
     },
+    "navbar_center": ["cross_proj_navbar"],
+    "search_bar_text": "Search TOOL docs... (Also try search in ESMValCORE docs)",
 }
 # Add any paths that contain custom themes here, relative to this directory.
 # html_theme_path = []
@@ -213,7 +215,9 @@
 # html_use_smartypants = True
 
 # Custom sidebar templates, maps document names to template names.
-# html_sidebars = {}
+html_sidebars = {
+    "**": ["sidebar_nav_lv1", "sidebar-ethical-ads"]
+}
 
 # Additional templates that should be rendered to pages, maps page names to
 # template names.

doc/sphinx/source/index.rst

@@ -6,12 +6,35 @@
 Welcome to ESMValTool's documentation!
 ======================================
 
+**ESMValTool** is a community diagnostics and performance metrics tool for the evaluation of Earth System Models (ESMs) that allows for
+routine comparison of models and observations. It includes a large collection of community recipes and observation data formatters to CMOR standards.
+
+**ESMValCore** is a software package which provides the core functionality for ESMValTool. It is a workflow to find CMIP data, and apply
+commonly used pre-processing functions.
+
 To get a first impression of what ESMValTool and ESMValCore can do for you,
 have a look at our blog posts
 `Analysis-ready climate data with ESMValCore <https://blog.esciencecenter.nl/easy-ipcc-powered-by-esmvalcore-19a0b6366ea7>`_
 and
 `ESMValTool: Recipes for solid climate science <https://blog.esciencecenter.nl/esmvaltool-recipes-for-solid-climate-science-da5b33814f69>`_.
 
+
+Basic documentation schema
+--------------------------
+This gives a brief idea of topics in each of the packages to help find information. As ESMValTool encompasses ESMValCore there will be some overlap between them.
+For more detailed information, see documentation navigation to the left.
+
+.. container::
+   :name: figarch
+
+   .. figure:: figures/ESMValSchemaDiagram.png
+      :alt: Brief topics for tool and core.
+      :figclass: align-center
+
+
+Learning resources:
+-------------------
+
 A tutorial is available on https://tutorial.esmvaltool.org.
 
 A series of video lectures has been created by `ACCESS-NRI <https://access-nri.org.au>`_.
@@ -21,11 +44,15 @@ While these are tailored for ACCESS users, they are still very informative.
 
    <iframe width="560" height="315" src="https://www.youtube.com/embed/videoseries?si=pUXrXB8C8bLRfQHY&amp;list=PLFjfi2xLaFpJp59LvDc1upQsj_xzFlFLc" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
 
-|
+How to contribute
+-----------------
+Refer to ESMValTool :ref:`contributing to the community<community>` for a guide on contributing recipes and diagnostics.
 
-For more detailed information, the documentation is available below.
+Refer to ESMValCore :ref:`Contributing <contributing>`  for information on contributing code.
 
-Get in touch! Contact information is available :ref:`here <Support-and-Contact>`.
+Get in touch!
+-------------
+Contact information is available :ref:`here <Support-and-Contact>`.
 
 .. include:: _sidebar.rst.inc