You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@cocoon.apache.org by sh...@apache.org on 2002/06/22 00:52:10 UTC
cvs commit: xml-cocoon2/src/documentation/xdocs/faq faq-transformers.xml
shannon 2002/06/21 15:52:10
Modified: src/documentation/xdocs/faq faq-transformers.xml
Log:
Added new faq regarding the differences
between XInclude and CInclude Transformers
with feedback from Vadim.
Revision Changes Path
1.2 +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 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- faq-transformers.xml 30 May 2002 17:34:18 -0000 1.1
+++ faq-transformers.xml 21 Jun 2002 22:52:10 -0000 1.2
@@ -22,6 +22,44 @@
</faq>
+<faq>
+ <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 attribute.</li>
+ <li>Has only one implementation, XIncludeTransformer, which is <strong>not</strong> cacheable.</li>
+ </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>
+</answer>
+
+</faq>
+
+
----------------------------------------------------------------------
In case of troubles, e-mail: webmaster@xml.apache.org
To unsubscribe, e-mail: cocoon-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: cocoon-cvs-help@xml.apache.org