/usr/share/doc/python-markdown-doc/docs/extensions/meta_data.html is in python-markdown-doc 2.5.1-2.
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 159 160 161 162 163 164 165 166 167 168 169 170 171 172 | <!DOCTYPE html>
<html>
<head>
<meta charset=utf-8>
<title>Meta-Data 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="nl2br.html" title="New Line to Break Extension"
accesskey="N">next</a> |</li>
<li class="right">
<a href="header_id.html" title="HeaderId 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.5.1 documentation</a> »</li>
<li><a href="index.html">Extensions</a> »</li>
<li><a href="meta_data.html">Meta-Data Extension</a> »</li>
</ul>
</div> <!-- .related -->
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body">
<h1 id="meta-data">Meta-Data<a class="headerlink" href="#meta-data" title="Permanent link">¶</a></h1>
<h2 id="summary">Summary<a class="headerlink" href="#summary" title="Permanent link">¶</a></h2>
<p>The Meta-Data extension adds a syntax for defining meta-data about a document.
It is inspired by and follows the syntax of <a href="http://fletcherpenney.net/MultiMarkdown_Syntax_Guide#metadata">MultiMarkdown</a>. Currently,
this extension does not use the meta-data in any way, but simply provides it as
a <code>Meta</code> attribute of a Markdown instance for use by other extensions or
directly by your python code.</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>Meta-data consists of a series of keywords and values defined at the beginning
of a markdown document like this:</p>
<pre><code>Title: My Document
Summary: A brief description of my document.
Authors: Waylan Limberg
John Doe
Date: October 2, 2007
blank-value:
base_url: http://example.com
This is the first paragraph of the document.
</code></pre>
<p>The keywords are case-insensitive and may consist of letters, numbers,
underscores and dashes and must end with a colon. The values consist of
anything following the colon on the line and may even be blank.</p>
<p>If a line is indented by 4 or more spaces, that line is assumed to be an
additional line of the value for the previous keyword. A keyword may have as
many lines as desired. </p>
<p>The first blank line ends all meta-data for the document. Therefore, the first
line of a document must not be blank. All meta-data is stripped from the
document prior to any further processing by Markdown.</p>
<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.meta</code>
as the name of the extension.</p>
<p>This extension does not accept any special configuration options.</p>
<h2 id="accessing-the-meta-data">Accessing the Meta-Data<a class="headerlink" href="#accessing-the-meta-data" title="Permanent link">¶</a></h2>
<p>The meta-data is made available as a python Dict in the <code>Meta</code> attribute of an
instance of the Markdown class. For example, using the above document:</p>
<pre><code>>>> md = markdown.Markdown(extensions = ['markdown.extensions.meta'])
>>> html = md.convert(text)
>>> # Meta-data has been stripped from output
>>> print html
<p>This is the first paragraph of the document.</p>
>>> # View meta-data
>>> print md.Meta
{
'title' : ['My Document'],
'summary' : ['A brief description of my document.'],
'authors' : ['Waylan Limberg', 'John Doe'],
'date' : ['October 2, 2007'],
'blank-value' : [''],
'base_url' : ['http://example.com']
}
</code></pre>
<p>Note that the keys are all lowercase and the values consist of a list of
strings where each item is one line for that key. This way, one could preserve
line breaks if desired. Or the items could be joined where appropriate. No
assumptions are made regarding the data. It is simply passed as found to the
<code>Meta</code> attribute.</p>
<p>Perhaps the meta-data could be passed into a template system, or used by
various Markdown extensions. The possibilities are left to the imagination of
the developer.</p>
<h2 id="compatible-extensions">Compatible Extensions<a class="headerlink" href="#compatible-extensions" title="Permanent link">¶</a></h2>
<p>The following extensions are currently known to work with the Meta-Data
extension. The keywords they are known to support are also listed.</p>
<ul>
<li><a href="header_id.html">HeaderId</a><ul>
<li><code>header_level</code></li>
<li><code>header_forceid</code></li>
</ul>
</li>
<li><a href="wikilinks.html">WikiLinks</a><ul>
<li><code>wiki_base_url</code></li>
<li><code>wiki_end_url</code></li>
<li><code>wiki_html_class</code></li>
</ul>
</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="#meta-data">Meta-Data</a><ul>
<li><a href="#summary">Summary</a></li>
<li><a href="#syntax">Syntax</a></li>
<li><a href="#usage">Usage</a></li>
<li><a href="#accessing-the-meta-data">Accessing the Meta-Data</a></li>
<li><a href="#compatible-extensions">Compatible Extensions</a></li>
</ul>
</li>
</ul>
</div>
<h4>Previous topic</h4>
<p class="topless"><a href="header_id.html"
title="previous chapter">HeaderId Extension</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="nl2br.html"
title="next chapter">New Line to Break Extension</a></p>
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="https://github.com/waylan/Python-Markdown/issues"
>Report a Bug</a></li>
<li><a href="meta_data.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="nl2br.html" title="New Line to Break Extension"
accesskey="N">next</a> |</li>
<li class="right">
<a href="header_id.html" title="HeaderId 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.5.1 documentation</a> »</li>
<li><a href="index.html">Extensions</a> »</li>
<li><a href="meta_data.html">Meta-Data Extension</a> »</li>
</ul>
</div> <!-- .related -->
<div class="footer">© 2010-2012 Python Markdown Project</div>
</body>
</html>
|