6dc04b4b02
- Remove unused footnote section title option - Move away from maintaining a list of footnotes in the document (only needed for html export, potential maintainance overhead when modifying the document) and rather only build it on export when required. - HTML export: Rename all footnotes to numbers (so we can support anonymous footnote references by assigning them a number) and export footnotes in order of reference, not definition. The implementation of this makes it natural to also stop exporting unused footnote definitions so we do that as well.
136 lines
3.3 KiB
HTML
136 lines
3.3 KiB
HTML
<nav>
|
|
<ul>
|
|
<li><a href="#headline-1">Using some footnotes</a>
|
|
</li>
|
|
<li><a href="#headline-2">Footnotes</a>
|
|
</li>
|
|
</ul>
|
|
</nav>
|
|
<h1 id="headline-1">
|
|
Using some footnotes
|
|
</h1>
|
|
<ul>
|
|
<li>
|
|
<p>
|
|
normal footnote reference <sup class="footnote-reference"><a id="footnote-reference-0" href="#footnote-0">0</a></sup> <sup class="footnote-reference"><a id="footnote-reference-1" href="#footnote-1">1</a></sup>
|
|
</p>
|
|
</li>
|
|
<li>
|
|
<p>
|
|
further references to the same footnote should not <sup class="footnote-reference"><a id="footnote-reference-0" href="#footnote-0">0</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-3" href="#footnote-3">3</a></sup>
|
|
</p>
|
|
</li>
|
|
</ul>
|
|
<h1 id="headline-2">
|
|
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-4" href="#footnote-4">4</a></sup>
|
|
</p>
|
|
<p>
|
|
this is not part of <sup class="footnote-reference"><a id="footnote-reference-4" href="#footnote-4">4</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-0"><a href="#footnote-reference-0">0</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-1"><a href="#footnote-reference-1">1</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-2"><a href="#footnote-reference-2">2</a></sup>
|
|
<div class="footnote-body">
|
|
<p>
|
|
the inline footnote definition
|
|
</p>
|
|
</div>
|
|
</div>
|
|
<div class="footnote-definition">
|
|
<sup id="footnote-3"><a href="#footnote-reference-3">3</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-4"><a href="#footnote-reference-4">4</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>
|
|
</div>
|