summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorSteve Piercy <web@stevepiercy.com>2018-11-25 01:36:54 -0800
committerSteve Piercy <web@stevepiercy.com>2018-11-25 01:36:54 -0800
commitb4c32b1763e53d5fba939f6abd0111c81561a3c7 (patch)
treef4ea3c43febe74c9b592a7cf2e0671a901a045e9 /docs
parent07c5639c50814320e572d1bb478854bc4fcd33cc (diff)
downloadpyramid-b4c32b1763e53d5fba939f6abd0111c81561a3c7.tar.gz
pyramid-b4c32b1763e53d5fba939f6abd0111c81561a3c7.tar.bz2
pyramid-b4c32b1763e53d5fba939f6abd0111c81561a3c7.zip
Rewrap edit_page view section
Diffstat (limited to 'docs')
-rw-r--r--docs/tutorials/wiki/definingviews.rst40
1 files changed, 15 insertions, 25 deletions
diff --git a/docs/tutorials/wiki/definingviews.rst b/docs/tutorials/wiki/definingviews.rst
index 8d291a5e7..164bc4326 100644
--- a/docs/tutorials/wiki/definingviews.rst
+++ b/docs/tutorials/wiki/definingviews.rst
@@ -235,31 +235,21 @@ Here is the code for the ``edit_page`` view function and its decorator:
:lineno-match:
:language: python
-The ``edit_page`` function is configured to respond when the context is
-a ``Page`` resource and the :term:`view name` is ``edit_page``. We provide it
-with a ``@view_config`` decorator which names the string ``edit_page`` as its
-:term:`view name` (via ``name=``), the class ``tutorial.models.Page`` as its
-context, and the renderer named ``templates/edit.pt``. This means that when
-a ``Page`` resource is the context, and a :term:`view name` exists as the result
-of traversal named ``edit_page``, this view will be used. We inform
-:app:`Pyramid` this view will use the ``templates/edit.pt`` template file as
-a ``renderer``.
-
-The ``edit_page`` function will be invoked when a user clicks the "Edit this
-Page" button on the view form. It renders an edit form but it also acts as
-the form post view callable for the form it renders. The ``context`` of the
-``edit_page`` view will *always* be a ``Page`` resource (never a ``Wiki`` resource).
-
-If the view execution is *not* a result of a form submission (if the
-expression ``'form.submitted' in request.params`` is ``False``), the view
-simply renders the edit form, passing the page resource, and a ``save_url``
-which will be used as the action of the generated form.
-
-If the view execution *is* a result of a form submission (if the expression
-``'form.submitted' in request.params`` is ``True``), the view grabs the
-``body`` element of the request parameter and sets it as the ``data``
-attribute of the page context. It then redirects to the default view of the
-context (the page), which will always be the ``view_page`` view.
+The ``edit_page`` function is configured to respond when the context is a ``Page`` resource and the :term:`view name` is ``edit_page``.
+We provide it with a ``@view_config`` decorator which names the string ``edit_page`` as its :term:`view name` (via ``name=``), the class ``tutorial.models.Page`` as its context, and the renderer named ``templates/edit.pt``.
+This means that when a ``Page`` resource is the context, and a :term:`view name` exists as the result of traversal named ``edit_page``, this view will be used.
+We inform :app:`Pyramid` this view will use the ``templates/edit.pt`` template file as a ``renderer``.
+
+The ``edit_page`` function will be invoked when a user clicks the "Edit this Page" button on the view form.
+It renders an edit form.
+It also acts as the form post view callable for the form it renders.
+The ``context`` of the ``edit_page`` view will *always* be a ``Page`` resource (never a ``Wiki`` resource).
+
+If the view execution is *not* a result of a form submission (if the expression ``'form.submitted' in request.params`` is ``False``), then the view renders the edit form, passing the page resource, and a ``save_url`` which will be used as the action of the generated form.
+
+If the view execution *is* a result of a form submission (if the expression ``'form.submitted' in request.params`` is ``True``), the view grabs the ``body`` element of the request parameter and sets it as the ``data`` attribute of the page context.
+It then redirects to the default view of the context (the page), which will always be the ``view_page`` view.
+
Adding templates
================