blob: d3b01d35ccc9b33fe5dac5ef4e0fc4278e5a2179 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
|
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Chapter 18. Footnotes</title><link rel="stylesheet" type="text/css" href="docbook-xsl.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.79.1" /><link rel="home" href="index.html" title="AsciiDoc User Guide" /><link rel="up" href="index.html" title="AsciiDoc User Guide" /><link rel="prev" href="ch17.html" title="Chapter 17. Lists" /><link rel="next" href="ch19.html" title="Chapter 19. Indexes" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><td width="20%" align="left"><a accesskey="p" href="ch17.html"><img src="images/icons/prev.png" alt="Prev" /></a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ch19.html"><img src="images/icons/next.png" alt="Next" /></a></td></tr></table><hr /></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a id="X92"></a>Chapter 18. Footnotes</h1></div></div></div><p>The shipped AsciiDoc configuration includes three footnote inline
macros:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term">
<code class="literal">footnote:[<text>]</code>
</span></dt><dd>
Generates a footnote with text <code class="literal"><text></code>.
</dd><dt><span class="term">
<code class="literal">footnoteref:[<id>,<text>]</code>
</span></dt><dd>
Generates a footnote with a reference ID <code class="literal"><id></code> and text <code class="literal"><text></code>.
</dd><dt><span class="term">
<code class="literal">footnoteref:[<id>]</code>
</span></dt><dd>
Generates a reference to the footnote with ID <code class="literal"><id></code>.
</dd></dl></div><p>The footnote text can span multiple lines.</p><p>The <span class="emphasis"><em>xhtml11</em></span> and <span class="emphasis"><em>html5</em></span> backends render footnotes dynamically using
JavaScript; <span class="emphasis"><em>html4</em></span> outputs do not use JavaScript and leave the
footnotes inline; <span class="emphasis"><em>docbook</em></span> footnotes are processed by the downstream
DocBook toolchain.</p><p>Example footnotes:</p><pre class="literallayout">A footnote footnote:[An example footnote.];
a second footnote with a reference ID footnoteref:[note2,Second footnote.];
finally a reference to the second footnote footnoteref:[note2].</pre><p>Renders:</p><p>A footnote <a href="#ftn.idm1981" class="footnote" id="idm1981"><sup class="footnote">[2]</sup></a>;
a second footnote with a reference ID <a href="#ftn.note2" class="footnote" id="note2"><sup class="footnote">[3]</sup></a>;
finally a reference to the second footnote <a href="ch18.html#ftn.note2" class="footnoteref"><sup class="footnoteref">[3]</sup></a>.</p><div class="footnotes"><br /><hr style="width:100; text-align:left;margin-left: 0" /><div id="ftn.idm1981" class="footnote"><p><a href="#idm1981" class="simpara"><sup class="simpara">[2] </sup></a>An example footnote.</p></div><div id="ftn.note2" class="footnote"><p><a href="#note2" class="simpara"><sup class="simpara">[3] </sup></a>Second footnote.</p></div></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch17.html"><img src="images/icons/prev.png" alt="Prev" /></a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="ch19.html"><img src="images/icons/next.png" alt="Next" /></a></td></tr><tr><td width="40%" align="left" valign="top"> </td><td width="20%" align="center"><a accesskey="h" href="index.html"><img src="images/icons/home.png" alt="Home" /></a></td><td width="40%" align="right" valign="top"> </td></tr></table></div></body></html>
|
