<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>textinsert.extension</title><link rel="stylesheet" type="text/css" href="../reference.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="../index.html" title="DocBook XSL Stylesheets: Reference Documentation"><link rel="up" href="dbk_ext.html" title="Stylesheet Extensions"><link rel="prev" href="tablecolumns.extension.html" title="tablecolumns.extension"><link rel="next" href="textdata.default.encoding.html" title="textdata.default.encoding"><link rel="copyright" href="copyright.html" title="License"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">textinsert.extension</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="tablecolumns.extension.html">Prev</a> </td><th width="60%" align="center">Stylesheet Extensions</th><td width="20%" align="right"> <a accesskey="n" href="textdata.default.encoding.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="textinsert.extension"></a><div class="titlepage"></div> <div class="refnamediv"><h2><span class="refentrytitle">textinsert.extension</span></h2><p> textinsert.extension — Enables the textinsert extension element </p></div> <div class="refsynopsisdiv"><h2>Synopsis</h2> <a name="textinsert.extension.frag"></a><pre class="programlisting"> <xsl:param name="textinsert.extension" select="1"></xsl:param> </pre> </div> <div class="refsection"><a name="idp3860112"></a><h2>Description</h2> <p>The textinsert extension element inserts the contents of a file into the result tree (as text).</p> <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3> <p>To use the textinsert extension element, you must use either Saxon or Xalan as your XSLT processor (it doesn’t work with xsltproc), along with either the DocBook Saxon extensions or DocBook Xalan extensions (for more information about those extensions, see <a href="http://www.sagehill.net/docbookxsl/">DocBook XSL: TCG</a>, <a class="ulink" href="http://www.sagehill.net/docbookxsl/InstallingAProcessor.html#SaxonExtensions" target="_top">DocBook Saxon Extensions</a> and <a href="http://www.sagehill.net/docbookxsl/">DocBook XSL: TCG</a>, <a class="ulink" href="http://www.sagehill.net/docbookxsl/InstallingAProcessor.html#XalanExtensions" target="_top">DocBook Xalan Extensions</a>), and you must set both the <a href="../html/use.extensions.html"><em class="parameter"><code>use.extensions</code></em></a> and <a href="../html/textinsert.extension.html"><em class="parameter"><code>textinsert.extension</code></em></a> parameters to <code class="literal">1</code>.</p> <p>As an alternative to using the textinsert element, consider using an Xinclude element with the <code class="literal">parse="text"</code> attribute and value specified, as detailed in <a href="http://www.sagehill.net/docbookxsl/">DocBook XSL: TCG</a>, <a class="ulink" href="http://www.sagehill.net/docbookxsl/ExternalCode.html#XIncludeCode" target="_top">Using XInclude for text inclusions</a>.</p> </div> </div> <div class="refsection"><a name="idp3868144"></a><h2>See Also</h2> <p>You can also use the <a href="../pi/dbhtml-include_href.html"><code class="sgmltag-xmlpi"><?dbhtml-include href?></code></a> processing instruction to insert external files — both files containing plain text and files with markup content (including HTML content).</p> </div> <div class="refsection"><a name="idp3870592"></a><h2>More information</h2> <p>For how-to documentation on inserting contents of external code files and other text files into output, see <a href="http://www.sagehill.net/docbookxsl/">DocBook XSL: TCG</a>, <a class="ulink" href="http://www.sagehill.net/docbookxsl/ExternalCode.html" target="_top">External code files</a>.</p> <p>For guidelines on inserting contents of HTML files into output, see <a href="http://www.sagehill.net/docbookxsl/">DocBook XSL: TCG</a>, <a class="ulink" href="http://www.sagehill.net/docbookxsl/InsertExtHtml.html" target="_top">Inserting external HTML code</a>.</p> </div> </div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="tablecolumns.extension.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="dbk_ext.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="textdata.default.encoding.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">tablecolumns.extension </td><td width="20%" align="center"><a accesskey="h" href="../index.html">Home</a></td><td width="40%" align="right" valign="top"> textdata.default.encoding</td></tr></table></div></body></html>