Clean up autosummary usage

doc/_templates/autosummary/class.rst

@@ -1,33 +1,32 @@
-{% extends "!autosummary/class.rst" %}
+{{ fullname | escape | underline}}
 
-{% block methods %}
-{% if methods %}
+.. currentmodule:: {{ module }}
 
-..
- 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 %}
+.. autoclass:: {{ objname }}
 
-{% endif %}
-{% endblock %}
+ {% block methods %}
 
-{% block attributes %}
-{% if attributes %}
+ {% block attributes %}
+ {% if attributes %}
+ .. rubric:: {{ _('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 %}
+ {% for item in attributes %}
+ {% if item in members and not item.startswith('_') %}
+ ~{{ name }}.{{ item }}
+ {% endif %}
+ {%- endfor %}
+ {% endif %}
+ {% endblock %}
+
+ {% if methods %}
+ .. rubric:: {{ _('Methods') }}
 
-{% endif %}
-{% endblock %}
+ .. autosummary::
+ {% for item in methods %}
+ {% if item in members and (not item.startswith('_') or item in ['__call__']) %}
+ ~{{ name }}.{{ item }}
+ {% endif %}
+ {%- endfor %}
+ {% endif %}
+ {% endblock %}

doc/source/conf.py

@@ -76,7 +76,6 @@
  # to ensure that include files (partial pages) aren't built, exclude them
  # https://github.com/sphinx-doc/sphinx/issues/1965#issuecomment-124732907
  "**/includes/**",
- "**/api/pandas.Series.dt.rst",
 ]
 try:
  import nbconvert
@@ -130,6 +129,8 @@
 autodoc_typehints = "none"
 
 # numpydoc
+numpydoc_show_class_members = False
+numpydoc_show_inherited_class_members = False
 numpydoc_attributes_as_param_list = False
 
 # matplotlib plot directive

doc/source/reference/series.rst

@@ -273,6 +273,19 @@ pandas provides dtype-specific methods under various accessors.
 These are separate namespaces within :class:`Series` that only apply
 to specific data types.
 
+.. autosummary::
+ :toctree: api/
+ :nosignatures:
+ :template: autosummary/accessor.rst
+
+ Series.str
+ Series.cat
+ Series.dt
+ Series.sparse
+ DataFrame.sparse
+ Index.str
+
+
 =========================== =================================
 Data Type Accessor
 =========================== =================================
@@ -458,22 +471,6 @@ strings and apply several methods to it. These can be accessed like
  Series.str.isdecimal
  Series.str.get_dummies
 
-..
- The following is needed to ensure the generated pages are created with the
- correct template (otherwise they would be created in the Series/Index class page)
-
-..
- .. autosummary::
- :toctree: api/
- :template: autosummary/accessor.rst
-
- Series.str
- Series.cat
- Series.dt
- Series.sparse
- DataFrame.sparse
- Index.str
-
 .. _api.series.cat:
 
 Categorical accessor