diff options
| author | Casey Duncan <casey.duncan@gmail.com> | 2011-01-18 23:05:54 -0700 |
|---|---|---|
| committer | Casey Duncan <casey.duncan@gmail.com> | 2011-01-18 23:05:54 -0700 |
| commit | b0240d3d5a39a504d5a5155a23a6d6a431b457ef (patch) | |
| tree | b0c3b4f5dd8a0ec1c01912bfeff769d1329a9c97 /docs/zcml/include.rst | |
| parent | 278b302270823336d770761aaac22d854e348ea6 (diff) | |
| parent | 48bccbe4ff7351d823a471005effea1afc06bb4f (diff) | |
| download | pyramid-b0240d3d5a39a504d5a5155a23a6d6a431b457ef.tar.gz pyramid-b0240d3d5a39a504d5a5155a23a6d6a431b457ef.tar.bz2 pyramid-b0240d3d5a39a504d5a5155a23a6d6a431b457ef.zip | |
Merge https://github.com/Pylons/pyramid
Diffstat (limited to 'docs/zcml/include.rst')
| -rw-r--r-- | docs/zcml/include.rst | 71 |
1 files changed, 0 insertions, 71 deletions
diff --git a/docs/zcml/include.rst b/docs/zcml/include.rst deleted file mode 100644 index f55caa07c..000000000 --- a/docs/zcml/include.rst +++ /dev/null @@ -1,71 +0,0 @@ -.. _include_directive: - -``include`` ------------ - -The ``include`` directive includes configuration from an external ZCML -file. Use of the ``include`` tag allows a user to split configuration -across multiple ZCML files, and allows package distributors to provide -default ZCML configuration for specific purposes which can be -included by the integrator of the package as necessary. - -Attributes -~~~~~~~~~~ - -``package`` - A :term:`dotted Python name` which references a Python :term:`package`. - -``file`` - An absolute or relative filename which references a ZCML file. - -The ``package`` and ``file`` attributes can be used together or -separately as necessary. - -Examples -~~~~~~~~ - -.. topic:: Loading the File Named ``configure.zcml`` from a Package Implicitly - - .. code-block:: xml - :linenos: - - <include package="some.package" /> - -.. topic:: Loading the File Named ``other.zcml`` From the Current Package - - .. code-block:: xml - :linenos: - - <include file="other.zcml" /> - -.. topic:: Loading a File From a Subdirectory of the Current Package - - .. code-block:: xml - :linenos: - - <include file="subdir/other.zcml" /> - -.. topic:: Loading the File Named ``/absolute/path/other.zcml`` - - .. code-block:: xml - :linenos: - - <include file="/absolute/path/other.zcml" /> - -.. topic:: Loading the File Named ``other.zcml`` From a Package Explicitly - - .. code-block:: xml - :linenos: - - <include package="some.package" file="other.zcml" /> - -Alternatives -~~~~~~~~~~~~ - -None. - -See Also -~~~~~~~~ - -See also :ref:`helloworld_declarative`. - |