From c03dbcca24aeedfb688bf49b7ccfeef20f6f8298 Mon Sep 17 00:00:00 2001 From: Chris McDonough Date: Mon, 25 Oct 2010 18:13:44 -0400 Subject: convert zcml docs to Pyramid --- docs/zcml/configure.rst | 38 +++++++++++++++++++------------------- 1 file changed, 19 insertions(+), 19 deletions(-) (limited to 'docs/zcml/configure.rst') diff --git a/docs/zcml/configure.rst b/docs/zcml/configure.rst index 7b479b2c0..db8219a2d 100644 --- a/docs/zcml/configure.rst +++ b/docs/zcml/configure.rst @@ -4,7 +4,7 @@ ------------- Because :term:`ZCML` is XML, and because XML requires a single root -tag for each document, every ZCML file used by :mod:`repoze.bfg` must +tag for each document, every ZCML file used by :mod:`pyramid` must contain a ``configure`` container directive, which acts as the root XML tag. It is a "container" directive because its only job is to contain other directives. @@ -21,7 +21,7 @@ Example .. code-block:: xml :linenos: - + @@ -34,17 +34,17 @@ A Word On XML Namespaces Usually, the start tag of the ```` container tag has a default *XML namespace* associated with it. This is usually -``http://namespaces.repoze.org/bfg``, named by the ``xmlns`` attribute -of the ``configure`` start tag. - -Using the ``http://namespaces.repoze.org/bfg`` namespace as the -default XML namespace isn't strictly necessary; you can use a -different default namespace as the default. However, if you do, the -declaration tags which are defined by :mod:`repoze.bfg` such as the -``view`` declaration tag will need to be defined in such a way that -the XML parser that :mod:`repoze.bfg` uses knows which namespace the -:mod:`repoze.bfg` tags are associated with. For example, the -following files are all completely equivalent: +``http://pylonshq.com/pyramid``, named by the ``xmlns`` attribute of +the ``configure`` start tag. + +Using the ``http://pylonshq.com/pyramid`` namespace as the default XML +namespace isn't strictly necessary; you can use a different default +namespace as the default. However, if you do, the declaration tags +which are defined by :mod:`pyramid` such as the ``view`` declaration +tag will need to be defined in such a way that the XML parser that +:mod:`pyramid` uses knows which namespace the :mod:`pyramid` tags are +associated with. For example, the following files are all completely +equivalent: .. topic:: Use of A Non-Default XML Namespace @@ -52,11 +52,11 @@ following files are all completely equivalent: :linenos: + xmlns:pyramid="http://pylonshq.com/pyramid"> - + - @@ -69,9 +69,9 @@ following files are all completely equivalent: - + - @@ -81,7 +81,7 @@ For more information about XML namespaces, see `this older, but simple XML.com article `_. The conventions in this document assume that the default XML namespace -is ``http://namespaces.repoze.org/bfg``. +is ``http://pylonshq.com/pyramid``. Alternatives ~~~~~~~~~~~~ -- cgit v1.2.3