|Version 7 (modified by glyph, 6 years ago) (diff)|
Lore is a documentation generator. It is used to generate the Twisted documentation.
Lore processes simple HTML documents (and troff-formatted man-pages) into slightly more complex HTML documents as well as LaTeX files (which can, in turn, be used to produce printed documentation such as the Twisted core documentation "book"). Its features include linking and syntax-highlighting source listings, "table of contents" generation, and embedding diagrams. Where they are not automatic, these features are invoked by annotating elements in the input with special class attributes, which leaves the input a valid HTML document that can be viewed without the help of lore.
Source listings can be maintained in external files, for easier editing, testing, and debugging of documentation examples.
It produces output that looks like this.
Twisted Lore is available under the MIT Free Software licence.
See the Downloads page.
Subscribe to the twisted-python mailing list or visit the #twisted channel on irc.freenode.net to ask questions.