X-Git-Url: http://git.ithinksw.org/philo.git/blobdiff_plain/4edce19176898736fc4914b7eb08d907566f0547..46997a51ed0ceb16ddbac712fbcb552a86cdc9e2:/docs/models/nodes-and-views.rst diff --git a/docs/models/nodes-and-views.rst b/docs/models/nodes-and-views.rst index a9bae89..ab6dfb9 100644 --- a/docs/models/nodes-and-views.rst +++ b/docs/models/nodes-and-views.rst @@ -1,54 +1,62 @@ Nodes and Views: Building Website structure =========================================== -.. currentmodule:: philo.models -.. class:: Node +.. automodule:: philo.models.nodes - .. attribute:: view +Nodes +----- - :class:`GenericForeignKey` to a non-abstract subclass of :class:`View` +.. autoclass:: Node + :show-inheritance: + :members: + :exclude-members: attribute_set - .. attribute:: accepts_subpath +Views +----- - A property shortcut for :attr:`self.view.accepts_subpath ` +Abstract View Models +++++++++++++++++++++ - .. method:: render_to_response(request[, extra_context=None]) +.. autoclass:: View + :show-inheritance: + :members: + :exclude-members: attribute_set - This is a shortcut method for :meth:`View.render_to_response` +.. autoclass:: MultiView + :show-inheritance: + :members: + :exclude-members: attribute_set - .. method:: get_absolute_url() +Concrete View Subclasses +++++++++++++++++++++++++ - As long as :mod:`philo.urls` is included somewhere in the urlpatterns, this will return the URL of this node. The returned value will always start and end with a slash. +.. autoclass:: Redirect + :show-inheritance: + :members: + :exclude-members: attribute_set -.. class:: View +.. autoclass:: File + :show-inheritance: + :members: + :exclude-members: attribute_set - :class:`!View` is an abstract model that represents an item which can be "rendered", either in response to an :class:`HttpRequest` or as a standalone. +Pages +***** - .. attribute:: accepts_subpath +.. automodule:: philo.models.pages - Defines whether this View class can handle subpaths. +.. autoclass:: Page + :members: + :exclude-members: attribute_set + :show-inheritance: - .. attribute:: nodes +.. autoclass:: Template + :members: + :show-inheritance: + + .. seealso:: :mod:`philo.loaders.database` - A generic relation back to nodes. +.. autoclass:: Contentlet + :members: - .. method:: get_subpath(obj) - - If the view :attr:`accepts subpaths <.accepts_subpath>`, try to find a reversal for the given object using ``self`` as the urlconf. This method calls :meth:`~.get_reverse_params` with ``obj`` as the argument to find out the reversing parameters for that object. - - .. method:: get_reverse_params(obj) - - This method should return a ``view_name``, ``args``, ``kwargs`` tuple suitable for reversing a url for the given ``obj`` using ``self`` as the urlconf. - - .. method:: attributes_with_node(node) - - Returns a :class:`QuerySetMapper` using the :class:`node `'s attributes as a passthrough. - - .. method:: render_to_response(request[, extra_context=None]) - - Renders the :class:`View` as an :class:`HttpResponse`. This will raise :const:`philo.exceptions.MIDDLEWARE_NOT_CONFIGURED` if the `request` doesn't have an attached :class:`Node`. This can happen if :class:`philo.middleware.RequestNodeMiddleware` is not in :setting:`settings.MIDDLEWARE_CLASSES` or if it is not functioning correctly. - - :meth:`!render_to_response` will send the :obj:`view_about_to_render ` signal, then call :meth:`actually_render_to_response`, and finally send the :obj:`view_finished_rendering ` signal before returning the ``response``. - - .. method:: actually_render_to_response(request[, extra_context=None]) - - Concrete subclasses must override this method to provide the business logic for turning a ``request`` and ``extra_context`` into an :class:`HttpResponse`. \ No newline at end of file +.. autoclass:: ContentReference + :members: \ No newline at end of file