cocoon-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject cvs commit: xml-cocoon2/src/documentation/xdocs/faq faq-transformers.xml
Date Fri, 21 Jun 2002 22:55:21 GMT
shannon     2002/06/21 15:55:21

  Modified:    src/documentation/xdocs/faq Tag: cocoon_2_0_3_branch
  Added new FAQ on the differences between
  the XInclude and CInclude Transformers
  with feedback from Vadim.
  Revision  Changes    Path
  No                   revision
  No                   revision   +38 -0     xml-cocoon2/src/documentation/xdocs/faq/faq-transformers.xml
  Index: faq-transformers.xml
  RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/faq/faq-transformers.xml,v
  retrieving revision
  retrieving revision
  diff -u -r1.1.2.1 -r1.1.2.2
  --- faq-transformers.xml	7 Jun 2002 19:45:13 -0000
  +++ faq-transformers.xml	21 Jun 2002 22:55:21 -0000
  @@ -22,6 +22,44 @@
  + <question>
  +  What are the similarities and differences of XInclude and CInclude Transformers?
  + </question>
  + <answer>
  +  <p>
  +The XInclude and CInclude transformers both provide mechanisms to include content from
other documents. Both also support cocoon:/ protocol (i.e. they use Cocoon's resolver).
  +  </p>
  +  <p>
  +XIncludeTransformer differences
  +  </p>
  +  <ul>
  +    <li>Implements the W3C XInclude specification.</li>
  +    <li>Allows you to include text or xml content (via parse="text|xml").</li>
  +    <li>Allows you to use xpointer syntax (via '#' or xpointer() syntax) within href
  +    <li>Has only one implementation, XIncludeTransformer, which is <strong>not</strong>
  +  </ul>
  +  <p>
  +CIncludeTransformer differences
  +  </p>
  +  <ul>
  +    <li>Helps you serve documents with inclusions and tags in xinclude namespace.

  +    This means that if a document (with both xinclude <em>and</em> cinclude
tags) is processed 
  +    by the CIncludeTransformer, its xinclude tags will remain intact.</li>
  +    <li>Gives you the option to specify the element, namespace, and prefix for the
  +    included content (e.g. element="wrapper_element" ns="wrapper_ns" prefix="wrapper_prefix")</li>
  +    <li>Has two implementations: (1) a cacheable implementation, CachingCIncludeTransformer,
and (2) a non-cacheable implementation, CIncludeTransformer, (used in Cocoon samples).</li>
  +  </ul>
  +  <p>
  +Consult the user documentation for more information about the <link href="../userdocs/transformers/xinclude-transformer.html">XIncludeTransformer</link>
and <link href="../userdocs/transformers/cinclude-transformer.html">CIncludeTransformer</link>.
Please note that an IncludeTransformer, with support for both cinclude and xinclude as well
as a configurable namespace, is planned for a future release.
  +  </p>

In case of troubles, e-mail:
To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message