From 17403f0a9b7167c635514c1e3d9d25ebad4b12e2 Mon Sep 17 00:00:00 2001 From: Greg Kaleka Date: Tue, 3 Jul 2018 17:16:52 -0700 Subject: [PATCH] Doc'd that template variables & attributes may not start with an underscore. --- docs/ref/templates/language.txt | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/docs/ref/templates/language.txt b/docs/ref/templates/language.txt index c6ce3b3dfd..a10cfde03b 100644 --- a/docs/ref/templates/language.txt +++ b/docs/ref/templates/language.txt @@ -82,10 +82,10 @@ Variables Variables look like this: ``{{ variable }}``. When the template engine encounters a variable, it evaluates that variable and replaces it with the result. Variable names consist of any combination of alphanumeric characters -and the underscore (``"_"``). The dot (``"."``) also appears in variable -sections, although that has a special meaning, as indicated below. -Importantly, *you cannot have spaces or punctuation characters in variable -names.* +and the underscore (``"_"``) but may not start with an underscore. The dot +(``"."``) also appears in variable sections, although that has a special +meaning, as indicated below. Importantly, *you cannot have spaces or +punctuation characters in variable names.* Use a dot (``.``) to access attributes of a variable. @@ -124,6 +124,9 @@ Note that "bar" in a template expression like ``{{ foo.bar }}`` will be interpreted as a literal string and not using the value of the variable "bar", if one exists in the template context. +Variable attributes that begin with an underscore may not be accessed as +they're generally considered private. + Filters =======