rootid.xml 1.2 KB

123456789101112131415161718192021222324252627282930313233
  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="rootid">
  7. <refmeta>
  8. <refentrytitle>rootid</refentrytitle>
  9. <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
  10. </refmeta>
  11. <refnamediv>
  12. <refname>rootid</refname>
  13. <refpurpose>Specify the root element to format</refpurpose>
  14. </refnamediv>
  15. <refsynopsisdiv>
  16. <src:fragment xml:id="rootid.frag">
  17. <xsl:param name="rootid" ></xsl:param></src:fragment>
  18. </refsynopsisdiv>
  19. <refsection><info><title>Description</title></info>
  20. <para>If <parameter>rootid</parameter> is not empty, it must be the
  21. value of an ID that occurs in the document being formatted. The entire
  22. document will be loaded and parsed, but formatting will begin at the
  23. element identified, rather than at the root. For example, this allows
  24. you to process only <tag>chapter</tag> 4 of a <tag>book</tag>.</para>
  25. <para>Because the entire document is available to the processor, automatic
  26. numbering, cross references, and other dependencies are correctly
  27. resolved.</para>
  28. </refsection>
  29. </refentry>