Basics

Go templates use{{ ... }} to embed expressions, variables, or functions.

Data Context (.)

The dot . refers to the current context. In rong, this includes:

• .Colors — a list of all material colors
• .Image — the source image or video path
• .<ColorName> — individual color values (e.g., .Background)

{{ .Background }}  {{/* Prints a hex color like "RRGGBB" */}}

Comments

Use {{/* ... */}} for comments.

{{/* This is a comment */}}

Loops

Use range to iterate over a slice or map.

{{ range .Colors }}
  {{ .Name.Snake }} = "{{ .Color }}"
{{ end }}

You can also use an index variable:

{{ range $i, $color := .Colors }}
  {{ $i }}: {{ $color.Name.Camel }}
{{ end }}

Conditionals

Use if, else, and end to control logic.

{{ if .Background }}
  Background: {{ .Background }}
{{ else }}
  No background color provided.
{{ end }}

You can nest conditions:

{{ if and .Background .Image }}
  Background and image are both available.
{{ end }}

Functions

Standard functions like index, print, and printf are supported. rong also adds:

• upper, lower — changes string case
• replace — replaces parts of a string
• quote — wraps a string in quotes
• json — outputs JSON-formatted data

Examples:

{ "image": {{ .Image | json }} }

{{ replace .Title " " "_" | upper }}

{{ quote .Background }}

{{ printf "%s: %s" .Name .Value }}

Pipelining

You can chain multiple functions using the pipe |.

{{ .Primary | lower | quote }}