first pass at templates

Author: drakejwong

docs/source/_templates/autosummary/base.rst

@@ -0,0 +1,5 @@
+{{ fullname | escape | underline}}
+
+.. currentmodule:: {{ module }}
+
+.. auto{{ objtype }}:: {{ objname }}

docs/source/_templates/autosummary/class.rst

@@ -0,0 +1,8 @@
+{{ objname | escape | underline}}
+
+.. currentmodule:: {{ module }}
+
+.. autoclass:: {{ objname }}
+   :members:
+   :show-inheritance:
+   :inherited-members:

docs/source/_templates/autosummary/function.rst

@@ -0,0 +1,8 @@
+{{ objname | escape | underline }}
+
+.. currentmodule:: {{ module }}
+
+.. autofunction:: {{ name }}
+   :members:
+   :show-inheritance:
+   :inherited-members:

docs/source/_templates/module.rst renamed to docs/source/_templates/autosummary/module.rst

@@ -1,13 +1,16 @@
-{{ objname | escape | underline}}
+{{ objname | escape | underline }}
 
-.. automodule:: {{ objname }}
+.. automodule:: {{ fullname }}
+   :members:
+   :undoc-members:
+   :show-inheritance:
+   :inherited-members:
 
    {% block attributes %}
    {% if attributes %}
    .. rubric:: Module Attributes
 
-   .. autosummary::
-      :toctree:
+   .. autoattribute::
    {% for item in attributes %}
       {{ item }}
    {%- endfor %}
@@ -18,8 +21,7 @@
    {% if functions %}
    .. rubric:: {{ _('Functions') }}
 
-   .. autosummary::
-      :toctree:
+   .. autofunction::
    {% for item in functions %}
       {{ item }}
    {%- endfor %}
@@ -32,7 +34,6 @@
 
    .. autosummary::
       :toctree:
-      :template: class.rst
    {% for item in classes %}
       {{ item }}
    {%- endfor %}
@@ -43,8 +44,7 @@
    {% if exceptions %}
    .. rubric:: {{ _('Exceptions') }}
 
-   .. autosummary::
-      :toctree:
+   .. autoexception::
    {% for item in exceptions %}
       {{ item }}
    {%- endfor %}
@@ -54,10 +54,9 @@
 {% block modules %}
 {% if modules %}
 .. rubric:: Modules
-
+   
 .. autosummary::
    :toctree:
-   :template: module.rst
    :recursive:
 {% for item in modules %}
    {{ item }}

docs/source/_templates/class.rst

@@ -0,0 +1,64 @@
+{{ objname | escape | underline }}
+
+.. automodule:: {{ fullname }}
+   :members:
+   :undoc-members:
+   :show-inheritance:
+   :inherited-members:
+  
+   {% block attributes %}
+   {% if attributes %}
+   .. rubric:: Module Attributes
+
+   .. autoattribute::
+   {% for item in attributes %}
+      {{ item }}
+   {%- endfor %}
+   {% endif %}
+   {% endblock %}
+
+   {% block functions %}
+   {% if functions %}
+   .. rubric:: {{ _('Functions') }}
+
+   .. autofunction::
+   {% for item in functions %}
+      {{ item }}
+   {%- endfor %}
+   {% endif %}
+   {% endblock %}
+
+   {% block classes %}
+   {% if classes %}
+   .. rubric:: {{ _('Classes') }}
+
+   .. autoclass::
+   {% for item in classes %}
+      {{ item }}
+   {%- endfor %}
+   {% endif %}
+   {% endblock %}
+
+   {% block exceptions %}
+   {% if exceptions %}
+   .. rubric:: {{ _('Exceptions') }}
+
+   .. autoexception::
+   {% for item in exceptions %}
+      {{ item }}
+   {%- endfor %}
+   {% endif %}
+   {% endblock %}
+
+{% block modules %}
+{% if modules %}
+.. rubric:: Modules
+   
+.. autosummary::
+   :toctree:
+   :recursive:
+{% for item in modules %}
+   {{ item }}
+{%- endfor %}
+{% endif %}
+{% endblock %}

docs/source/_templates/nucleus-module.rst

@@ -3,7 +3,7 @@ API
 
 .. autosummary::
    :toctree: _autosummary
-   :template: module.rst
+   :template: nucleus-module.rst
    :recursive:
 
    nucleus