decocms/studio/templating

templating — fill data into text-file templates

Render any text file (HTML, markdown, config, SQL, email, …) from a mustache template plus JSON data. Use this whenever the shape of an output is known ahead of time and only the values change — it is faster and less error-prone than writing the file by hand.

Other skills build on this one (e.g. slides composes presentation decks from slide templates).

Quick reference

The command prints the absolute output path on success and exits non-zero with a message on any error (bad JSON, missing template, existing output without -f, missing keys under --strict).

Template syntax (mustache)

Example:

<ul>
  {{#items}}<li><b>{{label}}</b>: {{value}}</li>{{/items}}
  {{^items}}<li>No items</li>{{/items}}
</ul>

create-from-template --template list.template.html \
  --data '{"items":[{"label":"CPU","value":"42%"}]}' \
  --output list.html

Workflow tips

• Keep data in a JSON file (--data @data.json) when it is more than a

couple of fields — easier to iterate on than a long inline string.

• Use --strict while developing a template to catch typos in key names;

drop it when optional keys are intentional.

• Templates are plain text files — author your own anywhere (the org home

folder under /app/org/home/templates/ is a good durable place for organization-wide templates).