.. Nannou documentation master file, created by
   sphinx-quickstart on Sun Feb 27 12:45:58 2011.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

Nannou's documentation
**********************

Nannou is a templating engine designed for html (but not only) codogeneration of complex objects with arbitrary structure. It based by `pattern matching <http://en.wikipedia.org/wiki/Pattern_matching>`_ concept and influenced by `refal <http://en.wikipedia.org/wiki/Refal>`_ and `xslt <http://en.wikipedia.org/wiki/XSLT>`_ languages.

Thus nannou forces better decomposition in templates and object model. In return certain complex cases may require additional hacks and decorations.

.. toctree::
   :maxdepth: 2

   tutorial

Quickstart
----------------

Data

>>> data = {'foo': [{'bar':1, 'baz':2}, {'bar':None, 'baz':{'foo':'x x x'}}]}

Template

.. sourcecode:: html

   <!--/ foo -->
   <div class="foo">
       <%foo%>
   </div>

   <!--/ bar baz -->
   <span><|em><%bar%></em|>
       <%baz%>
   </span>

Compiling

>>> import nannou
>>> f = nannou.compile(tmpl, {})

Running

>>> print f(data)

Produces

.. sourcecode:: html

    <div class="foo">
       <span><em>1</em>
           2
       </span>
       <span>
           <div class="foo">
                 x x x
           </div>
       </span>
    </div>

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

Nannou avaible wia `PyPI <http://pypi.python.org/pypi>`_ 

    http://pypi.python.org/pypi/nannou/

Lastest version can be found in mercurial repository:

    https://bitbucket.org/nyufac/nannou/

After downloading go to source folder and type:

.. sourcecode:: sh

    make build
   
This build nannou package. After that you can type

.. sourcecode:: sh

    python setup.py install 

or

.. sourcecode:: sh

    pip install dist/nannou-x.x.x.tar.gz

where x.x.x is current version.

Configuration
-------------

.. automodule:: nannou
   :members: