Docs

Directivas

Una directiva es una instrucción con nombre y argumentos opcionales. Es la unidad básica de un documento DON.

Sintaxis

directive_name arg1 arg2 argN

Nombre

El nombre debe ser un identifier válido.

Argumentos

Pueden ser identifiers, strings, números, booleanos o null, separados por espacios. Una directiva termina con un salto de línea.

name "my-app"
version "1.0.0"
port 8080
enabled true
deprecated null

Bloques

Una directiva puede agrupar subdirectivas con llaves. Los bloques se pueden anidar con profundidad arbitraria.

server {
  host "example.com"
  port 443

  route /api/* {
    handler "apiHandler"
    timeout 30
  }
}

• El espacio antes de { es opcional: foo{ es válido.
• El espacio después de } es opcional.
• Tras la llave de cierre no puede haber más tokens en la misma línea (excepto saltos de línea).

container { image "nginx" }
container { image "nginx" } extra  # Error

Indentación

La indentación no es significativa para el parseo; es solo estilística. La única excepción son los heredocs, donde la indentación delimita el contenido.