none
[openafs-wiki.git] / TWiki / TWikiVariables.mdwn
index 3fd35dc..bd00367 100644 (file)
@@ -1,4 +1,4 @@
-TWiki expands the following variables enclosed in % percent signs:
+%WIKITOOLNAME% expands the following variables enclosed in % percent signs:
 
 <table border="1">
   <tr>
@@ -7,15 +7,19 @@ TWiki expands the following variables enclosed in % percent signs:
   </tr>
   <tr>
     <td><code>%WIKIHOMEURL%</code></td>
-    <td> The base script URL of TWiki, link of Home icon in upper left corner, is <b>%WIKIHOMEURL%</b></td>
+    <td> The base script URL of %WIKITOOLNAME%, is the link of the Home icon in the upper left corner, is <b>%WIKIHOMEURL%</b></td>
   </tr>
   <tr>
     <td><code>%SCRIPTURL%</code></td>
-    <td> The script URL of TWiki, is <b>http://www.dementia.org/twiki/</b></td>
+    <td> The script URL of %WIKITOOLNAME%, is <b>http://www.dementia.org/twiki/</b></td>
   </tr>
   <tr>
     <td><code>%SCRIPTURLPATH%</code></td>
-    <td> The path of the script URL of TWiki, is <b>http://www.dementia.org/twiki/</b></td>
+    <td> The path of the script URL of %WIKITOOLNAME%, is <b>http://www.dementia.org/twiki/</b></td>
+  </tr>
+  <tr>
+    <td><code>%SCRIPTSUFFIX%</code></td>
+    <td> The script suffix, i.e. <code>.pl</code>, is <b></b></td>
   </tr>
   <tr>
     <td><code>%PUBURL%</code></td>
@@ -23,7 +27,7 @@ TWiki expands the following variables enclosed in % percent signs:
   </tr>
   <tr>
     <td><code>%PUBURLPATH%</code></td>
-    <td> The path of the public URL of TWiki, is <b>http://www.dementia.org/twiki//view</b></td>
+    <td> The path of the public URL of %WIKITOOLNAME%, is <b>http://www.dementia.org/twiki//view</b></td>
   </tr>
   <tr>
     <td><code>%ATTACHURL%</code></td>
@@ -58,8 +62,24 @@ TWiki expands the following variables enclosed in % percent signs:
     <td> The current topic name, is <b>%TOPIC%</b></td>
   </tr>
   <tr>
-    <td><code>%DATE%</code></td>
-    <td> Todays date, is <b>29 Jun 2010</b></td>
+    <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>%GMTIME%</code></td>
+    <td> GM time, is <b>29 Jun 2010 - 15:25</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>
+  </tr>
+  <tr>
+    <td><code>%SERVERTIME%</code></td>
+    <td> Server time, is <b>29 Jun 2010 - 11:25</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>
   </tr>
   <tr>
     <td><code>%HTTP_HOST%</code></td>
@@ -78,8 +98,8 @@ TWiki expands the following variables enclosed in % percent signs:
     <td> REMOTE_USER environment variable, is <b></b></td>
   </tr>
   <tr>
-    <td><code>%INCLUDE{"file.ext"}%</code></td>
-    <td> Server side include, includes the text of a file. The default directory is the current Wiki web. Example: <code><b>%INCLUDE{"../Know/TopicName.txt"}%</b></code></td>
+    <td><code>%INCLUDE{"SomeTopic"}%</code></td>
+    <td> Server side include, includes another topic. The current Wiki web is searched by default. Example: <code><b>%INCLUDE{"TWiki.TWikiWebsTable"}%</b></code></td>
   </tr>
   <tr>
     <td><code>%SEARCH{"str" ...}%</code></td>
@@ -90,21 +110,36 @@ TWiki expands the following variables enclosed in % percent signs:
           <th bgcolor="#99CCCC"><strong> Default: </strong></th>
         </tr>
         <tr>
-          <td><code>web="Name"</code></td>
-          <td> Specify Wiki web to search </td>
+          <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> Current web </td>
         </tr>
         <tr>
-          <td><code>scope="topic"</code></td>
-          <td> Search topic name (title) </td>
+          <td><code>scope="topic"</code><br /><code>scope="text"</code></td>
+          <td> Search topic name (title) or in the text (body) of the topic </td>
           <td> Topic text (body) </td>
         </tr>
         <tr>
+          <td><code>order="topic"</code><br /><code>order="modified"</code><br /><code>order="editby"</code></td>
+          <td> Sort the results of search by the topic names, last modified time, or last editor </td>
+          <td> Sort by topic name </td>
+        </tr>
+        <tr>
+          <td><code>limit="all"</code><br /><code>limit="16"</code></td>
+          <td> Limit the number of results returned </td>
+          <td> All results </td>
+        </tr>
+        <tr>
           <td><code>regex="on"</code></td>
           <td>[[Main/RegularExpression]] search </td>
           <td> Literal search </td>
         </tr>
         <tr>
+          <td><code>reverse="on"</code></td>
+          <td> Reverse the direction of the search </td>
+          <td> Ascending search </td>
+        </tr>
+        <tr>
           <td><code>casesensitive="on"</code></td>
           <td> Case sensitive search </td>
           <td> Ignore case </td>
@@ -115,19 +150,39 @@ TWiki expands the following variables enclosed in % percent signs:
           <td> Show topic summary </td>
         </tr>
         <tr>
