Enhancing documentation about filters

Issue #211 new
created an issue

Mako provide cool filters, but I think documentation can be enhanced explaining, in HTML, where to use which filter. I mean, how to filter this :

   ${val1} <${val2} src="${val3}"/>

I was searching the right way to escape values of attributes, and got hard times to find it, Typically I'm a backend developper, not a front end, so I know that things has to be contextually escaped, but I don't exactly know which method escapes for which context.

So, presenting flags in http://docs.makotemplates.org/en/latest/filtering.html as a table, with 'name', 'explanation', 'usage contexts', 'example' should be usefull.

Comments (0)

  1. Log in to comment