[Doc] Add separate top-level pages for examples and reference docs

doc/sphinx/_templates/cantera-org-links.html

@@ -11,12 +11,6 @@
         </a>
     </li>
 
-    <li class="nav-item">
-        <a class="nav-link nav-internal" href="/examples/index.html">
-            Examples
-        </a>
-    </li>
-
     <li class="nav-item">
         <a class="nav-link nav-internal" href="/community.html">
             Community
@@ -29,12 +23,6 @@
         </a>
     </li>
 
-    <li class="nav-item current active">
-        <a class="nav-link nav-internal" href="/documentation/index.html">
-            Documentation
-        </a>
-    </li>
-
     <li class="nav-item">
         <a class="nav-link nav-internal" href="/blog/index.html">
             Blog

doc/sphinx/conf.py

@@ -287,7 +287,7 @@ def escape_splats(app, what, name, obj, options, lines):
 
 html_theme_options = {
     "show_toc_level": 2,
-    "navbar_center": ["cantera-org-links"],
+    "navbar_center": ["cantera-org-links", "navbar-nav"],
     "navbar_end": ["version-switcher", "theme-switcher", "navbar-icon-links"],
     "logo": {
         "link": "/index.html",

doc/sphinx/documentation.rst

@@ -0,0 +1,16 @@
+
+Reference
+=========
+
+This pages provide detailed reference documentation for Cantera.
+
+.. toctree::
+   :caption: API Documentation
+   :maxdepth: 1
+
+   yaml/index
+   cython/index
+   matlab/index
+
+
+`C++ API Documentation <../../doxygen/html/index.html>`__

doc/sphinx/examples.rst

@@ -0,0 +1,21 @@
+Examples
+========
+
+Cantera includes examples for a number of applications. To see all examples written in a
+particular programming language, select the corresponding category below. Or, to browse
+all examples covering a particular topic, regardless of programming language, select
+from the :ref:`list of example tags <tagoverview>`.
+
+.. toctree::
+   :maxdepth: 2
+
+   examples/python/index
+   examples/cxx/index
+   examples/clib/index
+   examples/matlab_experimental/index
+   examples/fortran/index
+
+.. toctree::
+   :maxdepth: 1
+
+   _tags/tagsindex

doc/sphinx/index.rst

@@ -1,24 +1,8 @@
-.. Cantera documentation master file, created by
-   sphinx-quickstart on Mon Mar 12 11:43:09 2012.
-
-Documentation
-=============
-
-These are the detailed API documentation pages for the Python and Matlab
-interfaces for Cantera. There is also documentation of the YAML input file
-format.
+Table of Contents
+=================
 
 .. toctree::
-   :maxdepth: 2
-
-   yaml/index
-   cython/index
-   matlab/index
-
-   examples/python/index
-   examples/cxx/index
-   examples/clib/index
-   examples/matlab_experimental/index
-   examples/fortran/index
+   :maxdepth: 1
 
-   _tags/tagsindex
+   documentation
+   examples