Changeset 6115

Timestamp:

01/20/12 18:18:45 (4 months ago)

Author:

mtld

Message:

updated docs

Location:

trunk/pustefix-docbook/src/docbkx/reference

Files:

• news.xml (modified) (1 diff)
• xslt.xml (modified) (2 diffs)

trunk/pustefix-docbook/src/docbkx/reference/news.xml

@@ -149 +149 @@
   </section>
 
+  <section xml:id="news.0_18_5">
+    <title>What's new in Pustefix 0.18.5</title>
+
+    <section xml:id="news.0_18_5.cmis">
+      <title>CMIS support</title>
+      <para>
+        Added basic support for loading resources from content management systems using CMIS/AtomPub. 
+      </para>
+    </section>
+   <section xml:id="news.0_18_5.pagealiases">
+      <title>Page aliases</title>
+      <para>
+        Added XPath function to get current display page name during rendering (see <xref linkend="xslt.extensions.xpathfunctions.getdisplaypagename"/>).
+      </para>
+    </section>
+
+  </section>
+
+  <section xml:id="news.0_18_6">
+    <title>What's new in Pustefix 0.18.6</title>
+
+    <section xml:id="news.0_18_.xslt">
+      <title>Include part existence check</title>
+      <para>
+        Pustefix added support for checking the existence of an include part during rendering, e.g. for displaying an include part depending on the existence of another include part (see <xref linkend="xslt.pfx.checkinclude"/>).
+      </para>
+    </section>
+
+  </section>
+
 </chapter>

trunk/pustefix-docbook/src/docbkx/reference/xslt.xml

@@ -788 +788 @@
 </script>]]></programlisting>
     </section>
-
+    <section xml:id="xslt.pfx.checkinclude">
+      <title>Checking include part existence (&lt;pfx:checkinclude&gt;)</title>
+      <para>
+        The <literal>&lt;pfx:checkinclude&gt;</literal> and <literal>&lt;pfx:checknoinclude&gt;</literal> tags can be used to display content
+        depending on the existence of an include part.
+      </para>
+<programlisting language="xml"><![CDATA[<pfx:checkinclude part="foo" href="txt/afile.xml">
+  Display if part exists
+</pfx:checkinclude>
+
+<pfx:checknoinclude part="bar" href="txt/afile.xml">
+  Display if part not exists
+</pfx:checknoinclude
+
+<pfx:checkinclude href="txt/afile.xml" module="amodule" search="dynamic" level="runtime">
+  <pfx:part><ixsl:value-of select="/formresult/displaypart/@name"/></pfx:part>
+  Display if part exists
+</pfx:checkinclude>
+]]></programlisting>
+      <para>Supported attributes and usage comply with the <literal>&lt;pfx:include&gt;</literal> element (see <xref linkend="xslt.pfx.include"/>).</para>
+    </section>
   </section>
 
@@ -1798 +1818 @@
         </para>
      </note>
+    <para xml:id="xslt.extensions.xpathfunctions.getdisplaypagename">
+      <emphasis role="strong">Function:</emphasis> <emphasis>string</emphasis> <emphasis role="strong">pfx:getDisplayPageName</emphasis>()
+    </para>
+    <para>
+       The <emphasis role="strong">pfx:getDisplayPageName</emphasis> function returns the display name of the current page.
+    </para>
+     <para></para>
+     <para>
+      <emphasis role="strong">Function:</emphasis> <emphasis>boolean</emphasis> <emphasis role="strong">pfx:checkInclude</emphasis>(<emphasis>string, string, string, string</emphasis>)
+    </para>
+    <para>
+       The <emphasis role="strong">pfx:checkInclude</emphasis> function checks if an include part exists. The function expects four string arguments: href, part, module, search (same semantics as <xref linkend="xslt.pfx.checkinclude"/>).
+      The function returns:
+      <itemizedlist>
+          <listitem><literal>true</literal>, if the include part can be found</listitem>
+          <listitem><literal>false</literal>, if the include part can't be found</listitem>
+      </itemizedlist>
+    </para>
   </section>
   </section>