Add more autosummary templates

Author: antonwolfy

doc/_templates/autosummary/attribute.rst

@@ -0,0 +1,13 @@
+:orphan:
+
+{{ fullname | escape | underline}}
+
+.. currentmodule:: {{ module }}
+
+attribute
+
+.. auto{{ objtype }}:: {{ fullname | replace("dpnp.", "dpnp::") }}
+
+{# In the fullname (e.g. ``dpnp.ndarray.methodname``), the module name is
+   ambiguous. Using a ``::`` separator (e.g. ``dpnp::ndarray.methodname``)
+   specifies ``dpnp`` as the module name. #}

doc/_templates/autosummary/base.rst

@@ -0,0 +1,17 @@
+{% if objtype == 'property' %}
+:orphan:
+{% endif %}
+
+{{ fullname | escape | underline}}
+
+.. currentmodule:: {{ module }}
+
+{% if objtype == 'property' %}
+property
+{% endif %}
+
+.. auto{{ objtype }}:: {{ fullname | replace("dpnp.", "dpnp::") }}
+
+{# In the fullname (e.g. ``dpnp.ndarray.methodname``), the module name is
+   ambiguous. Using a ``::`` separator (e.g. ``dpnp::ndarray.methodname``)
+   specifies ``dpnp`` as the module name. #}

doc/_templates/autosummary/class.rst

@@ -1,53 +1,27 @@
-{{ fullname }}
-{{ underline }}
-
-.. currentmodule:: {{ module }}
-
-.. autoclass:: {{ objname }}
-
-   ..
-      Methods
+{% extends "!autosummary/class.rst" %}
 
 {% block methods %}
-
-   .. rubric:: Methods
-
-   ..
-      Special methods
-
-{% for item in ('__getitem__', '__setitem__', '__len__', '__next__', '__iter__') %}
-{% if item in all_methods or item in all_attributes %}
-   .. automethod:: {{ item }}
+{% if methods %}
+   .. HACK -- the point here is that we don't want this to appear in the output, but the autosummary should still generate the pages.
+      .. autosummary::
+         :toctree:
+      {% for item in all_methods %}
+         {%- if not item.startswith('_') or item in ['__call__'] %}
+         {{ name }}.{{ item }}
+         {%- endif -%}
+      {%- endfor %}
 {% endif %}
-{%- endfor %}
-
-   ..
-      Ordinary methods
-
-{% for item in methods %}
-{% if item not in ('__init__',) %}
-   .. automethod:: {{ item }}
-{% endif %}
-{%- endfor %}
-
-   ..
-      Special methods
+{% endblock %}
 
-{% for item in ('__eq__', '__ne__', '__lt__', '__le__', '__gt__', '__ge__') %}
-{% if item in all_methods %}
-   .. automethod:: {{ item }}
+{% block attributes %}
+{% if attributes %}
+   .. HACK -- the point here is that we don't want this to appear in the output, but the autosummary should still generate the pages.
+      .. autosummary::
+         :toctree:
+      {% for item in all_attributes %}
+         {%- if not item.startswith('_') %}
+         {{ name }}.{{ item }}
+         {%- endif -%}
+      {%- endfor %}
 {% endif %}
-{%- endfor %}
 {% endblock %}
-
-   ..
-      Attributes
-
-{% block attributes %} {% if attributes %}
-
-   .. rubric:: Attributes
-
-{% for item in attributes %}
-   .. autoattribute:: {{ item }}
-{%- endfor %}
-{% endif %} {% endblock %}

doc/_templates/autosummary/member.rst

@@ -0,0 +1,13 @@
+:orphan:
+
+{{ fullname | escape | underline}}
+
+.. currentmodule:: {{ module }}
+
+member
+
+.. auto{{ objtype }}:: {{ fullname | replace("dpnp.", "dpnp::") }}
+
+{# In the fullname (e.g. ``dpnp.ndarray.methodname``), the module name is
+   ambiguous. Using a ``::`` separator (e.g. ``dpnp::ndarray.methodname``)
+   specifies ``dpnp`` as the module name. #}

doc/_templates/autosummary/method.rst

@@ -0,0 +1,13 @@
+:orphan:
+
+{{ fullname | escape | underline}}
+
+.. currentmodule:: {{ module }}
+
+method
+
+.. auto{{ objtype }}:: {{ fullname | replace("dpnp.", "dpnp::") }}
+
+{# In the fullname (e.g. ``dpnp.ndarray.methodname``), the module name is
+   ambiguous. Using a ``::`` separator (e.g. ``dpnp::ndarray.methodname``)
+   specifies ``dpnp`` as the module name. #}

doc/_templates/autosummary/minimal_module.rst

@@ -0,0 +1,6 @@
+{{ fullname | escape | underline}}
+
+.. automodule:: {{ fullname }}
+
+   {% block docstring %}
+   {% endblock %}

doc/_templates/autosummary/module.rst

@@ -0,0 +1,41 @@
+{% extends "!autosummary/module.rst" %}
+
+{# This file is almost the same as the default, but adds :toctree: to the
+   autosummary directives. The original can be found at
+   ``sphinx/ext/autosummary/templates/autosummary/module.rst``. #}
+
+{% block attributes %}
+{% if attributes %}
+   .. rubric:: Module Attributes
+
+   .. autosummary::
+      :toctree:
+   {% for item in attributes %}
+      {{ item }}
+   {%- endfor %}
+{% endif %}
+{% endblock %}
+
+{% block functions %}
+{% if functions %}
+   .. rubric:: Functions
+
+   .. autosummary::
+      :toctree:
+   {% for item in functions %}
+      {{ item }}
+   {%- endfor %}
+{% endif %}
+{% endblock %}
+
+{% block classes %}
+{% if classes %}
+   .. rubric:: Classes
+
+   .. autosummary::
+      :toctree:
+   {% for item in classes %}
+      {{ item }}
+   {%- endfor %}
+{% endif %}
+{% endblock %}