Added comment to autoapi template.

Author: Paebbels

doc/_templates/autoapi/module.rst

@@ -1,16 +1,18 @@
-{{ node.name }}
-=={{ '=' * node.name|length }}==
+.. # Template modified  by Patrick Lehmann
+     * removed automodule on top, because private members are activated for autodoc (no doubled documentation).
+     * Made sections like 'submodules' bold text, but no headlines to reduce number of ToC levels.
 
-.. automodule:: {{ node.name }}
+=={{ '=' * node.name|length }}==
+``{{ node.name }}``
+=={{ '=' * node.name|length }}==
 
 {##}
 {%- block modules -%}
 {%- if subnodes %}
 
-.. #-----------------------------------
-{##}
 **Submodules**
 
+
 .. toctree::
 {% for item in subnodes %}
    {{ item.name }}
@@ -21,123 +23,85 @@
 {##}
 .. currentmodule:: {{ node.name }}
 {##}
+{%- block functions -%}
+{%- if node.functions %}
 
-.. #-----------------------------------
-{##}
-{%- if node.variables %}
-**Variables**
-{##}
-{% for item, obj in node.variables.items() -%}
-- :py:data:`{{ item }}`
-{% endfor -%}
-{%- endif -%}
-
+**Functions**
 
-{%- if node.exceptions %}
-{##}
-**Exceptions**
-{##}
-{% for item, obj in node.exceptions.items() -%}
-- :py:exc:`{{ item }}`:
+{% for item, obj in node.functions.items() -%}
+- :py:func:`{{ item }}`:
   {{ obj|summary }}
 
 {% endfor -%}
-{%- endif -%}
 
+{% for item in node.functions %}
+.. autofunction:: {{ item }}
+{##}
+{%- endfor -%}
+{%- endif -%}
+{%- endblock -%}
 
+{%- block classes -%}
 {%- if node.classes %}
-{##}
+
 **Classes**
-{##}
+
 {% for item, obj in node.classes.items() -%}
 - :py:class:`{{ item }}`:
   {{ obj|summary }}
 
 {% endfor -%}
-{%- endif -%}
 
+{% for item in node.classes %}
+.. autoclass:: {{ item }}
+   :members:
 
-{%- if node.functions %}
-{##}
-**Functions**
-{##}
-{% for item, obj in node.functions.items() -%}
-- :py:func:`{{ item }}`:
-  {{ obj|summary }}
-
-{% endfor -%}
-{%- endif -%}
-
-
-{%- block variables -%}
-{%- if node.variables %}
-{% for item, obj in node.variables.items() %}
-.. autodata:: {{ item }}
-   :annotation:
-
-   .. code-block:: guess
-
-      {{ obj|pprint|indent(6) }}
+   .. rubric:: Inheritance
+   .. inheritance-diagram:: {{ item }}
+      :parts: 1
 {##}
 {%- endfor -%}
 {%- endif -%}
 {%- endblock -%}
 
-
 {%- block exceptions -%}
 {%- if node.exceptions %}
 
-.. #-----------------------------------
-
-{% for item in node.exceptions %}
-.. autoexception:: {{ item }}
-   :members:
-   :private-members:
-   :inherited-members:
-   :undoc-members:
-{##}
-   .. rubric:: Inheritance
-   .. inheritance-diagram:: {{ item }}
-{##}
-   .. rubric:: Members
-{##}
-{%- endfor -%}
-{%- endif -%}
-{%- endblock -%}
+**Exceptions**
 
+{% for item, obj in node.exceptions.items() -%}
+- :py:exc:`{{ item }}`:
+  {{ obj|summary }}
 
-{%- block classes -%}
-{%- if node.classes %}
+{% endfor -%}
 
-.. #-----------------------------------
+{% for item in node.exceptions %}
+.. autoexception:: {{ item }}
 
-{% for item in node.classes %}
-.. autoclass:: {{ item }}
-   :members:
-   :private-members:
-   :undoc-members:
-   :inherited-members:
-{##}
    .. rubric:: Inheritance
    .. inheritance-diagram:: {{ item }}
       :parts: 1
-{##}
-   .. rubric:: Members
 {##}
 {%- endfor -%}
 {%- endif -%}
 {%- endblock -%}
 
+{%- block variables -%}
+{%- if node.variables %}
 
-{%- block functions -%}
-{%- if node.functions %}
+**Variables**
 
-.. #-----------------------------------
+{% for item, obj in node.variables.items() -%}
+- :py:data:`{{ item }}`
+{% endfor -%}
 
-**Functions**
+{% for item, obj in node.variables.items() %}
+.. autodata:: {{ item }}
+   :annotation:
 
-{% for item in node.functions %}
-.. autofunction:: {{ item }}
+   .. code-block:: text
+
+      {{ obj|pprint|indent(6) }}
 {##}
 {%- endfor -%}
 {%- endif -%}