Comentarios

1. Diferencias entre comentarios de plantilla

Sintaxis	Tipo	Características
<!-- Comentario HTML -->	Comentario nativo HTML	Se muestra en el código fuente final de la página, visible al ver el código desde el navegador
## Comentario de una línea	Comentario de una línea Velocity	Solo reconocido por el motor, no se renderiza en la página, válido hasta el final de la línea
#* Contenido comentario multilínea *#	Comentario multilínea Velocity	Admite saltos de línea, no se renderiza en la página

Recomendación de desarrollo: usa preferiblemente ## / #* *# para comentarios de lógica de negocio, evitando filtrar comentarios en el código fuente de la página.

2. Reglas de nomenclatura de variables

Reglas básicas oficiales

1. El primer carácter de la variable debe ser una letra (a‑z / A‑Z)
2. Caracteres permitidos después: letras, números 0‑9, guion bajo _, guion -

El guion - genera ambigüedad con operadores

#set($name-d = "test")Lenguaje del código: PHP (php)

Al ejecutar salta el error: Encountered "name" ... Was expecting one of:
Causa: Velocity interpreta - como operador de resta!
El motor lo analiza como $name - d, es decir variable $name menos variable d, generando conflicto sintáctico.

Dos soluciones:

1. Recomendado: usar guion bajo (sin ambigüedad, convención habitual)

#set($name_d = "hello world")Lenguaje del código: PHP (php)

2. Delimitar variable con llaves (compatible con nombres que contienen guion)

#set(${name-d} = "hello world")
${name-d}Lenguaje del código: PHP (php)

Comparativa ejemplos válidos / inválidos

# ✅ Válido
#set($name_d = "guion bajo")
#set($name12d = "empieza por letra más números")
#set(${name-1_2d} = "guion requiere llaves")

# ❌ Guion directo sin llaves → error de análisis
#set($name-d = "¡Error!")
#set($name-1_2d = "¡Error!")Lenguaje del código: PHP (php)

3. Normas de escritura para la sintaxis #set

Forma estándar (espacios alrededor de paréntesis flexibles, se recomienda mantener un estilo uniforme)

#set($nombreVariable = "valor")Lenguaje del código: PHP (php)

Las cadenas deben ir entre comillas dobles; mantén espacios alrededor del signo igual para mejorar la legibilidad.

Comentarios