view doc/index.txt @ 744:cd6624cf2f7c trunk

Lots of `Transformer` cleanup: - Content-insertion transformations (before, after, etc.) now accept a callable. - `.prepend()` now ''only'' operates on elements. Previously it also operated on `OUTSIDE` marked events. - Where it makes sense, transformations are now ''consistently'' applied to individually selected objects in the document, rather than on any contiguous selection. This means that adjacent selected elements will be treated individually rather than as a whole. - Transformations should now consistently work on the context node. - `.substitute()` now defaults to a count of 0 (ie. all) rather than 1. This is to be consistent with Python's regex substitution. - `ATTR` events now have a `kind` of `ATTR` in addition to having this as their `mark`. - Added the `BREAK` `mark`. This allows cuts of otherwise seamlessly joined objects to be operated on. - Added a full test suite.
author athomas
date Mon, 09 Jun 2008 06:39:46 +0000
parents 4f1969708442
children bf4ed3c37ab5
line wrap: on
line source
.. -*- mode: rst; encoding: utf-8 -*-

=======
Preface
=======

.. image:: logo.png
   :width: 225
   :height: 81
   :align: center
   :alt: Genshi - Generate output for the web
   :class: logo

--------------------------------------------
Toolkit for generation of output for the web
--------------------------------------------

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 major feature is a template language,
which is heavily inspired by Kid.

Installation
------------

* `Installing Genshi <install.html>`_
* `Upgrading from Previous Versions <upgrade.html>`_

Usage
-----

* `Markup Streams <streams.html>`_
* `Templating Basics <templates.html>`_
* `XML Template Language <xml-templates.html>`_
* `Text Template Language <text-templates.html>`_
* `Using Stream Filters <filters.html>`_
* `Using XPath <xpath.html>`_
* `Internationalization and Localization <i18n.html>`_
* `Using the Templating Plugin <plugin.html>`_

API Documentation
-----------------

* `Generated API Documentation <api/index.html>`_
Copyright (C) 2012-2017 Edgewall Software