webhelp.tree.cookie.id.xml 2.2 KB

1234567891011121314151617181920212223242526272829303132333435363738
  1. <refentry xmlns="http://docbook.org/ns/docbook"
  2. xmlns:xlink="http://www.w3.org/1999/xlink"
  3. xmlns:xi="http://www.w3.org/2001/XInclude"
  4. xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"
  5. xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
  6. version="5.0" xml:id="webhelp.tree.cookie.id">
  7. <refmeta>
  8. <refentrytitle>webhelp.tree.cookie.id</refentrytitle>
  9. <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
  10. </refmeta>
  11. <refnamediv>
  12. <refname>webhelp.tree.cookie.id</refname>
  13. <refpurpose>Controls how the cookie that stores the webhelp toc state is named.</refpurpose>
  14. </refnamediv>
  15. <refsynopsisdiv>
  16. <src:fragment xml:id="webhelp.tree.cookie.id.frag">
  17. <xsl:param name="webhelp.tree.cookie.id" select="concat( 'treeview-', count(//node()) )"/>
  18. </src:fragment>
  19. </refsynopsisdiv>
  20. <refsection><info><title>Description</title></info>
  21. <para>The webhelp output does not use a frameset. Instead, the table of contents is a div on each page. To preserve the state of the table of contents as the user navigates from page to page, webhelp stores the state in a cookie and reads that cookie when you get to the next page. If you've published several webhelp documents on the same domain, it is important that each cookie have a unique id. In lieu of calling on a GUID generator, by default this parameter is just set to the number of nodes in the document on the assumption that it is unlikely that you will have more than one document with the exact number of nodes. A more optimal solution would be for the user to pass in some unique, stable identifier from the build system to use as the webhelp cookie id. For example, if you have safeguards in place to ensure that the xml:id of the root element of each document will be unique on your site, then you could set webhelptree.cookie.id as follows:
  22. <programlisting><![CDATA[
  23. <xsl:param name="webhelp.tree.cookie.id">
  24. <xsl:choose>
  25. <xsl:when test="/*/@xml:id">
  26. <xsl:value-of select="concat('treeview-',/*/@xml:id)"/>
  27. </xsl:when>
  28. <xsl:otherwise>
  29. <xsl:value-of select="concat( 'treeview-', count(//node()) )"/>
  30. </xsl:otherwise>
  31. </xsl:choose>
  32. </xsl:param>]]>
  33. </programlisting>
  34. </para>
  35. </refsection>
  36. </refentry>