summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--TWiki/TWikiVariables.mdwn14
1 files changed, 9 insertions, 5 deletions
diff --git a/TWiki/TWikiVariables.mdwn b/TWiki/TWikiVariables.mdwn
index e4ed80d8..96effd9e 100644
--- a/TWiki/TWikiVariables.mdwn
+++ b/TWiki/TWikiVariables.mdwn
@@ -1,10 +1,14 @@
%TOC% %STARTINCLUDE%
-## <a name="TWiki_Variables"> TWiki Variables </a>
+# <a name="TWiki_Variables"> TWiki Variables </a>
+
+_Text strings expanded on the fly include predefined, preference-driven and custom-defined data_
+
+## <a name="Overview"> Overview </a>
TWikiVariables are text strings enclosed in percentage signs: <code>**%VARIABLE%**</code> that represent stored data. When a topic is rendered for viewing, defined variables are replaced by their actual values. TWiki has two types of variable, predefined and Preference-based, where usually you determine the content. Through Preference variables, you can also define custom variables, creating new variable name and value. TWiki variables are as simple to use as they are powerful, and vice versa!
-### <a name="Predefined_Variables"> Predefined Variables </a>
+## <a name="Predefined_Variables"> Predefined Variables </a>
With a couple of notable exceptions, predefined variables return set values that are defined one-time on installation and left alone. Most are directory names and file paths, customized for your server, and only have to be updated once in the main configuration file if your server set-up changes.
@@ -421,7 +425,7 @@ With a couple of notable exceptions, predefined variables return set values that
>
> [2] **_Note_**: A web can be excluded from a `web="all"` search if you define a `NOSEARCHALL=on` variable in its %WEBPREFSTOPIC%.
-### <a name="Preferences_Variables"> Preferences Variables </a>
+## <a name="Preferences_Variables"> Preferences Variables </a>
Additional variables are defined in the preferences ( site-level ( **_SL_** ) in %TWIKIWEB%.%WIKIPREFSTOPIC%, web-level ( **_WL_** ) in %WEBPREFSTOPIC% of each web, and user level ( **_UL_** ) preferences in individual user topics):
@@ -560,12 +564,12 @@ Additional variables are defined in the preferences ( site-level ( **_SL_** ) in
<td> List of preferences that are not allowed to be overridden by next level preferences</td>
</tr></font></font></table>
-### <a name="Setting_Preferences"> Setting Preferences </a>
+## <a name="Setting_Preferences"> Setting Preferences </a>
* The syntax for Preferences variables is the same anywhere in TWiki. In Edit mode, from the start of a new line: <br />[6 spaces] \* [space] Set [space] VARIABLENAME [space] = [value] <br />**_Example:_**
* <code>**Set VARIABLENAME = value**</code>
-### <a name="Creating_Custom_Variables"> Creating Custom Variables </a>
+## <a name="Creating_Custom_Variables"> Creating Custom Variables </a>
* You can add your own preference variables for an entire site, a single web, or a single topic, using the standard syntax. Whatever you include in your variable will be expanded on display, and treated exactly as if it had been written out. So you can place formatted text, page links, image paths.