> > | TWiki Variables Quickstart
TWiki Variables are names that are enclosed in percent signs % that are expanded on the fly. Some variables take arguments, such as %INCLUDE% . For those variables, the arguments are included in curly braces ({ and }).
Variable |
In brief |
Full documentation |
%TOC% |
Automatically generates a table of contents based on headings in a topic - see the top of this page for an example. |
VarTOC |
%WEB% |
The current web, is TWiki. |
VarWEB |
%TOPIC% |
The current topic name, is TWikiVariablesQuickStart. <-- using BASETOPIC instead of TOPIC for the example because this document is normally included in TextFormattingRules --> |
VarTOPIC |
%ATTACHURL% |
The attachment URL of the current topic. Example usage: If you attach a file to a topic you can refer to it as %ATTACHURL%/image.gif to show the URL of the file or the image in your text. |
VarATTACHURL |
%INCLUDE{"SomeTopic"}% |
Server side include, includes another topic. The current web is the default web. Example: %INCLUDE{"TWiki.SiteMap"}% |
VarINCLUDE |
%SEARCH{"sushi"}% |
Inline search showing the search result embedded in a topic. FormattedSearch gives you control over formatting, useful for creating web-based applications. |
VarSEARCH |
TWikiPreferences defines some site-wide variables. Among them are:
- Line break: Write
%BR% to start a new line.
- Colored text: Write:
%RED% Red %ENDCOLOR% and %BLUE% blue %ENDCOLOR% colors to get: Red and blue colors.
There are many more variables. To see them all, go to TWikiVariables.
Documentation Graphics: There are many graphics available to use in your topics. Use %ICON{"help"}% , %ICON{"tip"|% , and %icon{"warning"}% to get: , , and . To see all of the graphics available, see TWikiDocGraphics.
To "escape" a variable, prefix it with an exclamation mark. Write: !%SOMEVARIABLE% to get: %SOMEVARIABLE%. |