= PyTextile =

[[http://pypi.python.org/pypi/textile|PyTextile]] is a ''very'' easy to use text-to-HTML converter.

You can test the following demonstration of Textile code, 
which can convert ''this:''

{{{
_This_ is a *test.*

* One
* Two
* Three

Link to "Slashdot":http://slashdot.org/
}}}

to ''this:''

{{{
        <p><em>This</em> is a <strong>test.</strong></p>
 
 
<ul>
        <li>One</li>
        <li>Two</li>
        <li>Three</li>
</ul>
 
        <p>Link to <a href="http://slashdot.org/">Slashdot</a></p>
}}}

== Using PyTextile ==

First, [[http://pypi.python.org/pypi/textile|download the latest PyTextile.]]

Untar it, and enter the {{{textile}}} directory. Start a python interpreter.

Type:

{{{
#!python
import textile

s = """
_This_ is a *test.*

* One
* Two
* Three

Link to "Slashdot":http://slashdot.org/
"""

html = textile.textile( s )

print html
}}}

You'll see beautiful HTML on the other side, ready for inclusion in a web page. :)

=== Options ===

PyTextile takes 3 optional arguments:

{{{
def textile(self, text, rel=None, head_offset=0, html_type='xhtml', sanitize=False):
}}}

== See Also: ==

[[reStructuredText]] as a markup format to convert text to HTML.

= Discussion =

(none yet!)