From 878328bdfc3b5ac832f1728e4a0461e3129cf8d4 Mon Sep 17 00:00:00 2001 From: Chris McDonough Date: Sun, 27 Dec 2009 03:46:22 +0000 Subject: Latex rendering. Documentation licensing. --- docs/narr/configuration.rst | 93 +++++++++++++++++++++------------------------ 1 file changed, 44 insertions(+), 49 deletions(-) (limited to 'docs/narr/configuration.rst') diff --git a/docs/narr/configuration.rst b/docs/narr/configuration.rst index 049be2ca3..73027e4c2 100644 --- a/docs/narr/configuration.rst +++ b/docs/narr/configuration.rst @@ -204,8 +204,8 @@ fragments, for example the ``/a/b/c`` portion of the URL traversal. .. note:: A useful analogy of how :mod:`repoze.bfg` :term:`traversal` - works is available within the section entitled - :ref:`traversal_behavior`. You should probably go read it now. + works is available within the chapter section entitled + :ref:`traversal_behavior`. The results of a :term:`traversal` include a :term:`context` and a :term:`view name`. The :term:`view name` is the *first* URL path @@ -235,8 +235,6 @@ The object graph of our hello world application is very simple: there's exactly one object in our graph; the default :term:`root` object. -Apologies for the digression; on with the tutorial. - Relating Traversal to the Hello World Application ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -328,7 +326,6 @@ Beginning Configuration .. ignore-next-block .. code-block:: python - :linenos: config.begin() @@ -449,7 +446,6 @@ Ending Configuration .. ignore-next-block .. code-block:: python - :linenos: config.end() @@ -467,7 +463,6 @@ WSGI Application Creation .. ignore-next-block .. code-block:: python - :linenos: app = config.make_wsgi_app() @@ -499,7 +494,6 @@ WSGI Application Serving .. ignore-next-block .. code-block:: python - :linenos: serve(app) @@ -580,20 +574,20 @@ previously created ``helloworld.py``: .. code-block:: xml :linenos: - + - + - + - + - + This pair of files forms an application functionally equivalent to the application we created earlier. Let's examine the differences between @@ -641,7 +635,7 @@ which sits next to ``helloworld.py``. Let's take a look at the .. code-block:: xml :linenos: - + @@ -654,7 +648,7 @@ which sits next to ``helloworld.py``. Let's take a look at the view="helloworld.goodbye_world" /> - + The ```` Tag ~~~~~~~~~~~~~~~~~~~~~~~ @@ -665,7 +659,9 @@ The ``configure.zcml`` ZCML file contains this bit of XML: :linenos: + + Because :term:`ZCML` is XML, and because XML requires a single root @@ -683,9 +679,8 @@ The ``configure.zcml`` ZCML file contains this bit of XML within the ```` root tag: .. code-block:: xml - :linenos: - + This singleton (self-closing) tag instructs ZCML to load a ZCML file from the Python package with the :term:`dotted Python name` @@ -705,8 +700,8 @@ equivalently as: .. code-block:: xml :linenos: - + The ```` tag that includes the ZCML statements implied by the ``configure.zcml`` file from the Python package named @@ -729,14 +724,14 @@ The ``configure.zcml`` ZCML file contains these bits of XML *after* the .. code-block:: xml :linenos: - + - + These ```` declaration tags direct :mod:`repoze.bfg` to create two :term:`view configuration` registrations. The first ```` @@ -780,28 +775,28 @@ following ZCML orderings are completely equivalent: .. code-block:: xml :linenos: - + - + .. topic:: Goodbye Before Hello .. code-block:: xml :linenos: - + - + The ```` tag is an example of a :mod:`repoze.bfg` declaration tag. Other such tags include ````, ````, ````, @@ -826,12 +821,12 @@ start. For example, the following ZCML file has two conflicting + view="helloworld.hello_world" + /> + view="helloworld.hello_world" + /> -- cgit v1.2.3