/usr/share/doc/pybtex/html/features.html is in pybtex 0.15-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 | <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<title>The Features of Pybtex</title>
<meta content="text/html; charset=utf-8" http-equiv="content-type"></meta>
<link href="display.css" rel="stylesheet" type="text/css"></link>
<link href="pygments.css" rel="stylesheet" type="text/css"></link>
</head>
<body>
<div id="main">
<h1>The Features<span class="tail"> of Pybtex</span></h1>
<div id="toc">
<h2>Contents</h2>
<ul class="contents">
<li><a href="#bibliography-formats">Bibliography formats</a></li>
<li><a href="#bibliography-style-formats">Bibliography style formats</a></li>
<li><a href="#output-formats">Output formats</a></li>
</ul>
</div>
<div id="content">
<div class="section" id="bibliography-formats">
<h2>Bibliography formats</h2>
<div class="section" id="bibtex">
<h3>BibTeX</h3>
<p>BibTeX format is quite simple. Those who have used BibTeX should be already
familiar with it. The others will probably catch the idea from the following
example:</p>
<div class="sourcecode"><pre>@BOOK{strunk-and-white,
author = "Strunk, Jr., William and E. B. White",
title = "The Elements of Style",
publisher = "Macmillan",
edition = "Third",
year = 1979
}
</pre></div>
<p>For the detailed description of the BibTeX format please refer to the
<a class="reference external" href="http://www.ctan.org/get/info/tex-references/html/bibtex-bib-files.html">BibTeX documentation</a>.</p>
</div>
<div class="section" id="bibtexml">
<h3>BibTeXML</h3>
<p><a class="reference external" href="http://bibtexml.sourceforge.net">BibTeXML</a> format attempts to combine the
simplicity of BibTeX format with the power of XML. Here is what the above
BibTeX bibliography entry wolud look like:</p>
<div class="sourcecode"><pre><span class="nt"><bibtex:entry</span> <span class="na">id=</span><span class="s">"strunk-and-white"</span><span class="nt">></span>
<span class="nt"><bibtex:book></span>
<span class="nt"><bibtex:title></span>The Elements of Style<span class="nt"></bibtex:title></span>
<span class="nt"><bibtex:publisher></span>Macmillan<span class="nt"><bibtex:publisher></span>
<span class="nt"><bibtex:edition></span>Third<span class="nt"></bibtex:edition></span>
<span class="nt"><bibtex:year></span>1979<span class="nt"></bibtex:year></span>
<span class="nt"><bibtex:author></span>
<span class="nt"><bibtex:person></span>
<span class="nt"><bibtex:first></span>William<span class="nt"></bibtex:first></span>
<span class="nt"><bibtex:last></span>Strunk<span class="nt"></bibtex:last></span>
<span class="nt"><bibtex:lineage></span>Jr.<span class="nt"></bibtex:lineage></span>
<span class="nt"></bibtex:person></span>
<span class="nt"><bibtex:person></span>
<span class="nt"><bibtex:first></span>E.<span class="nt"></bibtex:first></span>
<span class="nt"><bibtex:middle></span>B.<span class="nt"></bibtex:first></span>
<span class="nt"><bibtex:last></span>White<span class="nt"></bibtex:last></span>
<span class="nt"></bibtex:person></span>
<span class="nt"></bibtex:author></span>
<span class="nt"></bibtex:book></span>
<span class="nt"></bibtex:entry></span>
</pre></div>
</div>
<div class="section" id="yaml">
<h3>YAML</h3>
<p>We chose to create our own format to use with Pybtex. It is quite similar to
<a class="reference external" href="http://bibtexml.sourceforge.net">BibTeXML</a>
but based on <a class="reference external" href="http://yaml.org">YAML</a> instead of XML and therefore
is much less verbose.</p>
<div class="sourcecode"><pre><span class="l-Scalar-Plain">strunk-and-white</span><span class="p-Indicator">:</span>
<span class="l-Scalar-Plain">type</span><span class="p-Indicator">:</span> <span class="l-Scalar-Plain">book</span>
<span class="l-Scalar-Plain">author</span><span class="p-Indicator">:</span>
<span class="p-Indicator">-</span> <span class="l-Scalar-Plain">first</span><span class="p-Indicator">:</span> <span class="l-Scalar-Plain">William</span>
<span class="l-Scalar-Plain">last</span><span class="p-Indicator">:</span> <span class="l-Scalar-Plain">Strunk</span>
<span class="l-Scalar-Plain">lineage</span><span class="p-Indicator">:</span> <span class="l-Scalar-Plain">Jr.</span>
<span class="p-Indicator">-</span> <span class="l-Scalar-Plain">first</span><span class="p-Indicator">:</span> <span class="l-Scalar-Plain">E.</span>
<span class="l-Scalar-Plain">middle</span><span class="p-Indicator">:</span> <span class="l-Scalar-Plain">B.</span>
<span class="l-Scalar-Plain">last</span><span class="p-Indicator">:</span> <span class="l-Scalar-Plain">White</span>
<span class="l-Scalar-Plain">title</span><span class="p-Indicator">:</span> <span class="l-Scalar-Plain">The Elements of Style</span>
<span class="l-Scalar-Plain">publisher</span><span class="p-Indicator">:</span> <span class="l-Scalar-Plain">Macmillan</span>
<span class="l-Scalar-Plain">edition</span><span class="p-Indicator">:</span> <span class="l-Scalar-Plain">Third</span>
<span class="l-Scalar-Plain">year</span><span class="p-Indicator">:</span> <span class="l-Scalar-Plain">1979</span>
</pre></div>
</div>
</div>
<div class="section" id="bibliography-style-formats">
<h2>Bibliography style formats</h2>
<ul class="simple">
<li>BibTeX <tt class="docutils literal">.bst</tt> files</li>
<li>Pybtex own pythonic <a class="reference external" href="./style_api.html">style API</a></li>
</ul>
</div>
<div class="section" id="output-formats">
<h2>Output formats</h2>
<p>Unlike BibTeX <tt class="docutils literal">.bst</tt> styles, which can only output LaTeX or whatever is
hardcoded in them, Pybtex pythonic styles are output format agnostic and can
produce:</p>
<ul class="simple">
<li>LaTeX</li>
<li>plain text</li>
<li>HTML (work in progress)</li>
</ul>
<p>Support for other formats can be added easily. If you really need it,
please <a class="reference external" href="http://sourceforge.net/tracker/?group_id=151578&atid=781409">file a feature request</a>.</p>
</div>
</div>
<div id="footer">
<hr />
<div id="footer-left">
<p>Generated by <a href="http://docutils.sourceforge.net/">Docutils</a>,
<a href="http://jinja.pocoo.org/">Jinja</a>
and <a href="http://pygments.org/">Pygments</a>.</p>
</div>
</div>
</div>
</body>
</html>
|