svn commit: r590739 - /lenya/docu/src/documentation/content/xdocs/docs/2_0_x/reference/publication/publication-templating/index.xml

[email protected]
Newsgroups gmane.comp.cms.lenya.cvs
Message-ID <[email protected]>
Author: andreas
Date: Wed Oct 31 09:46:33 2007
New Revision: 590739

URL: http://svn.apache.org/viewvc?rev=590739&view=rev
Log:
Updated docs about template-fallback protocol

Modified:
    lenya/docu/src/documentation/content/xdocs/docs/2_0_x/reference/publication/publication-templating/index.xml

Modified: lenya/docu/src/documentation/content/xdocs/docs/2_0_x/reference/publication/publication-templating/index.xml
URL: http://svn.apache.org/viewvc/lenya/docu/src/documentation/content/xdocs/docs/2_0_x/reference/publication/publication-templating/index.xml?rev=590739&r1=590738&r2=590739&view=diff
==============================================================================
--- lenya/docu/src/documentation/content/xdocs/docs/2_0_x/reference/publication/publication-templating/index.xml (original)
+++ lenya/docu/src/documentation/content/xdocs/docs/2_0_x/reference/publication/publication-templating/index.xml Wed Oct 31 09:46:33 2007
@@ -127,11 +127,17 @@
       </p>
       <source xml:space="preserve"><![CDATA[<xsl:include href="fallback://header.xsl"/>]]></source>
       <p>
-        To simplify overriding of XSLT stylesheets, it would be useful to import the template
-        stylesheet. For this purpose, an additional template source factory could be used, which
-        skips the current publication when resolving the file:
+        To simplify overriding of XSLT stylesheets, it is very useful to import the template
+        stylesheet. The template-fallback source factory skips the current publication when
+        resolving the file, i.e. it resolves the first existing ancestor file:
+      </p>
+      <source xml:space="preserve"><![CDATA[<xsl:import href="template-fallback:mypub://template/xslt/common/header.xsl"/>]]></source>
+      <p>
+        It is necessary to pass the ID of the publication which contains the importing file
+        after the protocol string because otherwise the template-fallback resolving mechanism
+        will fail. For more information, see
+        <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=40564">bug 40564</a>. 
       </p>
-      <source xml:space="preserve"><![CDATA[<xsl:import href="template://template/xslt/common/header.xsl"/>]]></source>
     </section>
     
     <section>
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.