Excludes table-of-contents from main page

- Removes the table of contents at the end of the main page since it is always
    visible in the side bar.

tripy/docs/_templates/layout.html

@@ -0,0 +1,5 @@
+<!-- This template lets us hide the TOCs from the main page and only include them in the sidebars -->
+{% block sidebartoc %}
+<h3>{{ _('Table Of Contents') }}</h3>
+{{ toctree(includehidden=True) }}
+{% endblock %}

tripy/docs/conf.py

@@ -84,6 +84,8 @@
 # The master toctree document.
 master_doc = "index"
 
+templates_path = ["_templates"]
+
 # General information about the project.
 project = "Tripy"
 copyright = "2024, NVIDIA"

tripy/docs/generate_rsts.py

@@ -136,6 +136,7 @@ def add_guide_set(guide_set):
             dedent(
                 f"""
                 .. toctree::
+                    :hidden:
                     :caption: {guide_set.title}
                     :maxdepth: 1
                 """
@@ -152,6 +153,7 @@ def add_guide_set(guide_set):
             dedent(
                 f"""
                 .. toctree::
+                    :hidden:
                     :caption: API Reference
                     :maxdepth: 1
                 """
@@ -309,7 +311,7 @@ def str_from_hierarchy(obj):
 
     print(f"Generating documentation hierarchy:\n{str_from_hierarchy(doc_hierarcy)}")
 
-    EXCLUDE_DIRS = ["_static"]
+    EXCLUDE_DIRS = ["_static", "_templates"]
 
     guide_sets: List[GuideSet] = []
     guide_dirs = list(