| 1 | = Comparing Markup to Kid = |
| 2 | |
| 3 | The [wiki:MarkupTemplates template engine] in Markup was heavily inspired by Kid (http://kid-templating.org). |
| 4 | |
| 5 | Common concepts and features: |
| 6 | * The same basic set of directives (excluding `py:extends` and `py:layout`) |
| 7 | * Inline expressions using the `${expr}` (or just `$expr`) syntax. |
| 8 | * Expressions are real Python code, not some “crippled” mini language. |
| 9 | * Stream-based processing model making heavy use of Python generators. |
| 10 | * Different serialization methods, for example to produce XML or HTML output. |
| 11 | |
| 12 | Differences include: |
| 13 | * No generation of Python code for a template; the template is executed directly. |
| 14 | * No support for `<?python ?>` processing instructions |
| 15 | * Expressions are evaluated in a more flexible manner, meaning you can use e.g. dotted notation to access items in a dictionary, and the other way around (see the [source:/trunk/markup/eval.py markup.eval] module) |
| 16 | * Proper scoping of variables. Names do not leak into outer scopes. |
| 17 | * Use of XInclude and match templates instead of Kid's `py:extends` / `py:layout` directives |
| 18 | * `py:match` directives use (basic) XPath expressions to match against input nodes, making match templates more powerful while keeping the syntax simple (see the [source:/trunk/markup/path.py markup.path] module) |
| 19 | * Real (thread-safe) search path support |
| 20 | * No dependency on ElementTree (due to the lack of position reporting) |
| 21 | * The original location of parse events is kept throughout the processing pipeline, so that errors can be tracked back to a specific line/column in the template file |
| 22 | * In simple tests (see [source:/trunk/examples/basic examples/basic]) the rendering phase (i.e. not including parsing/compilation) runs about twice as fast compared to Kid. Parsing is generally quite a bit faster in Markup, too. |