Skip to content

Enhancing documentation about filters #211

Open
@sqlalchemy-bot

Description

@sqlalchemy-bot

Migrated issue, originally created by Anonymous

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.

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions