Mercurial > genshi > mirror
view markup/__init__.py @ 21:b4d17897d053 trunk
* Include paths are now interpreted relative to the path of the including template. Closes #3.
* The filename is now included as first item in the `pos` tuple of stream events.
* Simplified the "basic" example so that it actually ''is'' basic.
* Added a more complex example using nested relative includes in [source:/trunk/examples/includes/ examples/includes].
| author | cmlenz |
|---|---|
| date | Tue, 20 Jun 2006 13:05:37 +0000 |
| parents | cc92d74ce9e5 |
| children | 5a4d45703319 |
line wrap: on
line source
# -*- coding: utf-8 -*- # # Copyright (C) 2006 Christopher Lenz # All rights reserved. # # This software is licensed as described in the file COPYING, which # you should have received as part of this distribution. The terms # are also available at http://trac.edgewall.com/license.html. # # This software consists of voluntary contributions made by many # individuals. For the exact contribution history, see the revision # history and logs, available at http://projects.edgewall.com/trac/. """This package provides various means for generating and processing web markup (XML or HTML). The design is centered around the concept of streams of markup events (similar in concept to SAX parsing events) which can be processed in a uniform manner independently of where or how they are produced. Generating content ------------------ Literal XML and HTML text can be used to easily produce markup streams via helper functions in the `markup.input` module: >>> from markup.input import XML >>> doc = XML('<html lang="en"><head><title>My document</title></head></html>') This results in a `Stream` object that can be used in a number of way. >>> doc.render(method='html', encoding='utf-8') '<html lang="en"><head><title>My document</title></head></html>' >>> from markup.input import HTML >>> doc = HTML('<HTML lang=en><HEAD><TITLE>My document</HTML>') >>> doc.render(method='html', encoding='utf-8') '<html lang="en"><head><title>My document</title></head></html>' >>> title = doc.select('head/title') >>> title.render(method='html', encoding='utf-8') '<title>My document</title>' Markup streams can also be generated programmatically using the `markup.builder` module: >>> from markup.builder import tag >>> doc = tag.doc(tag.title('My document'), lang='en') >>> doc.generate().render(method='html') '<doc lang="en"><title>My document</title></doc>' """ from markup.core import * from markup.input import ParseError, XML, HTML