[no ci] docs: separate page for module functions

Author: vpratz

docsrc/source/_templates/custom-class-template.rst renamed to docsrc/source/_templates/base.rst

@@ -1,5 +1,4 @@
-{{ objname | escape | underline}}
-
+{{ objname | escape | underline(line="=") }}
 
 {% if objtype == "function" -%}
 
@@ -13,8 +12,8 @@
 
 .. autoclass:: {{ objname }}
    :members:
-   :undoc-members:
-   :no-inherited-members:
+   :inherited-members:
+   :show-inheritance:
    :special-members: __call__
    :member-order: bysource
 

docsrc/source/_templates/custom-module-template.rst

@@ -1,6 +1,22 @@
 {{ objname | escape | underline}}
 
 .. automodule:: {{ fullname }}
+  :member-order: alphabetical
+
+  {% block modules %}
+  {% if modules %}
+  .. rubric:: Modules
+
+  .. autosummary::
+    :toctree:
+    :template: custom-module-template.rst
+    :recursive:
+  {% for item in modules %}
+    {{ item }}
+  {%- endfor %}
+
+  {% endif %}
+  {% endblock %}
 
   {% block attributes %}
   {% if attributes %}
@@ -18,6 +34,8 @@
   .. rubric:: {{ _('Functions') }}
 
   .. autosummary::
+    :toctree:
+    :template: base.rst
   {% for item in functions %}
     {{ item }}
   {%- endfor %}
@@ -30,7 +48,7 @@
 
   .. autosummary::
     :toctree:
-    :template: custom-class-template.rst
+    :template: base.rst
   {% for item in classes %}
     {{ item }}
   {%- endfor %}
@@ -43,28 +61,13 @@
 
   .. autosummary::
     :toctree:
-    :template: custom-class-template.rst
+    :template: base.rst
   {% for item in exceptions %}
     {{ item }}
   {%- endfor %}
   {% endif %}
   {% endblock %}
 
-  {% block modules %}
-  {% if modules %}
-  .. rubric:: Modules
-
-  .. autosummary::
-    :toctree:
-    :template: custom-module-template.rst
-    :recursive:
-  {% for item in modules %}
-    {{ item }}
-  {%- endfor %}
-
-  {% endif %}
-  {% endblock %}
-
  {% block attributes_def %}
   {% if attributes %}
   .. rubric:: Module Attributes
@@ -75,15 +78,3 @@
   {%- endfor %}
   {% endif %}
   {% endblock %}
-
-  {% block functions_def %}
-  {% if functions %}
-
-  .. rubric:: {{ _('Functions') }}
-
-  {% for item in functions %}
-  .. autofunction:: {{ item }}
-
-  {%- endfor %}
-  {% endif %}
-  {% endblock %}