TWiki/TWikiPreferences.mdwn

   1 **%WIKITOOLNAME% Site-Level Preferences**
   2
   3 The following settings are **_site-level preferences_** , e.g. affecting all users in all %WIKITOOLNAME% webs. These preferences can be overwritten by **_web preferences_** (topic [[WebPreferences]] in each %WIKITOOLNAME% web) and **_user preferences_** (your personal topic, i.e. [[TWikiGuest]] in the %WIKITOOLNAME%.Main web)
   4
   5 **_Preferences:_**
   6
   7 - List of %WIKITOOLNAME% webs: (the first line of a topic; to add a web see [[TWikiDocumentation]] and [[TWikiWebsTable]])
   8   - Set WIKIWEBLIST = [%WIKITOOLNAME%](%WIKIHOMEURL%) . \{ [Main](http://www.dementia.org/twiki//view/Main/WebHome) | [TWiki](http://www.dementia.org/twiki//view/TWiki/WebHome) | [Know](http://www.dementia.org/twiki//view/Know/WebHome) | [Test](http://www.dementia.org/twiki//view/Test/WebHome) \}
   9
  10 - List of topics of a web: (the second line of a topic, is overwritten by web preferences)
  11   - Set WEBTOPICLIST = %WEB% . \{ [Home](WebHome) | [Changes](WebChanges) | [Index](http://www.dementia.org/twiki//search/%WEB%/?scope=topic&regex=on&search=.*) | [Search](WebSearch) | Go <input name="topic" size="16" type="text" />
  12  \}
  13
  14 - Copyright notice:
  15   - Set WEBCOPYRIGHT = <font>Copyright © 2000 by the contributing authors. \\nAll material on this collaboration tool is the property of the contributing authors. <br /> \\nIdeas, requests, problems regarding %WIKITOOLNAME%? [Send](mailto:?subject=%WIKITOOLNAME% Feedback) feedback. </font>
  16
  17 - Wiki webmaster email address:
  18   - Set WIKIWEBMASTER = <Peter@Thoeny.com>
  19
  20 - Web specific background color: (is overwritten by web preferences)
  21   - Set WEBBGCOLOR = #C0C0C0
  22
  23 - Exclude web from a `web="all"` search: (Set to `on` for hidden webs; is overwritten by web preferences)
  24   - Set NOSEARCHALL =
  25
  26 - Horizontal size of text edit box: (can be overwritten by user preferences)
  27   - Set EDITBOXWIDTH = 70
  28
  29 - Vertical size of text edit box: (can be overwritten by user preferences)
  30   - Set EDITBOXHEIGHT = 15
  31
  32 - Default state of the **_link_** check box in the attach file page. Check box is initially checked if _Set ATTACHLINKBOX = CHECKED_ , unchecked if empty ( _Set ATTACHLINKBOX =_ ). If checked, a link is created to the attached file at the end of the topic: (can be overwritten by user preferences)
  33   - Set ATTACHLINKBOX =
  34
  35 - http-equiv meta tags for **_view_**, **_rdiff_**, **_attach_**, **_search\*_** scripts:
  36   - Set HTTP\_EQUIV\_ON\_VIEW =
  37
  38 - http-equiv meta tags for **_edit_** script. Example to expire immediately: <br />`Set HTTP_EQUIV_ON_EDIT = <meta http-equiv="Expires" content="%GMTIME{"day month, year - hour:min:sec"}% GMT">`
  39   - Set HTTP\_EQUIV\_ON\_EDIT =
  40
  41 - http-equiv meta tags for **_preview_** script:
  42   - Set HTTP\_EQUIV\_ON\_PREVIEW =
  43
  44 **_Notes:_**
  45
  46 - A preference is defined as: <br />`6 spaces * Set NAME = value`<br /> Example:
  47   - Set WEBBGCOLOR = #FFFFC0
  48 - Preferences are used as [[TWikiVariables]] by enclosing the name in percent signs. Example:
  49   - When you write variable `%WEBBGCOLOR%` , it gets expanded to `%WEBBGCOLOR%` .
  50 - The sequential order of the preference settings is significant. Define preferences that use other preferences first, i.e. set `WEBCOPYRIGHT` before `WIKIWEBMASTER` since `%WEBCOPYRIGHT%` uses the `%WIKIWEBMASTER%` variable.
  51 - You can introduce new variables and use them in your topics and templates. There is no need to change the %WIKITOOLNAME% engine (Perl scripts).
  52
  53 **_Related Topics:_**
  54
  55 - [[WebPreferences]] has preferences of the %WIKITOOLNAME%.%WEB% web.
  56 - [[TWikiUsers]] has a list of user topics. User topics can have optional user preferences.
  57 - [[TWikiVariables]] has a list of common `%VARIABLES%` .