![]() |
VWcms | Substitution |
• Substitution • Site Map |
The site template is parsed by VWcms, with all content other than that surrounded by double dollar symbols (i.e. $$) output as-is. The dollar-delimited strings are known as substitution directives and represent content generated by VWcms and inserted in place of the directive. Substitution directive names are case-insensitive, though generally shown upper-case to more easily distinguish them from surrounding HTML. Some take optional parameters (case sensitivity is dependent on the parameter), each separated by a single delimiting dollar symbol (see examples). Substitution is supported in both template and HTML content, though the exact directives differ. These are the template directives:
**See further explanation below. TimesDirectives substituting a time string (e.g. $$LASTMOD$$) have a default format the same as displayed at the bottom of this page, and can take an optional, dollar-separated parameter, specifying an alternate strftime() format string. Alternate TextThose directives that have an alternate text parameter generally provide visible text or a link in the content of the page. Generally they have a default string associated with them but allow an alternate to be specified. This not only allows customisation of the various elements of the page but also allows for non- English language pages to be composed. SearchThe $$SEARCH$$ directive inserts a search-for dialog comprising a text input field and a submit button immediately adjacent to it. The (on-screen) size of the text field can be specified as an optional dollar-delimited parameter, then an alternate label for the submit button as another option. In this way the overall width of the search dialog can be adjusted according to the space available at the location. The VWcms print facility provides three levels
These can be seen in the menu to the left of this text as Print+ (Site) and are generated by the substitution directives: $$PRINT$$$$PRINT$1$+$$ ($$PRINT$9$Site$$) where the first, parameterless directive ($0 is a synonym) generates a current section print, the second with $1 generates the current/subordinate print, and the $9 parameter the full site print. Table of ContentThe $$TOC$$ directive provides a method for navigating the site. The default, seen to the left of this page, generates a list of all major sections of the document along with an expanded list of any subordinate sections of the currently open section. This format is suitable for designs where there is significant vertical space, as with the left hand column of this page. There are some variations available within the TOC.
An alternate table of content is available using the $$TOC$DROP$$ directive. This produces a site navigation facility in drop-down list (via an HTML form <SELECT><OPTION> dialog. This is designed for spaces that are vertically constrained. It too takes optional parameter(s).
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||