Template Explanation
Conceptual deep dives into CyanPrint template architecture
Template Explanation
Understanding the concepts and architecture behind CyanPrint templates.
Core Concepts
Configuration
Cyan Configuration Object
Understanding the structure returned by templates
Default Processor
How the cyan/default processor works with Eta templating
Determinism
Determinism
How reproducible generation works
Client State
Managing state across executions
3-Way Merge
How template updates preserve user changes
Architecture
Container Paths
Path mechanics in template containers
Processors vs Plugins
When to use each
Docker vs Cyan Registry
Registry comparison
Conceptual Overview
Key Questions
Why var__name__ syntax?
The var__name__ syntax avoids conflicts with common template syntaxes like ${} or {{}}. See Default Processor.
How do updates work?
3-way merge combines the original template, user changes, and new template version. See 3-Way Merge.
How are IDs consistent?
The pin system seeds deterministic value generation. See Determinism.
When to use processors vs plugins?
Processors transform files; plugins execute actions. See Processors vs Plugins.