eb7db9b968
- Footnotes separator rather than headline to get around i18n - Warn on footnote redefinition - Do not export footnote definitions at point of definition, only in the footnote section. - Do not automatically exclude Footnotes section to get around possibly hiding other content of such a section - and i18n. The user has the choice of explicitly hiding the section via a :noexport: tag. and some other refactoring
144 lines
3.7 KiB
HTML
144 lines
3.7 KiB
HTML
<h1>
|
|
Using some footnotes
|
|
</h1>
|
|
<ul>
|
|
<li>
|
|
<p>
|
|
normal footnote reference <sup class="footnote-reference"><a id="footnote-reference-1" href="#footnote-1">1</a></sup> <sup class="footnote-reference"><a id="footnote-reference-6" href="#footnote-6">6</a></sup>
|
|
</p>
|
|
</li>
|
|
<li>
|
|
<p>
|
|
further references to the same footnote should not <sup class="footnote-reference"><a id="footnote-reference-1" href="#footnote-1">1</a></sup> render duplicates in the footnote list
|
|
</p>
|
|
</li>
|
|
<li>
|
|
<p>
|
|
inline footnotes are also supported via <sup class="footnote-reference"><a id="footnote-reference-2" href="#footnote-2">2</a></sup>.
|
|
</p>
|
|
</li>
|
|
<li>
|
|
<p>
|
|
Footnote definitions are not printed where they appear.
|
|
Rather, they are gathered and exported at the end of the document in the footnote section. <sup class="footnote-reference"><a id="footnote-reference-4" href="#footnote-4">4</a></sup>
|
|
</p>
|
|
</li>
|
|
</ul>
|
|
<h1>
|
|
Footnotes
|
|
</h1>
|
|
<p>
|
|
Please note that the footnotes section is not automatically excluded from the export like in emacs. <sup class="footnote-reference"><a id="footnote-reference-7" href="#footnote-7">7</a></sup>
|
|
</p>
|
|
<p>
|
|
this is not part of <sup class="footnote-reference"><a id="footnote-reference-7" href="#footnote-7">7</a></sup> anymore as there are 2 blank lines in between!
|
|
</p>
|
|
<div class="footnotes">
|
|
<hr class="footnotes-separatator">
|
|
<div class="footnote-definitions">
|
|
<div class="footnote-definition">
|
|
<sup id="footnote-4"><a href="#footnote-reference-4">4</a></sup>
|
|
<div class="footnote-body">
|
|
<p>
|
|
so this definition will not be at the end of this section in the exported document.
|
|
Rather, it will be somewhere down below in the footnotes section.
|
|
</p>
|
|
</div>
|
|
</div>
|
|
<div class="footnote-definition">
|
|
<sup id="footnote-5"><a href="#footnote-reference-5">5</a></sup>
|
|
<div class="footnote-body">
|
|
<p>
|
|
another unused footnote (this definition overwrites the previous definition of <code class="verbatim">fn:5</code>)
|
|
</p>
|
|
</div>
|
|
</div>
|
|
<div class="footnote-definition">
|
|
<sup id="footnote-1"><a href="#footnote-reference-1">1</a></sup>
|
|
<div class="footnote-body">
|
|
<p>
|
|
<a href="https://www.example.com">https://www.example.com</a>
|
|
</p>
|
|
<ul>
|
|
<li>
|
|
<p>
|
|
footnotes can contain <strong>markup</strong>
|
|
</p>
|
|
</li>
|
|
<li>
|
|
<p>
|
|
and other elements
|
|
</p>
|
|
<ul>
|
|
<li>
|
|
<p>
|
|
like blocks
|
|
</p>
|
|
<div class="highlight">
|
|
<pre>
|
|
other non-plain
|
|
</pre>
|
|
</div>
|
|
</li>
|
|
<li>
|
|
<p>
|
|
and tables
|
|
</p>
|
|
<table>
|
|
<tbody>
|
|
<tr>
|
|
<td class="align-right">1</td>
|
|
<td>a</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="align-right">2</td>
|
|
<td>b</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="align-right">3</td>
|
|
<td>c</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="footnote-definition">
|
|
<sup id="footnote-3"><a href="#footnote-reference-3">3</a></sup>
|
|
<div class="footnote-body">
|
|
<p>
|
|
<a href="http://example.com/unused-footnote">example.com/unused-footnote</a>
|
|
</p>
|
|
</div>
|
|
</div>
|
|
<div class="footnote-definition">
|
|
<sup id="footnote-6"><a href="#footnote-reference-6">6</a></sup>
|
|
<div class="footnote-body">
|
|
<p>
|
|
Footnotes break after two consecutive empty lines - just like paragraphs - see <a href="https://orgmode.org/worg/dev/org-syntax.html.">https://orgmode.org/worg/dev/org-syntax.html.</a>
|
|
This shouldn't happen when the definition line and the line after that are empty.
|
|
</p>
|
|
</div>
|
|
</div>
|
|
<div class="footnote-definition">
|
|
<sup id="footnote-7"><a href="#footnote-reference-7">7</a></sup>
|
|
<div class="footnote-body">
|
|
<p>
|
|
There's multiple reasons for that. Among others, doing so requires i18n (to recognize the section) and silently
|
|
hides content before and after the footnotes.
|
|
</p>
|
|
</div>
|
|
</div>
|
|
<div class="footnote-definition">
|
|
<sup id="footnote-2"><a href="#footnote-reference-2">2</a></sup>
|
|
<div class="footnote-body">
|
|
<p>
|
|
the inline footnote definition
|
|
</p>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|