chunked.filename.prefix.xml 1.6 KB

1234567891011121314151617181920212223242526272829303132333435363738394041
  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="chunked.filename.prefix">
  7. <refmeta>
  8. <refentrytitle>chunked.filename.prefix</refentrytitle>
  9. <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
  10. </refmeta>
  11. <refnamediv>
  12. <refname>chunked.filename.prefix</refname>
  13. <refpurpose>Filename prefix for chunked files</refpurpose>
  14. </refnamediv>
  15. <refsynopsisdiv>
  16. <src:fragment xml:id="chunked.filename.prefix.frag">
  17. <xsl:param name="chunked.filename.prefix"></xsl:param>
  18. </src:fragment>
  19. </refsynopsisdiv>
  20. <refsection><info><title>Description</title></info>
  21. <para>If specified, the <parameter>chunked.filename.prefix</parameter>
  22. parameter specifies a prefix string to add to each generated chunk filename.
  23. For example:</para>
  24. <programlisting>&lt;xsl:param name="chunked.filename.prefix"&gt;admin-&lt;xsl:param&gt;</programlisting>
  25. <para>will produce chunked filenames like:</para>
  26. <programlisting>admin-index.html
  27. admin-ch01.html
  28. admin-ch01s01.html
  29. ...
  30. </programlisting>
  31. <caution><para>Trying to use the <parameter>base.dir</parameter>
  32. parameter to add a string prefix (by omitting the trailing slash)
  33. no longer works (it never worked completely anyway). That parameter
  34. value should contain only a directory path, and
  35. now gets a trailing slash appended if it was omitted from the param.</para></caution>
  36. </refsection>
  37. </refentry>