\n Text of paragraph\n
\n![\"\"](\"/img/my_picture.png\")
\n\nNote that **mint** knows about selfclosed html tags.\n\nWhy do not use python dictionary declaration syntax instead?\nSomething like ``{alt:\"\", src:\"/img/my_picture.png\"}``\n\nBecause it is overloaded for html templating. \"Chained-methods-call\" like\nsyntax uses less chars to type.\n\n**mint** alows to set/append value of tag attribute somewhere inside tag::\n\n @div.class(main)\n // set value of attribute\n @.class(header)\n\n @div.class(main)\n // append value to attribute\n @+class( header)\n\nwill be rendered as::\n\n \n\n \n\nThis is very handy when you need to set content of tag and it's attributes based\non some condition.\n\n.. _escaping:\n\nescaping\n--------\n\nAs you know there are some chars we need to escape in xml. And **mint** does this\nautomatically for you. It escapes all text inside tags and attributes.\nAutoescaping can't be turned off::\n\n @a.href(/docs?type=1&published=true) docs\n @p.class( ' \" < > & )\n \n\nWill be rendered as::\n\n docs\n \n <div class="inside" />\n
\n\n\n.. _expressions:\n\npython expressions\n------------------\n\nOf course, template engine without possibility to insert python expressions is unusable.\nSo in **mint** you can do this with syntax similar to ``jinja2`` or ``django``::\n\n @html\n @head\n @title {{ doc.title }}\n @body\n @div.id(content)\n Here we have content {{ doc.content }}\n\nUnder the hood **mint** calls ``unicode`` on python expression\nand escapes result.\n\nNote that you can provide any valid python expression between tokens ``{{`` ``}}``.\nAlso note that you can use limited subset of python ``__builtins__``.\n\nIn **mint** templates expressions can be used inside text elements and inside attributes::\n\n @p.class(title {{ doc.main_doc_class }}).id({{ doc.id }}) {{ doc.body }}\n\nAs you remember all content inserted in tags (as text) and in attributes is\nescaped by **mint**. And this is good, but sometimes you need to insert\nunescaped html. For this purpose mint uses special class ``mint.Markup``, which\nimplements ``__html__`` method (this is something like convention). To insert\nhtml inside templates you need to mark your python variables with\n``mint.Markup`` inside your python code.\n\nIn previous example if ``doc.body`` has html we need attribute ``body`` to return\n``mint.Markup(html_string)``. And that ``html_string`` will be inserted in template\nwithout escaping. That is the preferred way to insert markup inside html template.\n\nAlso note that there are two contexts to insert markup - tag and attribute.\nIn case of tag ``mint.Markup`` instances will be inserted without modifications.\nBut if you attemted to insert markup in attribute it will be additionaly escaped.\n\nFor example we have such python code::\n\n class Doc(object):\n def __init__(self, title, body):\n self.title = mint.Markup(title)\n self.body = mint.Markup(body)\n\n doc = Doc('title', 'content of document
')\n\nAnd such template::\n\n @div.class(doc)\n @p.class(title).title({{ doc.title }}) {{ doc.title }}\n {{ doc.body }}\n\nThe result will be::\n\n\n title\n
\ncontent of document
\nHere we have title
\n @p.class(title) Here we have title\n\n\n.. _simplification:\n\nsimplification\n--------------\n\nSimplification of syntax provides ambiguity. But it is very handy sometimes.\nIn **mint** templates you can write such things::\n\n @ul\n #for image in images:\n @li.class(image) @img.alt().src({{ image.path }})\n\nThis simplification alows to write nested tags in one line, one by one. In\nprevious example all ``img`` tags will be inside ``li``.\n\nRemember rule #1: This records::\n\n @div.id(1) @div.id(2) @div.id(3)\n\n @div.id(1)\n @div.id(2) @div.id(3)\n\n @div.id(1)\n @div.id(2)\n @div.id(3)\n\nare the same.\n\nRule #2: you can append text to and only to last tag when you use syntax\nsimplification::\n\n @ul\n #for doc in docs:\n @li @p.class(title) {{ doc.title }}\n @p.class(descr) {{ doc.description }}\n\n``li`` will be rendered as::\n\n...
\n...
\n...