1
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>textinsert.extension</title><link rel="stylesheet" href="reference.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><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" title="textinsert.extension"><a name="textinsert.extension"></a><div class="titlepage"></div>
1
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>textinsert.extension</title><link rel="stylesheet" type="text/css" href="../reference.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.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" title="textinsert.extension"><a name="textinsert.extension"></a><div class="titlepage"></div>
3
3
<div class="refnamediv"><h2><span class="refentrytitle">textinsert.extension</span></h2><p>
9
9
<xsl:param name="textinsert.extension" select="1"></xsl:param>
12
<div class="refsection" title="Description"><a name="id1409204"></a><h2>Description</h2>
12
<div class="refsection" title="Description"><a name="id36215800"></a><h2>Description</h2>
13
13
<p>The textinsert extension element inserts the contents of
14
14
a file into the result tree (as text).</p>
15
15
<div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3>
17
17
either Saxon or Xalan as your XSLT processor (it doesn’t
18
18
work with xsltproc), along with either the DocBook Saxon
19
19
extensions or DocBook Xalan extensions (for more
20
information about those extensions, see <a class="ulink" href="InstallingAProcessor.html#SaxonExtensions" target="_top">DocBook Saxon Extensions</a> and <a class="ulink" href="InstallingAProcessor.html#XalanExtensions" target="_top">DocBook Xalan Extensions</a>), and you must set both
20
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
21
21
the <a href="../html/use.extensions.html"><em class="parameter"><code>use.extensions</code></em></a> and
22
22
<a href="../html/textinsert.extension.html"><em class="parameter"><code>textinsert.extension</code></em></a> parameters to
23
23
<code class="literal">1</code>.</p>
24
24
<p>As an alternative to using the textinsert element,
25
25
consider using an Xinclude element with the
26
26
<code class="literal">parse="text"</code> attribute and value
27
specified, as detailed in <a class="ulink" href="ExternalCode.html#XIncludeCode" target="_top">Using XInclude for text inclusions</a>.</p>
27
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>
30
<div class="refsection" title="See Also"><a name="id1409282"></a><h2>See Also</h2>
30
<div class="refsection" title="See Also"><a name="id36215864"></a><h2>See Also</h2>
31
31
<p>You can also use the <a href="../pi/dbhtml-include_href.html"><code class="sgmltag-xmlpi"><?dbhtml-include�href?></code></a> processing
32
32
instruction to insert external files — both files containing
33
33
plain text and files with markup content (including HTML
36
<div class="refsection" title="More information"><a name="id1409296"></a><h2>More information</h2>
36
<div class="refsection" title="More information"><a name="id36215876"></a><h2>More information</h2>
37
37
<p>For how-to documentation on inserting contents of
38
38
external code files and other text files into output, see
39
<a class="ulink" href="ExternalCode.html" target="_top">External code files</a>.</p>
39
<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>
40
40
<p>For guidelines on inserting contents of
41
HTML files into output, see <a class="ulink" href="InsertExtHtml.html" target="_top">Inserting external HTML code</a>.</p>
41
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>
43
43
</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>