[Checkins] SVN: bluebream/website/docs/v1.0/howto/defaultview.rst Convert footenotes to normal notes
Baiju M
baiju.m.mail at gmail.com
Sun Feb 21 09:09:47 EST 2010
Log message for revision 109214:
Convert footenotes to normal notes
Changed:
U bluebream/website/docs/v1.0/howto/defaultview.rst
-=-
Modified: bluebream/website/docs/v1.0/howto/defaultview.rst
===================================================================
--- bluebream/website/docs/v1.0/howto/defaultview.rst 2010-02-21 13:37:30 UTC (rev 109213)
+++ bluebream/website/docs/v1.0/howto/defaultview.rst 2010-02-21 14:09:46 UTC (rev 109214)
@@ -11,18 +11,30 @@
In BlueBream, a browser view can be accessed using ``@@`` symbols
before the view name. For example, if you have registered a view
-named ``testview`` for a container object [#container_object]_ named
-``myobject``, that view can be accessed like this:
-``myobject/@@testview``.
+named ``testview`` for a container object named ``myobject``, that
+view can be accessed like this: ``myobject/@@testview``.
+.. note::
+
+ Container object -- Any object implementing
+ ``zope.content.interfaces.IContainer`` interface is called a
+ content object.
+
The view could be accessed without using the ``@@`` symbols also,
-provided there is no content object [#content_object]_ with the same
-same exist inside the container. In the above example, If there is
-no content object named ``testview`` inside ``myobject`` container,
-then, the view can be accessed like ``myobject/testview``. However,
-BlueBream recommend, always to use ``@@`` symbols to access view to
-avoid ambiguity.
+provided there is no content object with the same same exist inside
+the container. In the above example, If there is no content object
+named ``testview`` inside ``myobject`` container, then, the view can
+be accessed like ``myobject/testview``. However, BlueBream
+recommend, always to use ``@@`` symbols to access view to avoid
+ambiguity.
+.. note::
+
+ Content Object -- If an **interface** provides
+ ``zope.app.content.interfaces.IContentType`` interface type, then
+ all objects providing the **interface** are considered content
+ objects.
+
In BlueBream, ``index`` is registered as the view name for
``zope.container.interfaces.IContainer`` interface. So, if you try
to access any container object without specifying any view name,
@@ -30,20 +42,31 @@
``index``.
You can configure the name of default view for a particular type of
-object [#type_of_object]_ with ``browser:defaultView`` directive
-available in ``zope.publisher`` package [#access_directive]_. If the
-name of default view is not configured, and when you try to access an
-object without specifying the view name, you will get a
-``ComponentLookupError`` with a message like this: ``Couldn't find
-default view name``. For example, if you try to access the root
-folder like: htt://localhost:8080/ and name of default view is not
-configured, you will get an error like this::
+object with ``browser:defaultView`` directive available in
+``zope.publisher`` package. If the name of default view is not
+configured, and when you try to access an object without specifying
+the view name, you will get a ``ComponentLookupError`` with a message
+like this: ``Couldn't find default view name``. For example, if you
+try to access the root folder like: htt://localhost:8080/ and name of
+default view is not configured, you will get an error like this::
ComponentLookupError: ("Couldn't find default view name",
<zope.site.folder.Folder object at 0xa3a09ac>,
<zope.publisher.browser.BrowserRequest instance
URL=http://localhost:8080>)
+.. note::
+
+ In order to use any ZCML except few built-ins like ``configure``
+ and ``include``, you include the ZCML where it is defined the
+ directive, conventionally in BlueBream it will be inside
+ ``meta.zcml`` for any package. For example, to use
+ ``defaultView`` directive, you need to include ``meta.zcml`` file
+ inside ``zope.publisher``::
+
+ <include package="zope.publisher" file="meta.zcml" />
+
+
If you have created the application using the ``bluebream`` project
template, you won't get this error. Because there is already a a
default view name (``index``) is configured in ``application.zcml``
@@ -82,28 +105,6 @@
More details about registering a browser view using ``browser:page``
directive is explained in :ref:`man-browser-page` manual.
-.. rubric:: Footnotes
-
-.. [#container_object] Container object -- Any object implementing
- ``zope.content.interfaces.IContainer`` interface is called a
- content object.
-
-.. [#content_object] Content Object -- If an **interface** provides
- ``zope.app.content.interfaces.IContentType`` interface type, then
- all objects providing the **interface** are considered content
- objects.
-
-.. [#type_of_object] To specify a particular type of object, BlueBream use interface.
-
-.. [#access_directive] In order to use any ZCML except few built-ins
- like ``configure`` and ``include``, you include the ZCML where it
- is defined the directive, conventionally in BlueBream it will be
- inside ``meta.zcml`` for any package. For example, to use
- ``defaultView`` directive, you need to include ``meta.zcml`` file
- inside ``zope.publisher``::
-
- <include package="zope.publisher" file="meta.zcml" />
-
.. raw:: html
<div id="disqus_thread"></div><script type="text/javascript"
More information about the checkins
mailing list