Glossary of terms

Template

A reusable layout or structure that defines how a card should be rendered.

Analogy: Email template, CMS page template.

Fields

Named input values that the user fills out when creating or editing a card.

Examples: word, meaning, example_sentence, image, etc.

Placeholders

Inline markers inside the template that get replaced by the card’s field values when rendered.

Rendered Card (or Output)

Definition: The final card after the template has been evaluated and all placeholders replaced with field data.

Template Fields vs. Card Fields

It is important to differentite these:

Template Fields

Fields defined by the template (the schema).

Card Fields

Field values entered by the user for a specific card instance.

Template Schema

The structured definition of which fields exist and what types they are (text, image, TTS, etc.).

Template Engine

The internal system that reads a template, substitutes placeholders, and produces the final output.