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: [EMAIL PROTECTED] To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
