stylesheets/evergreen_docbook_files/docbook-xsl-1.75.2/params/textinsert.extension.xml

   1 <refentry xmlns="http://docbook.org/ns/docbook"\r
   2   xmlns:xlink="http://www.w3.org/1999/xlink"\r
   3   xmlns:xi="http://www.w3.org/2001/XInclude"\r
   4   xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"\r
   5   xmlns:xsl="http://www.w3.org/1999/XSL/Transform"\r
   6   version="5.0" xml:id="textinsert.extension">\r
   7   <refmeta>\r
   8     <refentrytitle>textinsert.extension</refentrytitle>\r
   9     <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
  10   </refmeta>\r
  11   <refnamediv>\r
  12     <refname>textinsert.extension</refname>\r
  13     <refpurpose>Enables the textinsert extension element</refpurpose>\r
  14   </refnamediv>\r
  15   <refsynopsisdiv>\r
  16     <src:fragment xml:id="textinsert.extension.frag">\r
  17   <xsl:param name="textinsert.extension" select="1"/>\r
  18 </src:fragment>\r
  19   </refsynopsisdiv>\r
  20   <refsection><info><title>Description</title></info>\r
  21     <para>The textinsert extension element inserts the contents of\r
  22       a file into the result tree (as text).</para>\r
  23     <note>\r
  24       <para>To use the textinsert extension element, you must use\r
  25         either Saxon or Xalan as your XSLT processor (it doesn’t\r
  26         work with xsltproc), along with either the DocBook Saxon\r
  27         extensions or DocBook Xalan extensions (for more\r
  28         information about those extensions, see <link\r
  29           role="tcg" xlink:href="InstallingAProcessor.html#SaxonExtensions"\r
  30           >DocBook Saxon Extensions</link> and <link\r
  31           role="tcg" xlink:href="InstallingAProcessor.html#XalanExtensions"\r
  32           >DocBook Xalan Extensions</link>), and you must set both\r
  33         the <parameter>use.extensions</parameter> and\r
  34         <parameter>textinsert.extension</parameter> parameters to\r
  35         <literal>1</literal>.</para>\r
  36       <para>As an alternative to using the textinsert element,\r
  37         consider using an Xinclude element with the\r
  38         <literal>parse="text"</literal> attribute and value\r
  39         specified, as detailed in <link\r
  40           role="tcg" xlink:href="ExternalCode.html#XIncludeCode"\r
  41           >Using XInclude for text inclusions</link>.</para>\r
  42     </note>\r
  43   </refsection>\r
  44   <refsection><info><title>See Also</title></info>\r
  45     <para>You can also use the <tag\r
  46         class="xmlpi">dbhtml-include href</tag> processing\r
  47       instruction to insert external files — both files containing\r
  48       plain text and files with markup content (including HTML\r
  49       content).</para>\r
  50   </refsection>\r
  51   <refsection><info><title>More information</title></info>\r
  52     <para>For how-to documentation on inserting contents of\r
  53       external code files and other text files into output, see\r
  54       <link\r
  55         role="tcg" xlink:href="ExternalCode.html"\r
  56         >External code files</link>.</para>\r
  57     <para>For guidelines on inserting contents of\r
  58       HTML files into output, see <link\r
  59         role="tcg" xlink:href="InsertExtHtml.html"\r
  60         >Inserting external HTML code</link>.</para>\r
  61   </refsection>\r
  62 </refentry>\r