<?xml version="1.0"?><!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" lang="en"><head><title>Twisted Documentation: Extending the Lore Documentation System</title><link href="../howto/stylesheet.css" type="text/css" rel="stylesheet" /></head><body bgcolor="white"><h1 class="title">Extending the Lore Documentation System</h1><div class="toc"><ol><li><a href="#auto0">Overview</a></li><li><a href="#auto1">Inputs and Outputs</a></li><ul><li><a href="#auto2">Creating New Inputs</a></li><li><a href="#auto3">Creating New Outputs</a></li></ul><li><a href="#auto4">Other Uses for Lore Extensions</a></li><ul><li><a href="#auto5">Color-Code Programming Languages</a></li><li><a href="#auto6">Add New Structural Elements</a></li><li><a href="#auto7">Support New File Formats</a></li></ul></ol></div><div class="content"><span></span><h2>Overview<a name="auto0"></a></h2><p>The <a href="lore.html">Lore Documentation System</a>, out of the box, is specialized for documenting Twisted. Its markup includes CSS classes for Python, HTML, filenames, and other Twisted-focused categories. But don't think this means Lore can't be used for other documentation tasks! Lore is designed to allow extensions, giving any Python programmer the ability to customize Lore for documenting almost anything.</p><p>There are several reasons why you would want to extend Lore. You may want to attach file formats Lore does not understand to your documentation. You may want to create callouts that have special meanings to the reader, to give a memorable appearance to text such as, <q>WARNING: This software was written by a frothing madman!</q> You may want to create color-coding for a different programming language, or you may find that Lore does not provide you with enough structure to mark your document up completely. All of these situations can be solved by creating an extension.</p><h2>Inputs and Outputs<a name="auto1"></a></h2><p>Lore works by reading the HTML source of your document, and producing whatever output the user specifies on the command line. If the HTML document is well-formed XML that meets a certain minimum standard, Lore will be able to to produce some output. All Lore extensions will be written to redefine the <em>input</em>, and most will redefine the output in some way. The name of the default input is <q>lore</q>. When you write your extension, you will come up with a new name for your input, telling Lore what rules to use to process the file.</p><p>Lore can produce XHTML, LaTeX, and DocBook document formats, which can be displayed directly if you have a user agent capable of viewing them, or processed into a third form such as PostScript or PDF. Another output is called <q>lint</q>, after the static-checking utility for C, and is used for the same reason: to statically check input files for problems. The <q>lint</q> output is just a stream of error messages, not a formatted document, but is important because it gives users the ability to validate their input before trying to process it. For the first example, the only output we will be concerned with is LaTeX.</p><h3>Creating New Inputs<a name="auto2"></a></h3><p>Create a new input to tell Lore that your document is marked up differently from a vanilla Lore document. This gives you the power to define a new tag class, for example:</p><pre> <p>The Frabjulon <span class="productname">Limpet 2000</span> is the <span class="marketinglie">industry-leading</span> aquatic mollusc counter, bar none.</p> </pre><p>The above HTML is an instance of a new input to Lore, which we will call MyHTML, to differentiate it from the <q>lore</q> input. We want it to have the following markup:</p><ul><li>A <code>productname</code> class for the <span> tag, which produces underlined text</li><li>A <code>marketinglie</code> class for <span> tag, which produces larger type, bold text</li></ul><p>Note that I chose class names that are valid Python identifiers. You will see why shortly. To get these two effects in Lore's HTML output, all we have to do is create a cascading stylesheet (CSS), and use it in the Lore XHTML Template. However, we also want these effects to work in LaTeX, and we want the output of lint to produce no warnings when it sees lines with these 2 classes. To make LaTeX and lint work, we start by creating a plugin.</p><div class="py-listing"><pre> <span class="py-src-variable">register</span><span class="py-src-op">(</span><span class="py-src-string">'MyHTML'</span><span class="py-src-op">,</span> <span class="py-src-string">"myhtml.factory"</span><span class="py-src-op">,</span> <span class="py-src-variable">description</span><span class="py-src-op">=</span><span class="py-src-string">"My Lore Plugin"</span><span class="py-src-op">,</span><span class="py-src-nl"> </span> <span class="py-src-variable">type</span><span class="py-src-op">=</span><span class="py-src-string">"lore"</span><span class="py-src-op">,</span> <span class="py-src-variable">tapname</span><span class="py-src-op">=</span><span class="py-src-string">"myhtml"</span><span class="py-src-op">)</span><span class="py-src-newline"> </span><span class="py-src-endmarker"></span></pre><div class="caption"> Listing 1: The Plugin File - <a href="listings/lore/plugins.tml"><span class="filename">listings/lore/plugins.tml</span></a></div></div><p>Name this file <code class="py-filename">plugins.tml</code>, and put it in a new package directory named <code class="py-filename">myhtml</code>. Also create an <code class="py-filename">__init__.py</code> file in your new package. Note that <em>the __init__ file can contain nothing but a doc string, but it must exist.</em> If <code class="py-filename">__init__.py</code> is empty, you will have problems with certain unzip programs that don't extract empty files.</p><p>The combination of plugin file and __init__ file causes the new package to be treated like a Twisted plugin, one that Lore knows how to make use of. The first three arguments to <code>register()</code> are the human-readable name, module name, and description of your plugin. The <code>type</code> parameter makes this plugin visible to the Lore system (rather than some other part of Twisted). The <code>tapname</code> parameter is an arbitrary filename with no extension; by convention you should use the lowercase version of your first argument (the human-readable name). Users of your extension will pass this argument to lore with the <code class="shell">--input</code> parameter on the command line. (For more details on plugins, read <a href="plugin.html">Writing a New Plug-In for Twisted</a>.)</p><p>Let's look at that module name more closely: <code class="python">myhtml.factory</code>. We will be creating this file next, in the package named <code class="py-filename">myhtml</code>. The purpose of the factory module is to tell Lore how to process your input.</p><div class="py-listing"><pre> <span class="py-src-keyword">from</span> <span class="py-src-variable">twisted</span><span class="py-src-op">.</span><span class="py-src-variable">lore</span> <span class="py-src-keyword">import</span> <span class="py-src-variable">default</span><span class="py-src-newline"> </span><span class="py-src-keyword">import</span> <span class="py-src-variable">spitters</span><span class="py-src-newline"> </span><span class="py-src-nl"> </span><span class="py-src-keyword">class</span> <span class="py-src-identifier">MyProcessingFunctionFactory</span><span class="py-src-op">(</span><span class="py-src-parameter">default</span><span class="py-src-op">.</span><span class="py-src-parameter">ProcessingFunctionFactory</span><span class="py-src-op">)</span><span class="py-src-op">:</span><span class="py-src-newline"> </span><span class="py-src-indent"> </span><span class="py-src-variable">latexSpitters</span><span class="py-src-op">=</span><span class="py-src-op">{</span><span class="py-src-variable">None</span><span class="py-src-op">:</span> <span class="py-src-variable">spitters</span><span class="py-src-op">.</span><span class="py-src-variable">MyLatexSpitter</span><span class="py-src-op">,</span><span class="py-src-nl"> </span> <span class="py-src-op">}</span><span class="py-src-newline"> </span><span class="py-src-nl"> </span><span class="py-src-comment"># initialize the global variable factory with an instance of your new factory </span><span class="py-src-dedent"></span><span class="py-src-variable">factory</span><span class="py-src-op">=</span><span class="py-src-variable">MyProcessingFunctionFactory</span><span class="py-src-op">(</span><span class="py-src-op">)</span><span class="py-src-newline"> </span><span class="py-src-endmarker"></span></pre><div class="caption">Listing 2: The Input Factory - <a href="listings/lore/factory.py-1"><span class="filename">listings/lore/factory.py-1</span></a></div></div><p>In Listing 2, we create a subclass of ProcessingFunctionFactory. This class provides a hook for you, a class variable named <code>latexSpitters</code>. This variable tells Lore what new class will be generating LaTeX from your input format. We redefine <code>latexSpitters</code> to <code>MyLatexSpitter</code> in the subclass because this class knows what to do with the new input we have already defined. Last, you must define the module-level variable <code class="py-src-identifier">factory</code>. It should be an instance with the same interface as <code class="py-src-identifier">ProcessingFunctionFactory</code> (e.g. an instance of a subclass, in this case, <code class="py-src-identifier">MyProcessingFunctionFactory</code>).</p><p>Now let's actually write some code to generate the LaTeX. Doing this requires at least a familiarity with the LaTeX language. Search Google for <q>latex tutorial</q> and you will find any number of useful LaTeX resources.</p><div class="py-listing"><pre> <span class="py-src-keyword">from</span> <span class="py-src-variable">twisted</span><span class="py-src-op">.</span><span class="py-src-variable">lore</span> <span class="py-src-keyword">import</span> <span class="py-src-variable">latex</span><span class="py-src-newline"> </span><span class="py-src-keyword">from</span> <span class="py-src-variable">twisted</span><span class="py-src-op">.</span><span class="py-src-variable">lore</span><span class="py-src-op">.</span><span class="py-src-variable">latex</span> <span class="py-src-keyword">import</span> <span class="py-src-variable">processFile</span><span class="py-src-newline"> </span><span class="py-src-keyword">import</span> <span class="py-src-variable">os</span><span class="py-src-op">.</span><span class="py-src-variable">path</span><span class="py-src-newline"> </span><span class="py-src-nl"> </span><span class="py-src-keyword">class</span> <span class="py-src-identifier">MyLatexSpitter</span><span class="py-src-op">(</span><span class="py-src-parameter">latex</span><span class="py-src-op">.</span><span class="py-src-parameter">LatexSpitter</span><span class="py-src-op">)</span><span class="py-src-op">:</span><span class="py-src-newline"> </span><span class="py-src-indent"> </span><span class="py-src-keyword">def</span> <span class="py-src-identifier">visitNode_span_productname</span><span class="py-src-op">(</span><span class="py-src-parameter">self</span><span class="py-src-op">,</span> <span class="py-src-parameter">node</span><span class="py-src-op">)</span><span class="py-src-op">:</span><span class="py-src-newline"> </span> <span class="py-src-comment"># start an underline section in LaTeX </span><span class="py-src-indent"> </span><span class="py-src-variable">self</span><span class="py-src-op">.</span><span class="py-src-variable">writer</span><span class="py-src-op">(</span><span class="py-src-string">'\\underline{'</span><span class="py-src-op">)</span><span class="py-src-newline"> </span> <span class="py-src-comment"># process the node and its children </span> <span class="py-src-variable">self</span><span class="py-src-op">.</span><span class="py-src-variable">visitNodeDefault</span><span class="py-src-op">(</span><span class="py-src-variable">node</span><span class="py-src-op">)</span><span class="py-src-newline"> </span> <span class="py-src-comment"># end the underline block </span> <span class="py-src-variable">self</span><span class="py-src-op">.</span><span class="py-src-variable">writer</span><span class="py-src-op">(</span><span class="py-src-string">'}'</span><span class="py-src-op">)</span><span class="py-src-newline"> </span><span class="py-src-nl"> </span> <span class="py-src-dedent"></span><span class="py-src-keyword">def</span> <span class="py-src-identifier">visitNode_span_marketinglie</span><span class="py-src-op">(</span><span class="py-src-parameter">self</span><span class="py-src-op">,</span> <span class="py-src-parameter">node</span><span class="py-src-op">)</span><span class="py-src-op">:</span><span class="py-src-newline"> </span> <span class="py-src-comment"># this example turns on more than one LaTeX effect at once </span><span class="py-src-indent"> </span><span class="py-src-variable">self</span><span class="py-src-op">.</span><span class="py-src-variable">writer</span><span class="py-src-op">(</span><span class="py-src-string">'\\begin{bf}\\begin{Large}'</span><span class="py-src-op">)</span><span class="py-src-newline"> </span> <span class="py-src-variable">self</span><span class="py-src-op">.</span><span class="py-src-variable">visitNodeDefault</span><span class="py-src-op">(</span><span class="py-src-variable">node</span><span class="py-src-op">)</span><span class="py-src-newline"> </span> <span class="py-src-variable">self</span><span class="py-src-op">.</span><span class="py-src-variable">writer</span><span class="py-src-op">(</span><span class="py-src-string">'\\end{Large}\\end{bf}'</span><span class="py-src-op">)</span><span class="py-src-newline"> </span><span class="py-src-dedent"></span><span class="py-src-dedent"></span><span class="py-src-endmarker"></span></pre><div class="caption">Listing 3: spitters.py - <a href="listings/lore/spitters.py-1"><span class="filename">listings/lore/spitters.py-1</span></a></div></div><p>The method <code>visitNode_span_productname</code> is our handler for <span> tags with the <code>class="productname"</code> identifier. Lore knows to try methods <code>visitNode_span_*</code> and <code>visitNode_div_*</code> whenever it encounters a new class in one of these tags. This is why the class names have to be valid Python identifiers.</p><p>Now let's see what Lore does with these new classes with the following input file:</p><div class="html-listing"><pre class="htmlsource"> <html> <head> <title>My First Example</title> </head> <body> <h1>My First Example</h1> <p>The Frabjulon <span class="productname">Limpet 2000</span> is the <span class="marketinglie">industry-leading</span> aquatic mollusc counter, bar none.</p> </body> </html> </pre><div class="caption">Listing 4: 1st_example.html - <a href="listings/lore/1st_example.html"><span class="filename">listings/lore/1st_example.html</span></a></div></div><p>First, verify that your package is laid out correctly. Your directory structure should look like this:</p><pre> 1st_example.html myhtml/ __init__.py factory.py plugins.tml spitters.py </pre><p>In the parent directory of myhtml (that is, <code>myhtml/..</code>), run lore and pdflatex on the input:</p><pre class="shell"> $ lore --input myhtml --output latex 1st_example.html [########################################] (*Done*) $ pdflatex 1st_example.tex [ . . . latex output omitted for brevity . . . ] Output written on 1st_example.pdf (1 page, 22260 bytes). Transcript written on 1st_example.log. </pre><p>And here's what the rendered PDF looks like:</p><p><img src="../img/myhtml-output.png" /></p><p>What happens when we run lore on this file using the lint output?</p><pre class="shell"> $ lore --input myhtml --output lint 1st_example.html 1st_example.html:7:47: unknown class productname 1st_example.html:8:38: unknown class marketinglie [########################################] (*Done*) </pre><p>Lint reports these classes as errors, even though our spitter knows how to process them. To fix this problem, we must add to <code class="py-filename">factory.py</code>.</p><div class="py-listing"><pre> <span class="py-src-keyword">from</span> <span class="py-src-variable">twisted</span><span class="py-src-op">.</span><span class="py-src-variable">lore</span> <span class="py-src-keyword">import</span> <span class="py-src-variable">default</span><span class="py-src-newline"> </span><span class="py-src-keyword">import</span> <span class="py-src-variable">spitters</span><span class="py-src-newline"> </span><span class="py-src-nl"> </span><span class="py-src-keyword">class</span> <span class="py-src-identifier">MyProcessingFunctionFactory</span><span class="py-src-op">(</span><span class="py-src-parameter">default</span><span class="py-src-op">.</span><span class="py-src-parameter">ProcessingFunctionFactory</span><span class="py-src-op">)</span><span class="py-src-op">:</span><span class="py-src-newline"> </span><span class="py-src-indent"> </span><span class="py-src-variable">latexSpitters</span><span class="py-src-op">=</span><span class="py-src-op">{</span><span class="py-src-variable">None</span><span class="py-src-op">:</span> <span class="py-src-variable">spitters</span><span class="py-src-op">.</span><span class="py-src-variable">MyLatexSpitter</span><span class="py-src-op">,</span><span class="py-src-nl"> </span> <span class="py-src-op">}</span><span class="py-src-newline"> </span><span class="py-src-nl"> </span> <span class="py-src-comment"># redefine getLintChecker to validate our classes </span> <span class="py-src-keyword">def</span> <span class="py-src-identifier">getLintChecker</span><span class="py-src-op">(</span><span class="py-src-parameter">self</span><span class="py-src-op">)</span><span class="py-src-op">:</span><span class="py-src-newline"> </span> <span class="py-src-comment"># use the default checker from parent </span><span class="py-src-indent"> </span><span class="py-src-variable">checker</span> <span class="py-src-op">=</span> <span class="py-src-variable">lint</span><span class="py-src-op">.</span><span class="py-src-variable">getDefaultChecker</span><span class="py-src-op">(</span><span class="py-src-op">)</span><span class="py-src-newline"> </span> <span class="py-src-variable">checker</span><span class="py-src-op">.</span><span class="py-src-variable">allowedClasses</span> <span class="py-src-op">=</span> <span class="py-src-variable">checker</span><span class="py-src-op">.</span><span class="py-src-variable">allowedClasses</span><span class="py-src-op">.</span><span class="py-src-variable">copy</span><span class="py-src-op">(</span><span class="py-src-op">)</span><span class="py-src-newline"> </span> <span class="py-src-variable">oldSpan</span> <span class="py-src-op">=</span> <span class="py-src-variable">checker</span><span class="py-src-op">.</span><span class="py-src-variable">allowedClasses</span><span class="py-src-op">[</span><span class="py-src-string">'span'</span><span class="py-src-op">]</span><span class="py-src-newline"> </span> <span class="py-src-variable">checkfunc</span><span class="py-src-op">=</span><span class="py-src-keyword">lambda</span> <span class="py-src-variable">cl</span><span class="py-src-op">:</span> <span class="py-src-variable">oldSpan</span><span class="py-src-op">(</span><span class="py-src-variable">cl</span><span class="py-src-op">)</span> <span class="py-src-keyword">or</span> <span class="py-src-variable">cl</span> <span class="py-src-keyword">in</span> <span class="py-src-op">[</span><span class="py-src-string">'marketinglie'</span><span class="py-src-op">,</span><span class="py-src-nl"> </span> <span class="py-src-string">'productname'</span><span class="py-src-op">]</span><span class="py-src-newline"> </span> <span class="py-src-variable">checker</span><span class="py-src-op">.</span><span class="py-src-variable">allowedClasses</span><span class="py-src-op">[</span><span class="py-src-string">'span'</span><span class="py-src-op">]</span> <span class="py-src-op">=</span> <span class="py-src-variable">checkfunc</span><span class="py-src-newline"> </span> <span class="py-src-keyword">return</span> <span class="py-src-variable">checker</span><span class="py-src-newline"> </span><span class="py-src-nl"> </span><span class="py-src-comment"># initialize the global variable factory with an instance of your new factory </span><span class="py-src-dedent"></span><span class="py-src-dedent"></span><span class="py-src-variable">factory</span><span class="py-src-op">=</span><span class="py-src-variable">MyProcessingFunctionFactory</span><span class="py-src-op">(</span><span class="py-src-op">)</span><span class="py-src-newline"> </span><span class="py-src-endmarker"></span></pre><div class="caption">Listing 5: Input Factory with Lint Support - <a href="listings/lore/factory.py-2"><span class="filename">listings/lore/factory.py-2</span></a></div></div><p>The method <code class="py-src-identifier">getLintChecker</code> is called by Lore to produce the lint output. This modification adds our classes to the list of classes lint ignores:</p><pre class="shell"> $ lore --input myhtml --output lint 1st_example.html [########################################] (*Done*) $ # Hooray! </pre><p>Finally, there are two other sub-outputs of LaTeX, for a total of three different ways that Lore can produce LaTeX: the default way, which produces as output an entire, self-contained LaTeX document; with <code class="shell">--config section</code> on the command line, which produces a LaTeX \section; and with <code class="shell">--config chapter</code>, which produces a LaTeX \chapter. To support these options as well, the solution is to make the new spitter class a mixin, and use it with the <code class="py-src-identifier">SectionLatexSpitter</code> and <code class="py-src-identifier">ChapterLatexSpitter</code>, respectively. Comments in the following listings tell you everything you need to know about making these simple changes:</p><ul><li><div class="py-listing"><pre> <span class="py-src-keyword">from</span> <span class="py-src-variable">twisted</span><span class="py-src-op">.</span><span class="py-src-variable">lore</span> <span class="py-src-keyword">import</span> <span class="py-src-variable">default</span><span class="py-src-newline"> </span><span class="py-src-keyword">import</span> <span class="py-src-variable">spitters</span><span class="py-src-newline"> </span><span class="py-src-nl"> </span><span class="py-src-keyword">class</span> <span class="py-src-identifier">MyProcessingFunctionFactory</span><span class="py-src-op">(</span><span class="py-src-parameter">default</span><span class="py-src-op">.</span><span class="py-src-parameter">ProcessingFunctionFactory</span><span class="py-src-op">)</span><span class="py-src-op">:</span><span class="py-src-newline"> </span> <span class="py-src-comment"># 1. add the keys "chapter" and "section" to latexSpitters to handle the </span> <span class="py-src-comment"># --config chapter and --config section options </span><span class="py-src-indent"> </span><span class="py-src-variable">latexSpitters</span><span class="py-src-op">=</span><span class="py-src-op">{</span><span class="py-src-variable">None</span><span class="py-src-op">:</span> <span class="py-src-variable">spitters</span><span class="py-src-op">.</span><span class="py-src-variable">MyLatexSpitter</span><span class="py-src-op">,</span><span class="py-src-nl"> </span> <span class="py-src-string">"section"</span><span class="py-src-op">:</span> <span class="py-src-variable">spitters</span><span class="py-src-op">.</span><span class="py-src-variable">MySectionLatexSpitter</span><span class="py-src-op">,</span><span class="py-src-nl"> </span> <span class="py-src-string">"chapter"</span><span class="py-src-op">:</span> <span class="py-src-variable">spitters</span><span class="py-src-op">.</span><span class="py-src-variable">MyChapterLatexSpitter</span><span class="py-src-op">,</span><span class="py-src-nl"> </span> <span class="py-src-op">}</span><span class="py-src-newline"> </span><span class="py-src-nl"> </span> <span class="py-src-keyword">def</span> <span class="py-src-identifier">getLintChecker</span><span class="py-src-op">(</span><span class="py-src-parameter">self</span><span class="py-src-op">)</span><span class="py-src-op">:</span><span class="py-src-newline"> </span><span class="py-src-indent"> </span><span class="py-src-variable">checker</span> <span class="py-src-op">=</span> <span class="py-src-variable">lint</span><span class="py-src-op">.</span><span class="py-src-variable">getDefaultChecker</span><span class="py-src-op">(</span><span class="py-src-op">)</span><span class="py-src-newline"> </span> <span class="py-src-variable">checker</span><span class="py-src-op">.</span><span class="py-src-variable">allowedClasses</span> <span class="py-src-op">=</span> <span class="py-src-variable">checker</span><span class="py-src-op">.</span><span class="py-src-variable">allowedClasses</span><span class="py-src-op">.</span><span class="py-src-variable">copy</span><span class="py-src-op">(</span><span class="py-src-op">)</span><span class="py-src-newline"> </span> <span class="py-src-variable">oldSpan</span> <span class="py-src-op">=</span> <span class="py-src-variable">checker</span><span class="py-src-op">.</span><span class="py-src-variable">allowedClasses</span><span class="py-src-op">[</span><span class="py-src-string">'span'</span><span class="py-src-op">]</span><span class="py-src-newline"> </span> <span class="py-src-variable">checkfunc</span><span class="py-src-op">=</span><span class="py-src-keyword">lambda</span> <span class="py-src-variable">cl</span><span class="py-src-op">:</span> <span class="py-src-variable">oldSpan</span><span class="py-src-op">(</span><span class="py-src-variable">cl</span><span class="py-src-op">)</span> <span class="py-src-keyword">or</span> <span class="py-src-variable">cl</span> <span class="py-src-keyword">in</span> <span class="py-src-op">[</span><span class="py-src-string">'marketinglie'</span><span class="py-src-op">,</span><span class="py-src-nl"> </span> <span class="py-src-string">'productname'</span><span class="py-src-op">]</span><span class="py-src-newline"> </span> <span class="py-src-variable">checker</span><span class="py-src-op">.</span><span class="py-src-variable">allowedClasses</span><span class="py-src-op">[</span><span class="py-src-string">'span'</span><span class="py-src-op">]</span> <span class="py-src-op">=</span> <span class="py-src-variable">checkfunc</span><span class="py-src-newline"> </span> <span class="py-src-keyword">return</span> <span class="py-src-variable">checker</span><span class="py-src-newline"> </span><span class="py-src-nl"> </span><span class="py-src-dedent"></span><span class="py-src-dedent"></span><span class="py-src-variable">factory</span><span class="py-src-op">=</span><span class="py-src-variable">MyProcessingFunctionFactory</span><span class="py-src-op">(</span><span class="py-src-op">)</span><span class="py-src-newline"> </span><span class="py-src-endmarker"></span></pre><div class="caption">factory.py - <a href="listings/lore/factory.py-3"><span class="filename">listings/lore/factory.py-3</span></a></div></div></li><li><div class="py-listing"><pre> <span class="py-src-keyword">from</span> <span class="py-src-variable">twisted</span><span class="py-src-op">.</span><span class="py-src-variable">lore</span> <span class="py-src-keyword">import</span> <span class="py-src-variable">latex</span><span class="py-src-newline"> </span><span class="py-src-keyword">from</span> <span class="py-src-variable">twisted</span><span class="py-src-op">.</span><span class="py-src-variable">lore</span><span class="py-src-op">.</span><span class="py-src-variable">latex</span> <span class="py-src-keyword">import</span> <span class="py-src-variable">processFile</span><span class="py-src-newline"> </span><span class="py-src-keyword">import</span> <span class="py-src-variable">os</span><span class="py-src-op">.</span><span class="py-src-variable">path</span><span class="py-src-newline"> </span><span class="py-src-nl"> </span><span class="py-src-comment"># 2. Create a new mixin that does what the old MyLatexSpitter used to do: </span><span class="py-src-comment"># process the new classes we defined </span><span class="py-src-keyword">class</span> <span class="py-src-identifier">MySpitterMixin</span><span class="py-src-op">:</span><span class="py-src-newline"> </span><span class="py-src-indent"> </span><span class="py-src-keyword">def</span> <span class="py-src-identifier">visitNode_span_productname</span><span class="py-src-op">(</span><span class="py-src-parameter">self</span><span class="py-src-op">,</span> <span class="py-src-parameter">node</span><span class="py-src-op">)</span><span class="py-src-op">:</span><span class="py-src-newline"> </span><span class="py-src-indent"> </span><span class="py-src-variable">self</span><span class="py-src-op">.</span><span class="py-src-variable">writer</span><span class="py-src-op">(</span><span class="py-src-string">'\\underline{'</span><span class="py-src-op">)</span><span class="py-src-newline"> </span> <span class="py-src-variable">self</span><span class="py-src-op">.</span><span class="py-src-variable">visitNodeDefault</span><span class="py-src-op">(</span><span class="py-src-variable">node</span><span class="py-src-op">)</span><span class="py-src-newline"> </span> <span class="py-src-variable">self</span><span class="py-src-op">.</span><span class="py-src-variable">writer</span><span class="py-src-op">(</span><span class="py-src-string">'}'</span><span class="py-src-op">)</span><span class="py-src-newline"> </span><span class="py-src-nl"> </span> <span class="py-src-dedent"></span><span class="py-src-keyword">def</span> <span class="py-src-identifier">visitNode_span_marketinglie</span><span class="py-src-op">(</span><span class="py-src-parameter">self</span><span class="py-src-op">,</span> <span class="py-src-parameter">node</span><span class="py-src-op">)</span><span class="py-src-op">:</span><span class="py-src-newline"> </span><span class="py-src-indent"> </span><span class="py-src-variable">self</span><span class="py-src-op">.</span><span class="py-src-variable">writer</span><span class="py-src-op">(</span><span class="py-src-string">'\\begin{bf}\\begin{Large}'</span><span class="py-src-op">)</span><span class="py-src-newline"> </span> <span class="py-src-variable">self</span><span class="py-src-op">.</span><span class="py-src-variable">visitNodeDefault</span><span class="py-src-op">(</span><span class="py-src-variable">node</span><span class="py-src-op">)</span><span class="py-src-newline"> </span> <span class="py-src-variable">self</span><span class="py-src-op">.</span><span class="py-src-variable">writer</span><span class="py-src-op">(</span><span class="py-src-string">'\\end{Large}\\end{bf}'</span><span class="py-src-op">)</span><span class="py-src-newline"> </span><span class="py-src-nl"> </span><span class="py-src-comment"># 3. inherit from the mixin class for each of the three sub-spitters </span><span class="py-src-dedent"></span><span class="py-src-dedent"></span><span class="py-src-keyword">class</span> <span class="py-src-identifier">MyLatexSpitter</span><span class="py-src-op">(</span><span class="py-src-parameter">MySpitterMixin</span><span class="py-src-op">,</span> <span class="py-src-parameter">latex</span><span class="py-src-op">.</span><span class="py-src-parameter">LatexSpitter</span><span class="py-src-op">)</span><span class="py-src-op">:</span><span class="py-src-newline"> </span><span class="py-src-indent"> </span><span class="py-src-keyword">pass</span><span class="py-src-newline"> </span><span class="py-src-nl"> </span><span class="py-src-dedent"></span><span class="py-src-keyword">class</span> <span class="py-src-identifier">MySectionLatexSpitter</span><span class="py-src-op">(</span><span class="py-src-parameter">MySpitterMixin</span><span class="py-src-op">,</span> <span class="py-src-parameter">latex</span><span class="py-src-op">.</span><span class="py-src-parameter">SectionLatexSpitter</span><span class="py-src-op">)</span><span class="py-src-op">:</span><span class="py-src-newline"> </span><span class="py-src-indent"> </span><span class="py-src-keyword">pass</span><span class="py-src-newline"> </span><span class="py-src-nl"> </span><span class="py-src-dedent"></span><span class="py-src-keyword">class</span> <span class="py-src-identifier">MyChapterLatexSpitter</span><span class="py-src-op">(</span><span class="py-src-parameter">MySpitterMixin</span><span class="py-src-op">,</span> <span class="py-src-parameter">latex</span><span class="py-src-op">.</span><span class="py-src-parameter">ChapterLatexSpitter</span><span class="py-src-op">)</span><span class="py-src-op">:</span><span class="py-src-newline"> </span><span class="py-src-indent"> </span><span class="py-src-keyword">pass</span><span class="py-src-newline"> </span><span class="py-src-dedent"></span><span class="py-src-endmarker"></span></pre><div class="caption">spitters.py - <a href="listings/lore/spitters.py-2"><span class="filename">listings/lore/spitters.py-2</span></a></div></div></li></ul><h3>Creating New Outputs<a name="auto3"></a></h3><p><div class="doit">write some stuff</div></p><h2>Other Uses for Lore Extensions<a name="auto4"></a></h2><p><div class="doit">write some stuff</div></p><h3>Color-Code Programming Languages<a name="auto5"></a></h3><p><div class="doit">write some stuff</div></p><h3>Add New Structural Elements<a name="auto6"></a></h3><p><div class="doit">write some stuff</div></p><h3>Support New File Formats<a name="auto7"></a></h3><p><div class="doit">write some stuff</div></p></div><p><a href="../howto/index.html">Index</a></p><span class="version">Version: 1.3.0</span></body></html>