1 <form action="http://www.dementia.org/twiki/viewauth/Main/WebHome" enctype="multipart/form-data" method="post" name="editpreferences">
4 <h1><a name="%WIKITOOLNAME% Site-Level Prefer"></a><a name=" %WIKITOOLNAME% Site-Level Prefe"></a> %WIKITOOLNAME% Site-Level Preferences </h1>
5 <p> This topic defines <strong><em>site-level</em></strong> settings that apply to all users and webs on this [[Main/TWikiSite]]. </p>
6 <p><strong><em>%X% Note:</em></strong> This topic should be regarded as read-only, so that upgrades can safely overwrite it without risk to your customizations. </p>
7 <p> Preference settings local to your site should be set in [[Main/TWikiPreferences]] (this topic is pointed to by {LocalSitePreferences}, which is set by the admin in the <a href="http://www.dementia.org/twiki/configure" target="_top">configure</a> interface). Settings in [[Main/TWikiPreferences]] will override settings in this topic, and should be used for defining custom settings and variables. </p>
8 <p>[[Main/TWikiVariables#PreferencesVariables]] on how to set Preferences Variables. </p>
10 </p><input name="prefsaction" type="submit" value="Edit" /> <em>(Click for form-based editing of existing preferences.)</em><div>
12 <li><a href="#Default Web Preferences"> Default Web Preferences</a></li>
13 <li><a href="#Default User Settings"> Default User Settings</a></li>
14 <li><a href="#TWiki Platform Settings"> TWiki Platform Settings</a><ul>
15 <li><a href="#Search Settings"> Search Settings</a></li>
16 <li><a href="#E-mail Settings"> E-mail Settings</a></li>
17 <li><a href="#HTTP-EQUIV Settings"> HTTP-EQUIV Settings</a></li>
20 <li><a href="#Skin Settings"> Skin Settings</a><ul>
21 <li><a href="#PatternSkin"> PatternSkin</a></li>
22 <li><a href="#Skin icons"> Skin icons</a></li>
23 <li><a href="#Legacy support"> Legacy support</a></li>
26 <li><a href="#Plugins Settings"> Plugins Settings</a></li>
27 <li><a href="#Rendering Shortcuts Settings"> Rendering Shortcuts Settings</a></li>
28 <li><a href="#Miscellaneous Settings"> Miscellaneous Settings</a></li>
29 <li><a href="#Access Control Settings"> Access Control Settings</a></li>
30 <li><a href="#Creating New Preference Variable"> Creating New Preference Variables</a></li>
31 <li><a href="#Related Topics"> Related Topics</a></li>
34 <p><a name="DefaultWebPreferences"></a></p>
35 <h2><a name="Default Web Preferences"></a> Default Web Preferences </h2>
36 <p> %X% <strong>NOTE:</strong> These are just defaults; don't change them here. Instead, add them to the WebPreferences topic in each web </p>
40 <li> List of selected topics in a web (used in menus) <ul>
41 <li> Set WEBTOPICLIST = [[Main/WebChanges]] | [[Main/WebIndex]] | [[Main/WebSearch]] | Go <input name="topic" size="16" type="text" /></li>
48 <li> Web-specific background color: (is overwritten by web preferences) <ul>
49 <li> Set WEBBGCOLOR = #FFD8AA </li>
56 <li><a href="http://en.wikipedia.org/wiki/Favicon" target="_top">favicon</a>: Attach a <code>favicon.ico</code> to a web's [[Main/WebPreferences]] or add a <code>FAVICON</code> setting to [[Main/WebPreferences]]<ul>
57 <li> Set FAVICON = <a href="http://www.dementia.org/twiki//view/Main/WebPreferences/favicon.ico" target="_top">http://www.dementia.org/twiki//view/Main/WebPreferences/favicon.ico</a></li>
64 <li> Image, URL and alternate tooltip text of web's logo. <ul>
65 <li> Set WEBLOGOIMG = %WIKILOGOIMG% </li>
66 <li> Set WEBLOGOURL = %WIKILOGOURL% </li>
67 <li> Set WEBLOGOALT = %WIKILOGOALT% </li>
74 <li> List this web in the [[TWiki/SiteMap]]: <ul>
75 <li> If yes, set SITEMAPLIST to <code>on</code>, do not set NOSEARCHALL, and add the "what" and "use to..." description for the site map. Make sure to list only links that include the name of the web, e.g. %WEB%.Topic links. </li>
76 <li> Set SITEMAPLIST = on </li>
77 <li> Set SITEMAPWHAT = Describe what this web does. </li>
78 <li> Set SITEMAPUSETO = ...to do something. </li>
85 <li> Copyright notice: <ul>
86 <li> Set WEBCOPYRIGHT = <span> <a href="http://twiki.org/"><img alt="This site is powered by the TWiki collaboration platform" border="0" height="15" src="http://www.dementia.org/twiki//view/TWiki/TWikiLogos/T-logo-80x15.gif" title="This site is powered by the TWiki collaboration platform" width="80" /></a></span>Copyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors. <br /> Ideas, requests, problems regarding %WIKITOOLNAME%? <a href="mailto:?subject=%WIKITOOLNAME% Feedback on Main.WebHome">Send feedback</a></li>
93 <li> Simplified Copyright notice for the [[Main/WebRss]] feed (don't use any special characters, html tags, entities, wiki markup or [[Main/WikiWords]]) <ul>
94 <li> Set WEBRSSCOPYRIGHT = Copyright 2010 by contributing authors </li>
101 <li> Exclude web from a <code>web="all"</code> search: (Set to <code>on</code> for hidden webs; is overwritten by web preferences) <strong><em>Note</em></strong> it is much better to use [[Main/TWikiAccessControls]] in individual webs to control who can and can't view the contents of a web. NOSEARCHALL is retained for compatibility, but you should avoid using it. <ul>
102 <li> Set NOSEARCHALL = </li>
105 <li> Prevent automatic linking of [[TWiki/WikiWords]] and acronyms (if set to <code>on</code>); link WikiWords (if empty); can be overwritten by web preferences: <ul>
106 <li> Set NOAUTOLINK = </li>
107 <li><strong><em>Note:</em></strong> Use the <code>[[...][...]]</code> syntax to link topics in case you disabled WikiWord linking. The <code><noautolink> ... </noautolink></code> syntax can be used to prevents links within a block of text. </li>
114 <li> Warn if <code>%INCLUDE{}%</code> of topic fails: Fail silently if empty or <code>off</code>. Output warning message (defined in templates/oopsalerts.tmpl) if set to <code>on</code>. Otherwise output specific text (use <code>$topic</code> for topic). You can override this in web preferences, or by using a <code>warn="..."</code> parameter with <code>%INCLUDE{}%</code> : <ul>
115 <li> Set INCLUDEWARNING = on </li>
121 <h2><a name="Default User Settings"></a> Default User Settings </h2>
122 <p> %X% <strong>NOTE:</strong> They are typically redefined in topics of individual [[Main/TWikiUsers]]</p>
126 <li> Show tool-tip topic info on mouse-over of [[Main/WikiWord]] links. Setting can be on, off, or customized. An empty setting or off setting disables the tool-tips (for better performance). The setting can contain $summary to show the topic summary, $date for the last change date, $rev for the revision, $username for the login name of the last editor, $wikiname for the WikiName, $wikiusername for Main.WikiName, $topic for the topic name, and $web for the web name <ul>
127 <li> Set LINKTOOLTIPINFO = off </li>
128 <li> #Set LINKTOOLTIPINFO = $username - $date - $rev: $summary </li>
135 <li> Some skins have two editors available; the default editor, and a second editor which is usually a WYSIWYG editor (the second editor is used by hitting the WYSIWYG link in <code>pattern</code> or <code>classic</code> skins). If COMPOSER is not set, the second editor will work the same as the <em>default</em> editor. If the WysiwygPlugin is installed and it is set to 'kupu' (the default), then the <strong>Kupu</strong> WYSIWYG editor will be enabled. You can change the setting to use any editor that is enabled by setting the <code>cover</code> parameter on the edit URL. <ul>
136 <li> Set COMPOSER = kupu </li>
137 <li> Enable content checks before editing </li>
138 <li> Set WYSWIYGPLUGIN_WYSIWYGSKIN = kupu </li>
139 <li> Disable WYSIWYG on pages that contain complex TML. On pages that have complex TML, WYSIWYG will fall back to the default text editor. </li>
140 <li> Set WYSIWYG_EXCLUDE = calls </li>
147 <li> Horizontal size of text edit box: (can be overwritten by user preferences) <ul>
148 <li> Set EDITBOXWIDTH = 70 </li>
155 <li> Vertical size of text edit box: (can be overwritten by user preferences) <ul>
156 <li> Set EDITBOXHEIGHT = 22 </li>
163 <li> Style of text edit box. Set to <code>width: 99%</code> for full window width (default; this will overwrite the EDITBOXWIDTH setting), or <code>width: auto</code> to disable. This setting works for IE and some other recent browsers. (can be overwritten by user preferences) <ul>
164 <li> Set EDITBOXSTYLE = width: 99% </li>
171 <li> Default state of the <strong><em>Force New Revision</em></strong> ([[Main/ForceNewRevision]]) check box in preview. Check box is initially checked if <code>Set FORCENEWREVISIONCHECKBOX = checked="checked"</code>, or unchecked if empty: (can be overwritten by user preferences) <ul>
172 <li> Set FORCENEWREVISIONCHECKBOX = </li>
179 <li> Default state of the <strong><em>Minor Changes, Don't Notify</em></strong> ([[Main/DontNotify]]) check box in preview. Check box is initially checked if <code>Set DONTNOTIFYCHECKBOX = checked="checked"</code>, or unchecked if empty: (can be overwritten by user preferences) <ul>
180 <li> Set DONTNOTIFYCHECKBOX = </li>
187 <li> Default state of the <strong><em>link</em></strong> check box in the attach file page. Checkbox is initially checked if <code>Set ATTACHLINKBOX = checked="checked"</code>, or unchecked if empty (<code>Set ATTACHLINKBOX =</code>). If checked, a link is created to the attached file at the end of the topic: (can be overwritten by user preferences) <ul>
188 <li> Set ATTACHLINKBOX = </li>
195 <li> Format of file link when the <strong><em>link</em></strong> check box is checked: (can be overwritten by user preferences) <ul>
196 <li> %H% <strong>NOTE:</strong> Keyword <code><b>$name</b></code> gets expanded to filename; <code><b>$comment</b></code> to comment; <code><b>\t</b></code> to tab (3 spaces for bullets). </li>
200 * Set ATTACHEDFILELINKFORMAT = \n * [[%ATTACHURL%/$name][$name]]: $comment
204 <li> Format of images when the <strong><em>link</em></strong> check box is checked: (can be overwritten by user preferences) <ul>
205 <li> %H% <strong>NOTE:</strong> Keyword <code><b>$name</b></code> gets expanded to filename; <code><b>$comment</b></code> to comment; <code><b>$size</b></code> to <code><b>width="..." height="..."</b></code> attribute of <code><b>img</b></code> tag; <code><b>\t</b></code> to tab and <code><b>\n</b></code> to linefeed (3 spaces for bullets). </li>
209 * Set ATTACHEDIMAGEFORMAT = \n * $comment: <br />\n <img src="%ATTACHURLPATH%/$name" alt="$name" $size />
212 <h2><a name="TWiki Platform Settings"></a> TWiki Platform Settings </h2>
216 <li> TWiki site name: <ul>
217 <li> Set WIKITOOLNAME = TWiki </li>
224 <li> Image, URL and alternate tooltip text of the logo <strong>for this installation</strong>: you should change these settings for your site, or they can be overwridden in WebPreferences for individual webs by defining these variables there. <ul>
225 <li> Set WIKILOGOIMG = <img alt="T-logo-140x40-t.gif" src="http://www.dementia.org/twiki//view/TWiki/TWikiLogos/T-logo-140x40-t.gif" /></li>
226 <li> Set WIKILOGOURL = <a href="http://TWiki.org/" target="_top">http://TWiki.org/</a></li>
227 <li> Set WIKILOGOALT = Powered by %WIKITOOLNAME% </li>
234 <li> Home page of this site <ul>
235 <li> Set WIKIHOMEURL = <a href="http://www.dementia.org/twiki/view" target="_top">http://www.dementia.org/twiki/view</a></li>
242 <li> List of %WIKITOOLNAME% webs - on the first line of the upper toolbar (to add a new web, see [[Main/ManagingWebs]] and [[TWiki/SiteMap]]): <ul>
243 <li> Set WIKIWEBLIST = [[Main/WebHome]] | [[TWiki/WebHome]] | [[Sandbox/WebHome]]</li>
244 <li> %T% <strong>NOTE:</strong> To automatically list all non-hidden webs in alphabetical order, use the <code>%WEBLIST{}%</code> variable instead: <br />
254 <li> Maximum size of [[TWiki/FileAttachments]] in KB, 0 for no limit: <ul>
255 <li> Set ATTACHFILESIZELIMIT = 10000 </li>
262 <li> Broadcast message for skins supporting a %BROADCASTMESSAGE% at the top of the page: (IMPORTANT: Set to empty message if not used; #Comment out unused messages) <ul>
263 <li> Set BROADCASTMESSAGE = </li>
264 <li> #Set BROADCASTMESSAGE = <table border="0" cellpadding="3" cellspacing="0" width="100%">
266 <td bgcolor="yellow"><font color="red"><strong>NOTE:</strong></font> Edit and Attach will be disabled today between 05:00 PM and 06:00 PM PDT (00:00 to 01:00 GMT) for a scheduled %WIKITOOLNAME% maintenance. </td>
270 <li> If you use [[Main/PatternSkin]]: </li>
271 <li> #Set BROADCASTMESSAGE = <div><strong>NOTE:</strong> Edit and Attach will be disabled today between 05:00 PM and 06:00 PM PDT (00:00 to 01:00 GMT) for a scheduled %WIKITOOLNAME% maintenance.</div>
279 <li> Users or groups allowed to [[TWiki/ManagingWebs]]: (ex: [[Main/TWikiAdminGroup]]) </li>
280 <li><strong>This has been disabled for the TWiki-4.0.0 release due to a potential security hole - you must be in the [[Main/TWikiAdminGroup]] to create a web</strong><ul>
281 <li> Set ALLOWWEBMANAGE = [[Main/TWikiAdminGroup]]</li>
287 <h3><a name="Search Settings"></a> Search Settings </h3>
291 <li> Default type for search, one of: keyword (for search engine like syntax), regex (for [[Main/RegularExpression]] search), or literal (for verbatim search) <ul>
292 <li> Set SEARCHDEFAULTTTYPE = keyword </li>
295 <li> Default for <code>%SEARCH{}%</code> variable, one of: keyword, regex, or literal <ul>
296 <li> Set SEARCHVARDEFAULTTYPE = literal </li>
299 <li> Stop words, e.g., common words and characters to exclude from a keyword search: <ul>
300 <li> Set SEARCHSTOPWORDS = a, all, am, an, and, any, as, at, b, be, by, c, d, e, for, from, g, h, how, i, i'm, i.e., in, is, isn't, it, it's, its, j, k, l, m, n, o, of, on, or, p, q, r, s, t, that, that's, the, this, to, u, v, w, was, wasn't, what, what's, when, where, who, who's, will, with, x, y, z </li>
306 <h3><a name="E-mail Settings"></a> E-mail Settings </h3>
310 <li> 'Mail this topic' mailto: link - can be included in topics, templates or skins <ul>
311 <li> Set MAILTHISTOPIC = <a href="mailto:?subject=WebHome&body=%TOPICURL%">%MAILTHISTOPICTEXT%</a></li>
318 <li> 'Mail this topic' link text <ul>
319 <li> Set MAILTHISTOPICTEXT = Send a link to this page </li>
326 <li> URL for current topic <ul>
327 <li> Set TOPICURL = [[%WEB%/WebHome]]</li>
335 <h3><a name="HTTP-EQUIV Settings"></a> HTTP-EQUIV Settings </h3>
339 <li> %T% <strong>NOTE:</strong> Changing cache behaviour with these settings should not be necessary and may cause cache-related problems (e.g. TWiki:Codev.BackFromPreviewLosesText or TWiki:Codev.RefreshEditPage). These settings do not affect proxy caches. </li>
340 <li><strong>NOTE:</strong> The current values of these preferences are not displayed in view mode (values are <code><link></code>-tags). </li>
345 <li><code><b>http-equiv</b></code> meta tags for <code><b>view</b></code>, <code><b>rdiff</b></code>, <code><b>attach</b></code>, <code><b>search*</b></code> scripts: <ul>
346 <li> #Set HTTP_EQUIV_ON_VIEW = </li>
347 <li> Set HTTP_EQUIV_ON_VIEW = </li>
353 - <code>**http-equiv**</code> meta tags for <code>**edit**</code> script:
354 - Set HTTP\_EQUIV\_ON\_EDIT =
356 - <code>**http-equiv**</code> meta tags for <code>**preview**</code> script:
357 - Set HTTP\_EQUIV\_ON\_PREVIEW =
359 ## <a name="Skin Settings"></a> Skin Settings
361 - Skin overriding the default TWiki templates: (can be overwritten by [[WebPreferences]] and user preferences)
364 - **_Note:_** See [[TWikiSkinBrowser]] for currently installed skins
366 ### <a name="PatternSkin"></a> [[PatternSkin]]
368 - Default TWiki styles
369 - Set TWIKILAYOUTURL = <http://www.dementia.org/twiki//view/TWiki/PatternSkin/layout.css>
370 - Set TWIKISTYLEURL = <http://www.dementia.org/twiki//view/TWiki/PatternSkin/style.css>
371 - Set TWIKICOLORSURL = <http://www.dementia.org/twiki//view/TWiki/PatternSkin/colors.css>
373 - Custom overriding styles (enabled pr. default but empty, to prevent browsers from fetching %USERLAYOUTURL%-style URLs)
374 - Set USERLAYOUTURL =
376 - Set USERCOLORSURL =
378 - **PatternSkin header settings**
379 - Set WEBHEADERART = ![TWiki\_header.gif](http://www.dementia.org/twiki//view/TWiki/PatternSkin/TWiki_header.gif)
380 - Set WEBHEADERBGCOLOR = #ffffff
382 ### <a name="Skin icons"></a> Skin icons
384 - Topic containing the icon graphics library. Icons can easily be rendered with `%ICON{name}%`.
385 - Set ICONTOPIC = [[TWikiDocGraphics]]
387 ### <a name="Legacy support"></a> Legacy support
389 - Support for legacy "EDITTOPIC", used to be hard-coded, now replaced by TMPL:P conditional instantiation
390 - Set EDITURL = <http://www.dementia.org/twiki/edit/%WEB%/%TOPIC%?t=1277827363>
391 - Set EDITTOPIC = [Edit](%EDITURL% Edit Topic - deprecated usage - please see release notes)
393 ## <a name="Plugins Settings"></a> Plugins Settings
395 - You can enable/disable Plugins using the [configure](http://www.dementia.org/twiki/configure) interface.
396 - You can also disable installed plugins in individual webs/topics by defining the %DISABLEDPLUGINS% TWiki variable to be a list of plugins to disable e.g.
397 - Set DISABLEDPLUGINS = [[SpreadSheetPlugin]],EditTablePlugin
398 - Currently, %DISABLEDPLUGINS% is set to "%DISABLEDPLUGINS%"
399 - Currently activated Plugins: [[SpreadSheetPlugin]], [[CommentPlugin]], [[EditTablePlugin]], [[InterwikiPlugin]], [[PreferencesPlugin]], [[SlideShowPlugin]], [[SmiliesPlugin]], [[TablePlugin]], [[TwistyPlugin]]
401 - %T% **NOTE:** You can enable/disable Plugins by passing a comma-separated list of Plugin names in the `debugenableplugins` url parameter; for example, [[http://www.dementia.org/twiki/view/%WEB%/%TOPIC%?debugenableplugins=SmiliesPlugin|%WEB%/%TOPIC%?debugenableplugins=SmiliesPlugin]] will display this topic with all Plugins disabled except the [[SmiliesPlugin]].
402 - Detailed diagnostics can be found in [[InstalledPlugins]]
404 - Set INSTALLEDPLUGINS = The INSTALLEDPLUGINS variable is no longer supported. You can set the Plugins execution order using the [configure](http://www.dementia.org/twiki/configure) interface.
406 <a name="RenderingShortcuts"></a>
408 ## <a name="Rendering Shortcuts Settings"></a> Rendering Shortcuts Settings
416 - Vertical bar / pipe symbol:
419 - Line break and bullet with different levels of indentation:
425 - **_Hint:_** Above shortcuts are useful in TWiki tables where you cannot use newlines
427 <a name="DocGraphics"></a>
429 - Graphics used in TWiki documentation - view all images in %ICONTOPIC%. _(There are various ways to set up common icons as text variables. This is simply one quick approach.)_:
430 - Set H = <img src="http://www.dementia.org/twiki//view/Main/WebHome/help.gif" width="16" height="16" alt="HELP" title="HELP" />
431 - Set I = <img src="http://www.dementia.org/twiki//view/Main/WebHome/tip.gif" width="16" height="16" alt="IDEA!" title="IDEA!" />
432 - Set M = <img src="http://www.dementia.org/twiki//view/Main/WebHome/arrowright.gif" width="16" height="16" alt="MOVED TO..." title="MOVED TO..." />
433 - Set N = <img src="http://www.dementia.org/twiki//view/Main/WebHome/new.gif" width="30" height="16" alt="NEW" title="NEW" />
434 - Set P = <img src="http://www.dementia.org/twiki//view/Main/WebHome/pencil.gif" width="16" height="16" alt="REFACTOR" title="REFACTOR" />
435 - Set Q = <img src="http://www.dementia.org/twiki//view/Main/WebHome/help.gif" width="16" height="16" alt="QUESTION?" title="QUESTION?" />
436 - Set S = <img src="http://www.dementia.org/twiki//view/Main/WebHome/starred.gif" width="16" height="16" alt="PICK" title="PICK" />
437 - Set T = <img src="http://www.dementia.org/twiki//view/Main/WebHome/tip.gif" width="16" height="16" alt="TIP" title="TIP" />
438 - Set U = <img src="http://www.dementia.org/twiki//view/Main/WebHome/updated.gif" width="55" height="16" alt="UPDATED" title="UPDATED" />
439 - Set X = <img src="http://www.dementia.org/twiki//view/Main/WebHome/warning.gif" width="16" height="16" alt="ALERT!" title="ALERT!" />
440 - Set Y = <img src="http://www.dementia.org/twiki//view/Main/WebHome/choice-yes.gif" width="16" height="16" alt="DONE" title="DONE" />
442 - Colored text: (see more [[StandardColors]]) <table border="1" cellpadding="0" cellspacing="0">
445 <td><code>%RED% red text %ENDCOLOR% and %GREEN% green text %ENDCOLOR%</code></td>
449 <td> %RED% red text %ENDCOLOR% and %GREEN% green text %ENDCOLOR% </td>
452 - **_Note:_** `%<color>%` text must end with `%ENDCOLOR%`. If you want to switch from one color to another one you first need to end the active color with `%ENDCOLOR%`, e.g. write `%RED% some text %ENDCOLOR% %GREEN% more text %ENDCOLOR%`.
453 - %YELLOW% **Set YELLOW = looks like this** %ENDCOLOR%
454 - %ORANGE% **Set ORANGE = looks like this** %ENDCOLOR%
455 - %RED% **Set RED = looks like this** %ENDCOLOR%
456 - %PINK% **Set PINK = looks like this** %ENDCOLOR%
457 - %PURPLE% **Set PURPLE = looks like this** %ENDCOLOR%
458 - %TEAL% **Set TEAL = looks like this** %ENDCOLOR%
459 - %NAVY% **Set NAVY = looks like this** %ENDCOLOR%
460 - %BLUE% **Set BLUE = looks like this** %ENDCOLOR%
461 - %AQUA% **Set AQUA = looks like this** %ENDCOLOR%
462 - %LIME% **Set LIME = looks like this** %ENDCOLOR%
463 - %GREEN% **Set GREEN = looks like this** %ENDCOLOR%
464 - %OLIVE% **Set OLIVE = looks like this** %ENDCOLOR%
465 - %MAROON% **Set MAROON = looks like this** %ENDCOLOR%
466 - %BROWN% **Set BROWN = looks like this** %ENDCOLOR%
467 - %BLACK% **Set BLACK = looks like this** %ENDCOLOR%
468 - %GRAY% **Set GRAY = looks like this** %ENDCOLOR%
469 - %SILVER% **Set SILVER = looks like this** %ENDCOLOR%
470 - <span>%WHITE% **Set WHITE = looks like this (with gray background)** %ENDCOLOR%</span>
471 - The following color settings are enclosed in verbatim tags to avoid incorrect nesting of XHTML tags:
473 * Set YELLOW = <font color="#ffff00">
474 * Set ORANGE = <font color="#ff6600">
475 * Set RED = <font color="#ff0000">
476 * Set PINK = <font color="#ff00ff">
477 * Set PURPLE = <font color="#800080">
478 * Set TEAL = <font color="#008080">
479 * Set NAVY = <font color="#000080">
480 * Set BLUE = <font color="#0000ff">
481 * Set AQUA = <font color="#00ffff">
482 * Set LIME = <font color="#00ff00">
483 * Set GREEN = <font color="#008000">
484 * Set OLIVE = <font color="#808000">
485 * Set MAROON = <font color="#800000">
486 * Set BROWN = <font color="#996633">
487 * Set BLACK = <font color="#000000">
488 * Set GRAY = <font color="#808080">
489 * Set SILVER = <font color="#c0c0c0">
490 * Set WHITE = <font color="#ffffff">
491 * Set ENDCOLOR = </font>
493 ## <a name="Miscellaneous Settings"></a> Miscellaneous Settings
495 - Format of a [[NewWikiWord]] link: %BR%
497 - Set NEWLINKFORMAT = <span>$text[?](http://www.dementia.org/twiki/edit/$web/$topic?topicparent=%WEB%.%TOPIC% Create this topic)</span>
498 - alternative setting:
499 - #Set NEWLINKFORMAT = [$text](http://www.dementia.org/twiki/edit/$web/$topic?topicparent=%WEB%.%TOPIC% Create this topic)
501 - [[PreviewBackground]] image:
502 - Set PREVIEWBGIMAGE = ![preview2bg.gif](http://www.dementia.org/twiki//view/TWiki/PreviewBackground/preview2bg.gif)
504 - User-friendly synonyms for MAINWEB and TWIKIWEB
505 - Set USERSWEB = Main
506 - Set SYSTEMWEB = TWiki
509 ## <a name="Access Control Settings"></a> Access Control Settings
511 - Users or groups allowed to change or rename this %TOPIC% topic:
512 - Set ALLOWTOPICCHANGE = [[TWikiAdminGroup]]
513 - By default, only admins can create webs in the root
514 - Set ALLOWROOTCHANGE = [[TWikiAdminGroup]]
516 ## <a name="Creating New Preference Variable"></a> Creating New Preference Variables
518 You can introduce new VARIABLES and use them in your topics and templates. There is no need to change the TWiki engine (Perl scripts).
520 - A preference is defined in a [[TWikiShorthand]] bullet item: <code>**[3 spaces] \* [space] Set NAME = value**</code><br /> Example (as a nested bullet item, indented 6 spaces):
521 - Set WEBBGCOLOR = #FFFFC0
522 - Preferences are used as [[TWikiVariables]] by enclosing the name in percent signs: <code>**%**</code>. Example:
523 - When you write variable <code>**%WEBBGCOLOR%**</code>, it gets expanded to `%WEBBGCOLOR%` .
525 - %X% The sequential order of the preference settings is significant. Define preferences that use other preferences FIRST. For example, set <code>**WEBCOPYRIGHT**</code> before <code>**WIKIWEBMASTER**</code> since the copyright notice uses the TWiki administrator e-mail address.
526 - %X% In order to protect your custom variables from being overwritten when upgrading the [[TWiki.%TOPIC%|TWiki/TOPIC]] topic, it is recommended that custom variables are defined in [[Main.%TOPIC%|Main/TOPIC]].
528 ## <a name="Related Topics"></a> Related Topics
530 - [[WebPreferences]] has preferences of the %WEB% web.
531 - [[TWikiUsers]] has a list of user topics. User topics can have optional user preferences.
532 - [[TWikiVariables]] has a list of common `%VARIABLES%`.
533 - [[TWikiAccessControl]] explains how to restrict access by users or groups.
534 - TWiki:Plugins.PreferencesPlugin makes editing preferences a snap.
536 **_Note_**: Can't edit? [[View raw topic|%WEB%/%TOPIC%?raw=on]]