:mod:`trac.util.html` -- HTML transformations
=============================================
.. module :: trac.util.html

Building HTML programmatically
------------------------------

With the introduction of the Genshi_ template engine in Trac 0.11,
most of the (X)HTML content is produced directly using Genshi
facilities, like the builder_ or snippet templates.  The old `html`
tag building facility is now not much more than an alias to the `tag`
ElementFactory_, and most of the code uses directly the latter.

.. data :: html

   A `TransposingElementFactory` using `str.lower` transformation.

.. autoclass :: TransposingElementFactory

.. _Genshi: http://genshi.edgewall.org
.. _builder: http://genshi.edgewall.org/wiki/ApiDocs/genshi.builder
.. _ElementFactory: 
   http://genshi.edgewall.org/wiki/ApiDocs/genshi.builder#genshi.builder:ElementFactory


HTML clean-up and sanitization
------------------------------

.. autoclass :: TracHTMLSanitizer
.. autoclass :: Deuglifier

   See some usage examples in
   `tracopt.mimeview.enscript.EnscriptDeuglifier` and
   `tracopt.mimeview.php.PhpDeuglifier`.

.. autofunction :: escape
.. autofunction :: unescape

.. autoclass :: FormTokenInjector


Misc. HTML processing
---------------------

.. autofunction :: expand_markup
.. autofunction :: find_element
.. autofunction :: plaintext