Templates

Information: To use the new template engine (DotLiquid) you need to enable UseLiquidTemplates. The old T4 templates and the UseLiquidTemplates setting will be removed soon.

Settings (available for all code generators):

• UseLiquidTemplates (default: false, setting will be removed as soon as templates work as expected)
• TemplateDirectory: Location where template overrides are located (you should override only empty/extension templates).

Default Templates:

• CSharp templates
  • Extension templates:
    • Class.Annotations
    • Class.Constructor
    • Class.Property.Annotations
• TypeScript templates
  • Extension templates:
    • none (please create issue for new extension templates)

Template types:

• Extension templates (i.e. empty templates): Can be safely overwritten
• Internal templates (i.e. templates with content): Should be only overwritten for bugfixing (please provide a PR) or when also inserting the original template with {% template %}

Tags:

• {% template Foo.Bar %}: Inserts a template with the same indentation of all lines as the tag
• {% template %}: Inserts the original template into an overridden template

Filters:

• {{ foo | tab: 3 }}
• {{ bar | CSharpDocs: 2 }}

Control blocks (if/for/etc.):

• Either use on one line (without -): foo{% if condition %}bar{% endif %}baz
• ... or on multiple lines (with - at the end):

foo
{% if condition -%}
bar
{% endif -%}
baz

• Use other forms only if really needed (breaks consistency)

Visual Studio

DotLiquid templates

TextMate

copy to %USERPROFILE%\.vs\Extensions\

https://github.com/Shopify/liquid-tmbundle

https://github.com/RSuter/NSwag/issues/263

rename to liquid.plist