cleanup autodoc so it is all more legible

Author: bckohan

doc/source/configuration.rst

@@ -167,7 +167,7 @@ Context configuration parameters may be any of the following:
     - **python**: A path to a python file. The locals defined in the file will
       comprise the context.
     - **a packaged resource**: Any of the above files imported as a packaged resource via
-      :ref:`resource` to any of the above files.
+      :mod:`render_static.resource` to any of the above files.
     - **import string**: to any of the above.
 
 For example:

doc/source/index.rst

@@ -16,7 +16,7 @@ these structures by transpiling client side code from the server side code keeps
 DRY.
 
 :pypi:`django-render-static` includes Python to Javascript transpilers for:
-    - Django's :function:`~django.urls.reverse` function (:templatetag:`urls_to_js`)
+    - Django's :func:`~django.urls.reverse` function (:templatetag:`urls_to_js`)
     - PEP 435 style Python enumerations (:templatetag:`enums_to_js`)
     - Plain data define-like structures in Python classes and modules
       (:templatetag:`defines_to_js`)
@@ -43,7 +43,6 @@ encouraged! Especially additional template tags and filters!
    runtimes
    templatetags
    commands
-   reference
-   changelog
    migration
-
+   changelog
+   reference/index

doc/source/migration.rst

@@ -29,8 +29,8 @@ There are some import path changes in 3.0:
 Template Filter Changes
 ~~~~~~~~~~~~~~~~~~~~~~~
 
-classes_to_js and modules_to_js template filters have been removed and
-replaced by the :ref:`defines_to_js` tag. To upgrade simply replace the old
+:templatetag:`classes_to_js` and modules_to_js template filters have been removed and
+replaced by the :templatetag:`defines_to_js` tag. To upgrade simply replace the old
 filter with the new tag and pass the first argument as the defined parameter
 and the second argument if one was provided to the indent parameter:
 

doc/source/quick.rst

@@ -105,7 +105,7 @@ URLs will generate out of the box by running:
 
         $> ./manage.py renderstatic render_static/urls.js --dest ./urls.js
 
-If this fails, you may need to add some :ref:`placeholders`.
+If this fails, you may need to add some :mod:`~render_static.placeholders`.
 
 The output can be more customized as well. For example your settings file might look like:
 
@@ -314,7 +314,7 @@ So you can now fetch paths like this:
 
     If you get an exception when you run :django-admin:`renderstatic` that originated from a
     :class:`render_static.exceptions.URLGenerationFailed` exception, you mostly likely need to
-    register some :ref:`placeholders` before calling :templatetag:`urls_to_js`.
+    register some :mod:`~render_static.placeholders` before calling :templatetag:`urls_to_js`.
 
 .. note::
     The JavaScript URL resolution is guaranteed to produce the same paths as Django's reversal

doc/source/reference.rst

@@ -0,0 +1,10 @@
+backends
+--------
+
+.. automodule:: render_static.backends.django
+
+   .. autoclass:: StaticDjangoTemplates
+
+.. automodule:: render_static.backends.jinja2
+
+   .. autoclass:: StaticJinja2Templates

doc/source/reference/backends.rst

@@ -0,0 +1,6 @@
+context
+-------
+
+.. automodule:: render_static.context
+
+   .. autofunction:: resolve_context

doc/source/reference/context.rst

@@ -0,0 +1,8 @@
+engine
+-------
+
+.. automodule:: render_static.engine
+
+   .. autoclass:: StaticTemplateEngine
+    :members:
+    :special-members: __getitem__

doc/source/reference/engine.rst

@@ -0,0 +1,8 @@
+exceptions
+----------
+
+.. automodule:: render_static.exceptions
+
+    .. autoclass:: URLGenerationFailed
+    .. autoclass:: ReversalLimitHit
+

doc/source/reference/exceptions.rst

@@ -0,0 +1,22 @@
+.. _reference:
+
+=========
+Reference
+=========
+
+.. automodule:: render_static
+
+
+.. toctree::
+   :maxdepth: 2
+
+   engine
+   backends
+   loaders
+   origin
+   templatetags
+   transpilers/index
+   exceptions
+   placeholders
+   context
+   resource