/usr/share/doc/python-plastex-doc/html/sect0014.html is in python-plastex-doc 0.9.2-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 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta name="generator" content="plasTeX" />
<meta content="text/html; charset=utf-8" http-equiv="content-type" />
<title>plasTeX — A Python Framework for Processing LaTeX Documents: Generating Files</title>
<link href="sect0015.html" title="Generating Images" rel="next" />
<link href="sect0013.html" title="Determining the Correct Rendering Method" rel="prev" />
<link href="sec-renderable.html" title="Renderable Objects" rel="up" />
<link rel="stylesheet" href="styles/styles.css" />
</head>
<body>
<div class="navigation">
<table cellspacing="2" cellpadding="0" width="100%">
<tr>
<td><a href="sect0013.html" title="Determining the Correct Rendering Method"><img alt="Previous: Determining the Correct Rendering Method" border="0" src="icons/previous.gif" width="32" height="32" /></a></td>
<td><a href="sec-renderable.html" title="Renderable Objects"><img alt="Up: Renderable Objects" border="0" src="icons/up.gif" width="32" height="32" /></a></td>
<td><a href="sect0015.html" title="Generating Images"><img alt="Next: Generating Images" border="0" src="icons/next.gif" width="32" height="32" /></a></td>
<td class="navtitle" align="center">plasTeX — A Python Framework for Processing LaTeX Documents</td>
<td><a href="index.html" title="Table of Contents"><img border="0" alt="" src="icons/contents.gif" width="32" height="32" /></a></td>
<td><img border="0" alt="" src="icons/blank.gif" width="32" height="32" /></td>
<td><img border="0" alt="" src="icons/blank.gif" width="32" height="32" /></td>
</tr>
</table>
</div>
<div class="breadcrumbs">
<span>
<span>
<a href="index.html">plasTeX — A Python Framework for Processing LaTeX Documents</a> <b>:</b>
</span>
</span><span>
<span>
<a href="sect0010.html">Renderers</a> <b>:</b>
</span>
</span><span>
<span>
<a href="sec-renderable.html">Renderable Objects</a> <b>:</b>
</span>
</span><span>
<span>
<b class="current">Generating Files</b>
</span>
</span>
<hr />
</div>
<div><h2 id="a0000000015">5.2.2 Generating Files</h2>
<p>Any node in a document has the ability to generate a new file. During document traversal, each node is queried for a filename. If a non-<span class="rmfamily"><i class="itshape">None</i></span> is returned, a new file is created for the content of that node using the given filename. The querying for the filename is simply done by accessing the <tt class="ttfamily">filename</tt> property of the node. This property is added to the node’s namespace during the mixin process. The default behavior for this property is to only return filenames for sections with a level less than the split-level given in the configuration (see section <a href="sec-config-files.html">2.1.5</a>). The filenames generated by this routine are very flexible. They can be statically given names, or names based on the ID and/or title, or simply generically numbered. For more information on configuring filenames see section <a href="sec-config-files.html">2.1.5</a>. </p><p>While the filenaming mechanism is very powerful, you may want to give your files names based on some other information. This is possible through the <tt class="ttfamily">filenameoverride</tt> attribute. If the <tt class="ttfamily">filenameoverride</tt> is set, the name returned by that attribute is used as the filename. The string in <tt class="ttfamily">filenameoverride</tt> is still processed in the same way as the filename specifier in the configuration so that you can use things like the ID or title of the section in the overridden filename. </p><p>The string used to specify filenames can also contain directory paths. This is not terribly useful at the moment since there is no way to get the relative URLs between two nodes for linking purposes. </p><p>If you want to use a filename override, but want to do it conditionally you can use a Python property to do this. Just calculate the filename however you wish, if you decide that you don’t want to use that filename then raise an <tt class="ttfamily">AttributeError</tt> exception. An example of this is shown below. </p><pre>
class mymacro{Command):
args = '[ filename:str ] self'
@property
def filenameoverride(self):
# See if the attributes dictionary has a filename
if self.attributes['filename'] is not None:
return self.attributes['filename']
raise AttributeError, 'filenameoverride'
</pre><p> <b class="bf">Note:</b> The filename in the <tt class="ttfamily">filenameoverride</tt> attribute must contain any directory paths as well as a file extension. </p></div>
<div class="navigation">
<table cellspacing="2" cellpadding="0" width="100%">
<tr>
<td><a href="sect0013.html" title="Determining the Correct Rendering Method"><img alt="Previous: Determining the Correct Rendering Method" border="0" src="icons/previous.gif" width="32" height="32" /></a></td>
<td><a href="sec-renderable.html" title="Renderable Objects"><img alt="Up: Renderable Objects" border="0" src="icons/up.gif" width="32" height="32" /></a></td>
<td><a href="sect0015.html" title="Generating Images"><img alt="Next: Generating Images" border="0" src="icons/next.gif" width="32" height="32" /></a></td>
<td class="navtitle" align="center">plasTeX — A Python Framework for Processing LaTeX Documents</td>
<td><a href="index.html" title="Table of Contents"><img border="0" alt="" src="icons/contents.gif" width="32" height="32" /></a></td>
<td><img border="0" alt="" src="icons/blank.gif" width="32" height="32" /></td>
<td><img border="0" alt="" src="icons/blank.gif" width="32" height="32" /></td>
</tr>
</table>
</div>
<script language="javascript" src="icons/imgadjust.js" type="text/javascript"></script>
</body>
</html>
|