{{{ #!html

Genshi

Python toolkit for generation of output for the web

}}} {{{ #!html }}} [[Image(source:/trunk/doc/2000ft.png, align=right, usemap=#2000ft, width=476, height=405, nolink)]] '''Genshi''' is a Python library that provides an integrated set of components for parsing, generating, and processing HTML, XML or other textual content for output generation on the web. The main feature is a [wiki:Documentation/xml-templates.html template language] that is smart about markup: unlike conventional template languages that only deal with bytes and (if you're lucky) characters, Genshi knows the difference between tags, attributes, and actual text nodes, and uses that knowledge to your advantage. For example: * Intelligent automatic escaping greatly reduces the risk of opening up your site to [http://ha.ckers.org/cross-site-scripting.html cross-site scripting] attacks (XSS). * [wiki:Documentation/xml-templates.html#template-directives Template directives] are often less verbose than those in most other template languages, as they can be attached directly to the elements they act upon. * [wiki:Documentation/streams.html#serialization Independence from a specific serialization format] lets you instantly switch between generating well-formed HTML 4.01 and XHTML 1.0 (or other formats). * [wiki:Documentation/filters.html Stream-based filtering] allows you to apply various transformations as a template is being processed, without having to parse and serialize the output again. * [wiki:Documentation/xml-templates.html#id5 Match templates] let you enforce a common structure on template output, and [wiki:GenshiRecipes/HtmlTransform#UsingMatchTemplates more]. This, in combination with [wiki:Documentation/xml-templates.html#id10 XInclude] support, is used instead of the more rigid inheritance feature commonly found in other template languages. For those cases where you don't want to generate markup, Genshi also provides a simple [wiki:Documentation/text-templates.html text-based template language]. == Quick Links == * [wiki:GenshiTutorial Genshi tutorial] * [wiki:GenshiFaq Frequently asked questions] * [wiki:GenshiFeedback What people say about Genshi] * [wiki:GenshiPerformance Some performance numbers] * [wiki:GenshiExtensions Projects extending Genshi] * [wiki:GenshiUsers Who is using Genshi?] == [wiki:Documentation Documentation] == * [wiki:Documentation/index.html User Guide] ([wiki:Documentation/0.6.x/index.html 0.6] | [wiki:Documentation/0.5.x/index.html 0.5] | [wiki:Documentation/0.4.x/index.html 0.4] | [wiki:Documentation/0.3.x/index.html 0.3]) * [wiki:ApiDocs API Documentation] ([wiki:ApiDocs/0.6.x 0.6] | [wiki:ApiDocs/0.5.x 0.5] | [wiki:ApiDocs/0.4.x 0.4] | [wiki:ApiDocs/0.3.x 0.3]) * [wiki:GenshiRecipes Recipes for using Genshi] * [wiki:HelperFunctions Helper functions for use in templates] * [http://www.cmlenz.net/stuff/genshi_europython2007.pdf Slides from Chris´ talk on Genshi] at [http://europython.org/ EuroPython 2007] Please note that the Genshi source tarballs come with comprehensive HTML documentation, encompassing both the generated API documentation and the user guide. The API documentation (courtesy of [http://epydoc.sourceforge.net/ Epydoc]) in particular is a lot better than the version you find here. == Development == The Subversion repository can be accessed via: http://svn.edgewall.org/repos/genshi/ Discussion about the development of Genshi takes place on the [MailingList mailing lists] or [IrcChannel IRC channel]. Find out more about the people working on this project on GenshiTeam. {{{ #!html python powered
}}}