+## <a name="TWiki Variables"></a> TWiki Variables
+
+### <a name="Predefined Variables"></a> Predefined Variables
+
%WIKITOOLNAME% expands the following variables enclosed in % percent signs:
<table border="1">
<td> The path of the attachment URL of the current topic, is <b>http://www.dementia.org/twiki//view</b></td>
</tr>
<tr>
+ <td><code>%URLPARAM{"name"}%</code></td>
+ <td> Returns the value of a URL parameter. I.e. <code>%URLPARAM{"skin"}%</code> returns <b>print</b> for a <code>.../view/%WEB%/%TOPIC%?skin=print</code> URL. Is <b></b></td>
+ </tr>
+ <tr>
<td><code>%WIKITOOLNAME%</code></td>
<td> Name of wiki tool, is <b>%WIKITOOLNAME%</b></td>
</tr>
<td> The current web, is <b>%WEB%</b></td>
</tr>
<tr>
+ <td><code>%BASEWEB%</code></td>
+ <td> The web name where the includes started, e.g. the web of the first topic of nested includes. Same as <code>%WEB%</code> in case there is no include. </td>
+ </tr>
+ <tr>
+ <td><code>%INCLUDINGWEB%</code></td>
+ <td> The web name of the topic that includes the current topic. Same as <code>%WEB%</code> in case there is no include. </td>
+ </tr>
+ <tr>
<td><code>%TOPIC%</code></td>
<td> The current topic name, is <b>%TOPIC%</b></td>
</tr>
<tr>
+ <td><code>%BASETOPIC%</code></td>
+ <td> The name of the topic where the includes started, e.g. the first topic of nested includes. Same as <code>%TOPIC%</code> in case there is no include. </td>
+ </tr>
+ <tr>
+ <td><code>%INCLUDINGTOPIC%</code></td>
+ <td> The name of the topic that includes the current topic. Same as <code>%TOPIC%</code> in case there is no include. </td>
+ </tr>
+ <tr>
<td><code>%SPACEDTOPIC%</code></td>
<td> The current topic name with added spaces, for regular expression search of Ref-By, is <b></b></td>
</tr>
<tr>
+ <td><code>%TOPICLIST{"format"}%</code></td>
+ <td> Topic index of a web. Parameter is composed of the format, followed by an optional <code>web="Name"</code>. The <code>"format"</code> defines the format of one topic item; use it to create any formatting you need. The <code>$name</code> variable is expanded to the topic name; the <code>$web</code> variable is expanded to the name of the web. Examples: <br /><code>%TOPICLIST{" * $web.$name"}%</code> creates a bullet list of all topics. <br /><code>%TOPICLIST{" <option>$name</option>"}%</code> creates an option list (for drop down menus). </td>
+ </tr>
+ <tr>
+ <td><code>%WEBLIST{"format"}%</code></td>
+ <td> Web index, e.g. list of all webs. Hidden webs are excluded, e.g. webs with a <code>NOSEARCHALL=on</code> preference variable. The <code>"format"</code> defines the format of one web item. The <code>$name</code> variable is expanded to the name of the web. Example: <br /><code>%WEBLIST{" * [[$name.WebHome]]"}%</code> creates a bullet list of all webs. </td>
+ </tr>
+ <tr>
<td><code>%GMTIME%</code></td>
- <td> GM time, is <b>29 Jun 2010 - 15:25</b></td>
+ <td> GM time, is <b>29 Jun 2010 - 15:26</b></td>
</tr>
<tr>
<td><code>%GMTIME{"format"}%</code></td>
- <td> Formatted GM time based on keywords (first three characters needed.) <br /> Example: <code>%GMTIME{"day month, year - hour:min:sec"}%</code> is <b>day month, year - hour:min:sec</b></td>
+ <td> Formatted GM time based on time variables. <table border="1" cellpadding="0" cellspacing="0">
+ <tr>
+ <th bgcolor="#99CCCC"><strong> Variable: </strong></th>
+ <th bgcolor="#99CCCC"><strong> Unit: </strong></th>
+ <th bgcolor="#99CCCC"><strong> Example </strong></th>
+ </tr>
+ <tr>
+ <td> $seconds </td>
+ <td> seconds </td>
+ <td> 59 </td>
+ </tr>
+ <tr>
+ <td> $minutes </td>
+ <td> minutes </td>
+ <td> 59 </td>
+ </tr>
+ <tr>
+ <td> $hours </td>
+ <td> hours </td>
+ <td> 23 </td>
+ </tr>
+ <tr>
+ <td> $day </td>
+ <td> day of month </td>
+ <td> 31 </td>
+ </tr>
+ <tr>
+ <td> $month </td>
+ <td> month in ISO format </td>
+ <td> Dec </td>
+ </tr>
+ <tr>
+ <td> $mo </td>
+ <td> 2 digit month </td>
+ <td> 12 </td>
+ </tr>
+ <tr>
+ <td> $year </td>
+ <td> 4 digit year </td>
+ <td> 1999 </td>
+ </tr>
+ <tr>
+ <td> $ye </td>
+ <td> 2 digit year </td>
+ <td> 99 </td>
+ </tr>
+ </table> Variables can be shortened to 3 characters. Example: <br /><code>%GMTIME{"$day $month, $year - $hour:$min:$sec"}%</code> is <br /><b>29 Jun, 2010 - 15:26:32</b></td>
</tr>
<tr>
<td><code>%SERVERTIME%</code></td>
- <td> Server time, is <b>29 Jun 2010 - 11:25</b></td>
+ <td> Server time, is <b>29 Jun 2010 - 11:26</b></td>
</tr>
<tr>
<td><code>%SERVERTIME{"format"}%</code></td>
- <td> Formatted server time. Example: <code>%SERVERTIME{"hou:min"}%</code> is <b>hou:min</b></td>
+ <td> Formatted server time. <br /> Example: <code>%SERVERTIME{"$hou:$min"}%</code> is <b>11:26</b></td>
</tr>
<tr>
<td><code>%HTTP_HOST%</code></td>
<td> If present in included topic, stop to include text at this location and ignore the remaining text. A normal view of the topic shows everyting exept the <code>%STOPINCLUDE%</code> variable itself. </td>
</tr>
<tr>
+ <td><code>%TOC%</code></td>
+ <td> Table of Content of current topic. </td>
+ </tr>
+ <tr>
+ <td><code>%TOC{"SomeTopic" ...}%</code></td>
+ <td> Table of Content. Shows a TOC that is generated automatically based on headings of a topic. Headings in [[Main/WikiSyntax]] (<code>"---++ text"</code>) and HTML (<code>"<h2>text<h2>"</code>) are taken into account. Parameter is composed of the topic name, followed by optional <code>name="value"</code> pairs: <table border="1" cellpadding="0" cellspacing="0">
+ <tr>
+ <th bgcolor="#99CCCC"><strong> Pair: </strong></th>
+ <th bgcolor="#99CCCC"><strong> Description: </strong></th>
+ <th bgcolor="#99CCCC"><strong> Default: </strong></th>
+ </tr>
+ <tr>
+ <td><code>web="Name"</code></td>
+ <td> Name of web </td>
+ <td> Current web </td>
+ </tr>
+ <tr>
+ <td><code>depth="2"</code></td>
+ <td> Limit depth of headings shown in TOC </td>
+ <td> 6 </td>
+ </tr>
+ </table> Examples: <code><b>%TOC{depth="2"}%</b></code>, <code><b>%TOC{"TWikiDocumentation" web="TWiki"}%</b></code></td>
+ </tr>
+ <tr>
<td><code>%SEARCH{"str" ...}%</code></td>
- <td> Inline search, shows a search result embedded in a topic. Parameter is composed of the search string, followed by optional <code>name="value"</code> pairs: <table border="1" cellpadding="0" cellspacing="0">
+ <td> Inline search, shows a search result embedded in a topic. Parameter is composed of the search term (enclosed in double quotes), followed by optional <code>name="value"</code> pairs: [1] <table border="1" cellpadding="0" cellspacing="0">
<tr>
<th bgcolor="#99CCCC"><strong> Pair: </strong></th>
<th bgcolor="#99CCCC"><strong> Description: </strong></th>
<th bgcolor="#99CCCC"><strong> Default: </strong></th>
</tr>
<tr>
+ <td><code>search="food"</code></td>
+ <td> Search term, (either regex or literal, depending on the <code>regex</code> parameter) </td>
+ <td> (used if initial search term is missing) </td>
+ </tr>
+ <tr>
<td><code>web="Name"</code><br /><code>web="Main Know"</code><br /><code>web="all"</code></td>
- <td> Wiki web to search: A web, a list of webs separated by whitespace, or all webs <code>[1]</code></td>
+ <td> Wiki web to search: A web, a list of webs separated by whitespace, or all webs <code>[2]</code></td>
<td> Current web </td>
</tr>
<tr>
</tr>
<tr>
<td><code>noheader="on"</code></td>
- <td> Suppress search header <br /><span style="background: #FFB0B0">Topics: Changed: By: </span></td>
+ <td> Suppress search header <br /><span style="background: #FFB0B0"> <strong>Topics: Changed: By:</strong> </span></td>
<td> Show search header </td>
</tr>
<tr>
</tr>
<tr>
<td><code>%VAR{"NAME" web="Web"}%</code></td>
- <td> Get a preference value from another web then the current one. Example: To get <code>%WEBBGCOLOR%</code> of the Main web write <code>%VAR{"WEBBGCOLOR" web="Main"}%</code>, is <code><b></b></code></td>
+ <td> Get a preference value from a web other then the current one. Example: To get <code>%WEBBGCOLOR%</code> of the Main web write <code>%VAR{"WEBBGCOLOR" web="Main"}%</code>, is <code><b></b></code></td>
<td>
<p>
</p>
</tr>
</table>
-[1] **_Note_**: A web can be excluded from a `web="all"` search if you define a `NOSEARCHALL=on` variable in its [[WebPreferences]].
+[1] **_Note_**: The search form uses identical names for input fields.
+
+[2] **_Note_**: A web can be excluded from a `web="all"` search if you define a `NOSEARCHALL=on` variable in its [[WebPreferences]].
+
+### <a name="Preferences Variables"></a> Preferences Variables
Additional variables are defined in the preferences ( site-level ( **_SL_** ) in [[TWikiPreferences]], web-level ( **_WL_** ) in [[WebPreferences]] of each web, and user level ( **_UL_** ) preferences in individual user topics):
- Additional preferences variables can be defined on all three level as needed. Example:
- `Set MYLOGO = %PUBURLPATH%/%MAINWEB%/LogoTopic/logo.gif`
--- [[PeterThoeny]] - 10 Nov 2000 <br />
+-- [[PeterThoeny]] - 24 Mar 2001 <br />
git://git.openafs.org / openafs-wiki.git / blobdiff