cubicweb: comparison doc/book/en/A02a-create-cube.en.txt

equal deleted inserted replaced

-:4a8c5f8ddff5
+:905d76e38433
 :alt: graphical view of the schema (aka data-model)
 .. _DefineViews:
-Define your entities views
+Define your entity views
---------------------------
+------------------------
-Each entity defined in a model inherits defaults views allowing
+Each entity defined in a model inherits default views allowing
 different rendering of the data. You can redefine each of them
-according to your needs and preferences. If you feel like it then
+according to your needs and preferences. So let's see how the
-you have to know how a view is defined.
+views are defined.
-The views selection principle
+The view selection principle
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 A view is defined by a Python class which includes:
 - an identifier (all objects in `CubicWeb` are entered in a registry
 and this identifier will be used as a key)
-- a filter to select the resulsets it can be applied to
+- a filter to select the result sets it can be applied to
 A view has a set of methods complying
 with the `View` class interface (`cubicweb.common.view`).
-`CubicWeb` provides a lot of standard views for the type
+`CubicWeb` provides a lot of standard views for the type `EntityView`;
-`EntityView`, for a complete list, you
+for a complete list, read the code in directory ``cubicweb/web/views/``.
-will have to read the code in directory ``cubicweb/web/views/``
 A view is applied on a `result set` which contains a set of
 entities we are trying to display. `CubicWeb` uses a selector
-mechanism which computes a score used to identify which view
+mechanism which computes for each available view a score:
-is the best to apply for the `result set` we are trying to
+the view with the highest score is then used to display the given `result set`.
-display. The standard library of selectors is in
+The standard library of selectors is in
 ``cubicweb.common.selector`` and a library of methods used to
 compute scores is available in ``cubicweb.vregistry.vreq``.
 It is possible to define multiple views for the same identifier
 and to associate selectors and filters to allow the application
 to find the best way to render the data. We will see more details
-on this in :ref:`DefinitionVues`.
+on this in :ref:`ViewDefinition`.
 For example, the view named ``primary`` is the one used to display
-a single entity. We will now show you hos to customize this view.
+a single entity. We will now show you how to customize this view.
 View customization
 ~~~~~~~~~~~~~~~~~~
 If you wish to modify the way a `BlogEntry` is rendered, you will have to
 overwrite the `primary` view defined in the module ``views`` of the cube
 ``cubes/blog/views.py``.
-We can for example add in front of the pulication date a prefix specifying
+We can for example add in front of the publication date a prefix specifying
-the date we see is the publication date.
+that the date we see is the publication date.
 To do so, please apply the following changes:
 ::
 .. image:: images/cbw-update-primary-view.en.png
 :alt: modified primary view
-The above source code defines a new primary view for
+The above source code defines a new primary view for ``BlogEntry``.
-``BlogEntry``.
+Since views are applied to result sets and result sets can be tables of
-Since views are applied to resultsets and resulsets can be tables of
+data, we have to recover the entity from its (row,col)-coordinates.
-data, it is needed to recover the entity from its (row,col)
+We will get to this in more detail later.
-coordinates. We will get to this in more detail later.
 The view has a ``self.w()`` method that is used to output data. In our
 example we use it to output HTML tags and values of the entity's attributes.

changeset 1249	905d76e38433
parent 296	65564e83853e
child 1253	9716a9f77980