Kommentare

1. Unterschiede bei Template‑Kommentaren

Syntax	Typ	Eigenschaften
<!-- HTML‑Kommentar -->	Nativer HTML‑Kommentar	Wird im finalen Quellcode der Webseite ausgegeben, im Browser‑Quellcode sichtbar
## Einzeiliger Kommentar	Velocity‑Einzeilkommentar	Nur vom Engine erkannt, nicht auf der Seite ausgegeben, gültig bis Zeilenende
#* Mehrzeiliger Kommentarinhalt *#	Velocity‑Mehrzeilkommentar	Unterstützt Zeilenumbrüche, nicht auf der Seite ausgegeben

Entwicklungshinweis: Nutze für fachliche Code‑Kommentare vorzugsweise ## / #* *#, damit Kommentare nicht im Seitenquellcode auftauchen.

2. Regeln für Variablennamen

Offizielle Grundregeln zur Namensgebung

1. Das erste Zeichen einer Variable muss ein Buchstabe sein (a‑z / A‑Z)
2. Erlaubte Folgezeichen: Buchstaben, Ziffern 0‑9, Unterstrich _, Bindestrich -

Bindestrich - sorgt für Operator‑Mehrdeutigkeit

#set($name-d = "test")Code-Sprache: PHP (php)

Bei der Ausführung tritt folgender Fehler auf: Encountered "name" ... Was expecting one of:
Grund: Velocity interpretiert - als Subtraktionsoperator!
Der Engine parst es als $name - d, also Variable $name minus Variable d und erzeugt damit einen Syntaxkonflikt.

Zwei Lösungsansätze:

1. Empfohlen: Benennung mit Unterstrich (keine Mehrdeutigkeit, gängige Konvention)

#set($name_d = "hello world")Code-Sprache: PHP (php)

2. Variablengrenze mit geschweiften Klammern festlegen (unterstützt Namen mit Bindestrich)

#set(${name-d} = "hello world")
${name-d}Code-Sprache: PHP (php)

Gültige / ungültige Beispiele im Vergleich

# ✅ gültig
#set($name_d = "Unterstrich")
#set($name12d = "Buchstabe gefolgt von Zahlen")
#set(${name-1_2d} = "Bindestrich erfordert geschweifte Klammern")

# ❌ Direkter Bindestrich ohne Klammern → Parse‑Fehler
#set($name-d = "Fehler!")
#set($name-1_2d = "Fehler!")Code-Sprache: PHP (php)

3. Schreibregeln für die #set‑Syntax

Standard‑Schreibweise (Leerzeichen um Klammern sind flexibel, einheitlicher Stil empfohlen)

#set($Variablenname = "Wert")Code-Sprache: PHP (php)

Zeichenketten müssen in doppelte Anführungszeichen gesetzt werden. Leerzeichen um das Gleichheitszeichen verbessern die Lesbarkeit.

Kommentare