Sophie

Sophie

distrib > Mageia > 7 > i586 > media > core-release > by-pkgid > 6e019a662639ac6470f50dea3a4d8157 > files > 651

docbook-style-xsl-doc-1.79.2-4.mga7.noarch.rpm

<html><head>
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   <title>index.links.to.section</title><link rel="stylesheet" type="text/css" href="../reference.css"><meta name="generator" content="DocBook XSL Stylesheets V1.79.2"><link rel="home" href="../index.html" title="DocBook XSL Stylesheets: Reference&nbsp;Documentation"><link rel="up" href="toc_index.html" title="ToC/LoT/Index Generation"><link rel="prev" href="index.on.role.html" title="index.on.role"><link rel="next" href="index.prefer.titleabbrev.html" title="index.prefer.titleabbrev"><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">index.links.to.section</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="index.on.role.html">Prev</a>&nbsp;</td><th width="60%" align="center">ToC/LoT/Index Generation</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="index.prefer.titleabbrev.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="index.links.to.section"></a><div class="titlepage"></div><div class="refnamediv"><h2><span class="refentrytitle">index.links.to.section</span></h2><p>index.links.to.section &#8212; HTML index entries link to container section title</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><a name="index.links.to.section.frag"></a><pre class="programlisting">
&lt;xsl:param name="index.links.to.section" select="1"&gt;&lt;/xsl:param&gt;
</pre></div><div class="refsection"><a name="d0e1369"></a><h2>Description</h2><p>If zero, then an index entry in an index links
directly to the location of the
generated <code class="sgmltag-element">anchor</code> that is output
for the indexterm. If two identical indexterm elements
exist in the same section, then both entries appear
in the index with the same title but link to different
locations.</p><p>If non-zero, then an index entry in an index links to the
section title containing the <code class="sgmltag-element">indexterm</code>, rather than
directly to the <code class="sgmltag-element">anchor</code> output for the indexterm.
Duplicate indexterm entries in the same section are dropped.
</p><p>The default value is 1, so index entries link to
section titles by default.</p><p>In both cases, the link text in an index entry is the
title of the section containing the indexterm.
That is because HTML does not have numbered pages.
It also provides the reader with context information
for each link.</p><p>This parameter lets you choose which style of
index linking you want. </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>When set to 0, an index entry takes you 
to the precise location of its corresponding indexterm.
However, if you have a lot of duplicate
entries in sections, then you have a lot of duplicate
titles in the index, which makes it more cluttered.
The reader may not recognize why duplicate titles
appear until they follow the links. Also, the links
may land the reader in the middle of a section where the
section title is not visible, which may also be
confusing to the reader.</p></li><li class="listitem"><p>When set to 1, an index entry link is
less precise, but duplicate titles in the
index entries are eliminated. 
Landing on the section title location may confirm the reader's
expectation that a link that
shows a section title will take them to that section title,
not a location within the section.
</p></li></ul></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="index.on.role.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="toc_index.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="index.prefer.titleabbrev.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">index.on.role&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="../index.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;index.prefer.titleabbrev</td></tr></table></div></body></html>