<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>activate.external.olinks</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="links.html" title="Linking"><link rel="prev" href="olink.doctitle.html" title="olink.doctitle"><link rel="next" href="olink.debug.html" title="olink.debug"><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">activate.external.olinks</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="olink.doctitle.html">Prev</a> </td><th width="60%" align="center">Linking</th><td width="20%" align="right"> <a accesskey="n" href="olink.debug.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="activate.external.olinks"></a><div class="titlepage"></div> <div class="refnamediv"><h2><span class="refentrytitle">activate.external.olinks</span></h2><p> activate.external.olinks — Make external olinks into active links </p></div> <div class="refsynopsisdiv"><h2>Synopsis</h2> <a name="activate.external.olinks.frag"></a><pre class="programlisting"> <xsl:param name="activate.external.olinks" select="1"></xsl:param> </pre> </div> <div class="refsection"><a name="idp1509440"></a><h2>Description</h2> <p>If <a href="../html/activate.external.olinks.html"><em class="parameter"><code>activate.external.olinks</code></em></a> is nonzero (the default), then any olinks that reference another document become active links that can be clicked on to follow the link. If the parameter is set to zero, then external olinks will have the appropriate link text generated, but the link is not made active. Olinks to destinations in the current document remain active.</p> <p>To make an external olink active for HTML outputs, the link text is wrapped in an <code class="sgmltag-element">a</code> element with an <code class="sgmltag-element">href</code> attribute. To make an external olink active for FO outputs, the link text is wrapped in an <code class="sgmltag-element">fo:basic-link</code> element with an <code class="sgmltag-element">external-destination</code> attribute.</p> <p>This parameter is useful when you need external olinks to resolve but not be clickable. For example, if documents in a collection are available independently of each other, then having active links between them could lead to unresolved links when a given target document is missing.</p> <p>The epub stylesheets set this parameter to zero by default because there is no standard linking mechanism between Epub documents.</p> <p>If external links are made inactive, you should consider setting the stylesheet parameter <a href="../html/olink.doctitle.html"><em class="parameter"><code>olink.doctitle</code></em></a> to <code class="literal">yes</code>. That will append the external document's title to the link text, making it easier for the user to locate the other document.</p> <p>An olink is considered external when the <a href="../html/current.docid.html"><em class="parameter"><code>current.docid</code></em></a> stylesheet parameter is set to some value, and the olink's <code class="sgmltag-element">targetdoc</code> attribute has a different value. If the two values match, then the link is considered internal. If the <a href="../html/current.docid.html"><em class="parameter"><code>current.docid</code></em></a> parameter is blank, or the <a href="http://docbook.org/tdg5/en/html/olink.html"><code class="sgmltag-element">olink</code></a> element does not have a <code class="sgmltag-element">targetdoc</code> attribute, then the link is considered to be internal and will become an active link.</p> <p>See also <a href="../html/olink.doctitle.html"><em class="parameter"><code>olink.doctitle</code></em></a>, <a href="../html/prefer.internal.olink.html"><em class="parameter"><code>prefer.internal.olink</code></em></a>.</p> </div> </div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="olink.doctitle.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="links.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="olink.debug.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">olink.doctitle </td><td width="20%" align="center"><a accesskey="h" href="../index.html">Home</a></td><td width="40%" align="right" valign="top"> olink.debug</td></tr></table></div></body></html>