Namespaces

Namespaces allow separation of variables with the same name. This is most useful for functions that create variables on the fly (e.g. section).

Templates have two namespaces, one is called the root namespace and defines the global namespace for one template, the other is the current namespace. The current namespace will start out being the same as the root but will change when a function is used which has namespace support. The current namespace is used by functions to create new variables and avoid clashes, while the root namespace is used to lookup the correct variable.

The following table displays how the root and current namespace behaves.

{$variable}

{section name=Space}

  {$variable}

  {$First:Space:item}

  {section name=Room}

    {$First:Space:Room:item}

  {/section}

{/section}

Relative and absolute addressing

To address a variable in the current namespace, you can use a $: (dollar colon). Use $# (dollar hash) to address a variable in the root namespace (absolute addressing).

{let var='hi all!'}
  {section name=Space}
    {* Local namespace *}
    {$Space:item.first}
    {* Also local namespace *}
    {$:item.first}
    {* Root namespace *}
    {$#var}
  {/section}
{/let}