shannon 2002/06/21 15:55:21
Modified: src/documentation/xdocs/faq Tag: cocoon_2_0_3_branch
faq-transformers.xml
Log:
Added new FAQ on the differences between
the XInclude and CInclude Transformers
with feedback from Vadim.
Revision Changes Path
No revision
No revision
1.1.2.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.2.1
retrieving revision 1.1.2.2
diff -u -r1.1.2.1 -r1.1.2.2
--- faq-transformers.xml 7 Jun 2002 19:45:13 -0000 1.1.2.1
+++ faq-transformers.xml 21 Jun 2002 22:55:21 -0000 1.1.2.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: [EMAIL PROTECTED]
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
