Tidied up index page

autoapi/mappers/base.py

@@ -140,6 +140,14 @@ class PythonMapperBase(object):
         parts.append("index")
         return "/".join(parts)
 
+    @property
+    def display(self):
+        """Whether to display this object or not.
+        
+        :type: bool
+        """
+        return True
+
     @property
     def ref_type(self):
         return self.type

autoapi/templates/index.rst

@@ -1,18 +1,15 @@
-Sphinx AutoAPI Index
+API Reference
-####################
+=============
 
-This page is the top-level of your generated API documentation.
+This page contains auto-generated API reference documentation [#f1]_.
-Below is a list of all items that are documented here.
 
 .. toctree::
-   :includehidden:
+   :titlesonly:
-   :glob:
-   :maxdepth: 1
 
-   {# Force whitespace #}
+   {% for page in pages %}
-
+   {% if page.top_level_object and page.display %}
-   {%- for page in pages %}
-   {%- if page.top_level_object %}
    {{ page.include_path }}
-   {%- endif %}
+   {% endif %}
-   {%- endfor %}
+   {% endfor %}
+
+.. [#f1] Created with `sphinx-autoapi <https://github.com/rtfd/sphinx-autoapi>`_