[documentation] Shrink module/class headers

docs/_templates/custom-class-template.rst

@@ -1,4 +1,9 @@
-{{ fullname | escape | underline}}
+{% set truncated_fullname = fullname.split('.')[-1] %}
+{% if truncated_fullname | length < 4 %}
+   {% set truncated_fullname = truncated_fullname.ljust(4) %}
+{% endif %}
+Class - {{ truncated_fullname | escape | underline}} 
+
 
 .. currentmodule:: {{ module }}
 

docs/_templates/custom-exception-template.rst

@@ -0,0 +1,21 @@
+{% set truncated_fullname = fullname.split('.')[-1] %}
+{% if truncated_fullname | length < 4 %}
+   {% set truncated_fullname = truncated_fullname.ljust(4) %}
+{% endif %}
+Exceptions - {{ truncated_fullname | escape | underline}}
+
+
+.. currentmodule:: {{ module }}
+
+.. autofunction:: {{ objname }}
+
+   {% block attributes %}
+   {% if attributes %}
+   .. rubric:: {{ _('Attributes') }}
+
+   .. autosummary::
+   {% for item in attributes %}
+      ~{{ name }}.{{ item }}
+   {%- endfor %}
+   {% endif %}
+   {% endblock %}

docs/_templates/custom-function-template.rst

@@ -0,0 +1,21 @@
+{% set truncated_fullname = fullname.split('.')[-1] %}
+{% if truncated_fullname | length < 4 %}
+   {% set truncated_fullname = truncated_fullname.ljust(4) %}
+{% endif %}
+Function - {{ truncated_fullname | escape | underline}}
+
+
+.. currentmodule:: {{ module }}
+
+.. autofunction:: {{ objname }}
+
+   {% block attributes %}
+   {% if attributes %}
+   .. rubric:: {{ _('Attributes') }}
+
+   .. autosummary::
+   {% for item in attributes %}
+      ~{{ name }}.{{ item }}
+   {%- endfor %}
+   {% endif %}
+   {% endblock %}

docs/_templates/custom-module-template.rst

@@ -1,4 +1,8 @@
-{{ fullname | escape | underline}}
+{% set truncated_fullname = fullname.split('.')[-1] %}
+{% if truncated_fullname | length < 4 %}
+   {% set truncated_fullname = truncated_fullname.ljust(4) %}
+{% endif %}
+Module - {{ truncated_fullname | escape | underline}}
 
 .. automodule:: {{ fullname }}
 
@@ -20,6 +24,7 @@
 
    .. autosummary::
       :toctree:
+      :template: custom-function-template.rst
    {% for item in functions %}
       {{ item }}
    {%- endfor %}
@@ -45,6 +50,7 @@
 
    .. autosummary::
       :toctree:
+      :template: custom-exception-template.rst
    {% for item in exceptions %}
       {{ item }}
    {%- endfor %}