/usr/share/doc/python-markdown-doc/docs/extensions/footnotes.html is in python-markdown-doc 2.6.9-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 | <!DOCTYPE html>
<html>
<head>
<meta charset=utf-8>
<title>Footnotes Extension — Python Markdown</title>
<link rel="stylesheet" href="../default.css" type="text/css">
</head>
<body>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="../siteindex.html" title="General Index">index</a></li>
<li class="right">
<a href="tables.html" title="Tables Extension"
accesskey="N">next</a> |</li>
<li class="right">
<a href="fenced_code_blocks.html" title="Fenced Code Blocks Extension"
accesskey="P">previous</a> |</li>
<li><img src="../py.png" alt=""
style="vertical-align: middle; margin-top: -1px"/></li>
<li><a href="../index.html">Python Markdown v2.6.9 documentation</a> »</li>
<li><a href="index.html">Extensions</a> »</li>
<li><a href="footnotes.html">Footnotes Extension</a> »</li>
</ul>
</div> <!-- .related -->
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body">
<h1 id="footnotes">Footnotes<a class="headerlink" href="#footnotes" title="Permanent link">¶</a></h1>
<h2 id="summary">Summary<a class="headerlink" href="#summary" title="Permanent link">¶</a></h2>
<p>The Footnotes extension adds syntax for defining footnotes in Markdown
documents.</p>
<p>This extension is included in the standard Markdown library.</p>
<h2 id="syntax">Syntax<a class="headerlink" href="#syntax" title="Permanent link">¶</a></h2>
<p>Python-Markdown’s Footnote syntax follows the generally accepted syntax of the
Markdown community at large and almost exactly matches <a href="http://michelf.com/projects/php-markdown/extra/#footnotes">PHP Markdown Extra</a>‘s
implementation of footnotes. The only differences involve a few subtleties in
the output.</p>
<p>Example:</p>
<pre><code>Footnotes[^1] have a label[^@#$%] and the footnote's content.
[^1]: This is a footnote content.
[^@#$%]: A footnote on the label: "@#$%".
</code></pre>
<p>A footnote label must start with a caret <code>^</code> and may contain any inline text
(including spaces) between a set of square brackets <code>[]</code>. Only the first
caret has any special meaning.</p>
<p>A footnote content must start with the label followed by a colon and at least
one space. The label used to define the content must exactly match the label used
in the body (including capitalization and white space). The content would then
follow the label either on the same line or on the next line. The content may
contain multiple lines, paragraphs, code blocks, blockquotes and most any other
markdown syntax. The additional lines must be indented one level (four spaces or
one tab). </p>
<p>When working with multiple blocks, it may be helpful to start the content on a
separate line from the label which defines the content. This way the entire block
is indented consistently and any errors are more easily discernible by the author.</p>
<pre><code>[^1]:
The first paragraph of the definition.
Paragraph two of the definition.
> A blockquote with
> multiple lines.
a code block
A final paragraph.
</code></pre>
<h2 id="usage">Usage<a class="headerlink" href="#usage" title="Permanent link">¶</a></h2>
<p>See <a href="index.html">Extensions</a> for general extension usage, specify <code>markdown.extensions.footnotes</code>
as the name of the extension.</p>
<p>See the <a href="../reference.html#extensions">Library Reference</a> for information about
configuring extensions.</p>
<p>The following options are provided to configure the output:</p>
<ul>
<li>
<p><strong><code>PLACE_MARKER</code></strong>:
A text string used to mark the position where the footnotes are rendered.
Defaults to <code>///Footnotes Go Here///</code>.</p>
<p>If the place marker text is not found in the document, the footnote
definitions are placed at the end of the resulting HTML document.</p>
</li>
<li>
<p><strong><code>UNIQUE_IDS</code></strong>:
Whether to avoid collisions across multiple calls to <code>reset()</code>. Defaults to
<code>False</code>.</p>
</li>
<li>
<p><strong><code>BACKLINK_TEXT</code></strong>:
The text string that links from the footnote definition back to the position
in the document. Defaults to <code>&#8617;</code>.</p>
</li>
</ul>
</div> <!-- .body -->
</div> <!-- .bodywrapper -->
</div> <!-- .documentwrapper -->
<div class="sphinxsidebar">
<div class="sphinxsidebarwrapper">
<h3>Table Of Contents</h3>
<div class="toc">
<ul>
<li><a href="#footnotes">Footnotes</a><ul>
<li><a href="#summary">Summary</a></li>
<li><a href="#syntax">Syntax</a></li>
<li><a href="#usage">Usage</a></li>
</ul>
</li>
</ul>
</div>
<h4>Previous topic</h4>
<p class="topless"><a href="fenced_code_blocks.html"
title="previous chapter">Fenced Code Blocks Extension</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="tables.html"
title="next chapter">Tables Extension</a></p>
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="https://github.com/Python-Markdown/markdown/issues"
>Report a Bug</a></li>
<li><a href="footnotes.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div> <!-- .sphinxsidebarwrapper -->
</div> <!-- .sphinxsidebar -->
<div class="clearer"></div>
</div> <!-- .document -->
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="../siteindex.html" title="General Index">index</a></li>
<li class="right">
<a href="tables.html" title="Tables Extension"
accesskey="N">next</a> |</li>
<li class="right">
<a href="fenced_code_blocks.html" title="Fenced Code Blocks Extension"
accesskey="P">previous</a> |</li>
<li><img src="../py.png" alt=""
style="vertical-align: middle; margin-top: -1px"/></li>
<li><a href="../index.html">Python Markdown v2.6.9 documentation</a> »</li>
<li><a href="index.html">Extensions</a> »</li>
<li><a href="footnotes.html">Footnotes Extension</a> »</li>
</ul>
</div> <!-- .related -->
<div class="footer">© 2010-2012 Python Markdown Project</div>
</body>
</html>
|