+          <td><code>bookview="on"</code></td>
+          <td>[[Main/BookView]] search, e.g. show complete topic text </td>
+          <td> Show topic summary </td>
+        </tr>
+        <tr>
           <td><code>nosearch="on"</code></td>
           <td> Suppress search string </td>
           <td> Show search string </td>
         </tr>
         <tr>
+          <td><code>noheader="on"</code></td>
+          <td> Suppress search header <br /><span style="background: #FFB0B0">Topics: Changed: By: </span></td>
+          <td> Show search header </td>
+        </tr>
+        <tr>
           <td><code>nototal="on"</code></td>
           <td> Do not show number of topics found </td>
           <td> Show number </td>
         </tr>
       </table> Example: <code><b>%SEARCH{"wiki" web="Main" scope="topic"}%</b></code></td>
   </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>
+      <p>
+      </p>
+    </td>
+  </tr>
 </table>
 
+[1] **_Note_**: A web can be excluded from a `web="all"` search if you define a `NOSEARCHALL=on` variable in its [[WebPreferences]].
+
 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):
 
 <table border="1">
@@ -162,6 +217,21 @@ Additional variables are defined in the preferences ( site-level ( **_SL_** ) in
     <td> Background color of web </td>
   </tr>
   <tr>
+    <td><code>%NOSEARCHALL%</code></td>
+    <td><strong><em>WL</em></strong></td>
+    <td> Exclude web from a <code>web="all"</code> search (set variable to <code>on</code> for hidden webs) </td>
+  </tr>
+  <tr>
+    <td><code>%NEWTOPICBGCOLOR%</code></td>
+    <td><strong><em>SL</em></strong> , <em>UL</em></td>
+    <td> Background color of non existing topic. ( <strong><em>UL</em></strong> needs authentication for topic views ) </td>
+  </tr>
+  <tr>
+    <td><code>%NEWTOPICFONTCOLOR%</code></td>
+    <td><strong><em>SL</em></strong> , <em>UL</em></td>
+    <td> Font color of non existing topic. ( <strong><em>UL</em></strong> needs authentication for topic views ) </td>
+  </tr>
+  <tr>
     <td><code>%EDITBOXWIDTH%</code></td>
     <td><strong><em>SL</em></strong> , <strong><em>UL</em></strong></td>
     <td> Horizontal size of edit box, is <b> <code>%EDITBOXWIDTH%</code> </b></td>
@@ -176,6 +246,53 @@ Additional variables are defined in the preferences ( site-level ( **_SL_** ) in
     <td><strong><em>SL</em></strong> , <strong><em>UL</em></strong></td>
     <td> Default state of the link check box in the attach file page. Check box is initially checked if value is set to <code>CHECKED</code> , unchecked if empty. If checked, a link is created to the attached file at the end of the topic. Value is: <b><code>%ATTACHLINKBOX%</code></b></td>
   </tr>
+  <tr>
+    <td><code>%HTTP_EQUIV_ON_VIEW%</code></td>
+    <td><strong><em>SL</em></strong></td>
+    <td> http-equiv meta tags for view, rdiff, attach, search* scripts. </td>
+  </tr>
+  <tr>
+    <td><code>%HTTP_EQUIV_ON_EDIT%</code></td>
+    <td><strong><em>SL</em></strong> , <strong><em>UL</em></strong></td>
+    <td> http-equiv meta tags for edit script. </td>
+  </tr>
+  <tr>
+    <td><code>%HTTP_EQUIV_ON_PREVIEW%</code></td>
+    <td><strong><em>SL</em></strong> , <strong><em>UL</em></strong></td>
+    <td> http-equiv meta tags for preview script. </td>
+  </tr>
+  <tr>
+    <td><code>%DENYWEBCHANGE%</code></td>
+    <td><strong><em>WL</em></strong></td>
+    <td> List of users and groups who are <strong>not allowed</strong> to change topics in the %WIKITOOLNAME% web. (More in [[Main/TWikiAccessControl]]) </td>
+  </tr>
+  <tr>
+    <td><code>%ALLOWWEBCHANGE%</code></td>
+    <td><strong><em>WL</em></strong></td>
+    <td> List of users and groups who are <strong>allowed</strong> to change topics in the %WIKITOOLNAME% web. (More in [[Main/TWikiAccessControl]]) </td>
+  </tr>
+  <tr>
+    <td><code>%DENYTOPICCHANGE%</code></td>
+    <td><strong><em>(any topic)</em></strong></td>
+    <td> List of users and groups who are <strong>not allowed</strong> to change the current topic. (More in [[Main/TWikiAccessControl]]) </td>
+  </tr>
+  <tr>
+    <td><code>%ALLOWTOPICCHANGE%</code></td>
+    <td><strong><em>(any topic)</em></strong></td>
+    <td> List of users and groups who are <strong>allowed</strong> to change the current topic. (More in [[Main/TWikiAccessControl]]) </td>
+  </tr>
+  <tr>
+    <td><code>%FINALPREFERENCES%</code></td>
+    <td><strong><em>SL</em></strong> , <strong><em>WL</em></strong></td>
+    <td> List of preferences that are not allowed to be overridden by next level preferences</td>
+  </tr>
 </table>
 
--- [[PeterThoeny]] - 21 Apr 2000 <br />
+**_Notes:_**
+
+- Preferences variables ( on site-level, web-level and user level ) are defined by bullet lines with this syntax:
+  - `Set VARIABLENAME = value`
+- 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 />