%META:TOPICINFO{author="RicardoPereira" date="1173701578" format="1.1" version="1.80"}% ---+!! %WIKITOOLNAME% Site-Level Preferences This topic defines __site-level__ settings that apply to all users and webs on this TWikiSite. __%X% Note:__ This topic should be regarded as read-only, so that upgrades can safely overwrite it without risk to your customizations. Preference settings local to your site should be set in [[%LOCALSITEPREFS%]] (this topic is pointed to by {LocalSitePreferences}, which is set by the admin in the [[%SCRIPTURLPATH{"configure"}%][configure]] interface). Settings in [[%LOCALSITEPREFS%]] will override settings in this topic, and should be used for defining custom settings and variables. [[TWikiVariables#PreferencesVariables][Read more]] on how to set Preferences Variables. %EDITPREFERENCES{"TWikiPreferencesForm"}% _(Click for form-based editing of existing preferences.)_ %TOC% #DefaultWebPreferences ---++ Default Web Preferences %X% *NOTE:* These are just defaults; don't change them here. Instead, add them to the !WebPreferences topic in each web * List of selected topics in a web (used in menus) * Set WEBTOPICLIST = [[WebChanges][Changes]] %SEP% [[WebIndex][Index]] %SEP% [[WebSearch][Search]] %SEP% Go * Web-specific background color: (is overwritten by web preferences) * Set WEBBGCOLOR = #FFD8AA * [[http://en.wikipedia.org/wiki/Favicon][favicon]]: Attach a =favicon.ico= to a web's WebPreferences or add a =FAVICON= setting to WebPreferences * Set FAVICON = %PUBURLPATH%/%BASEWEB%/%WEBPREFSTOPIC%/favicon.ico * Image, URL and alternate tooltip text of web's logo. * Set WEBLOGOIMG = %WIKILOGOIMG% * Set WEBLOGOURL = %WIKILOGOURL% * Set WEBLOGOALT = %WIKILOGOALT% * List this web in the %TWIKIWEB%.SiteMap: * If yes, set SITEMAPLIST to =on=, 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. * Set SITEMAPLIST = on * Set SITEMAPWHAT = Describe what this web does. * Set SITEMAPUSETO = ...to do something. * Copyright notice: * Set WEBCOPYRIGHT =

%MAKETEXT{"Copyright &© by the contributing authors. All material on this collaboration platform is the property of the contributing authors." args="1999-%GMTIME{$year}%"}%
%MAKETEXT{"Ideas, requests, problems regarding [_1]? Send feedback" args="%WIKITOOLNAME%,mailto:%WIKIWEBMASTER%?subject=%WIKITOOLNAME% Feedback on %BASEWEB%.%BASETOPIC%"}% %IF{"$ WEB= $ TWIKIWEB" then="
__Note:__ Please contribute updates to this topic on TWiki.org at TWiki:TWiki.%BASETOPIC%"}% * Simplified Copyright notice for the WebRss feed (don't use any special characters, html tags, entities, wiki markup or WikiWords) * Set WEBRSSCOPYRIGHT = Copyright %GMTIME{"$year"}% by contributing authors * Exclude web from a =web="all"= search: (Set to =on= for hidden webs; is overwritten by web preferences) __Note__ it is much better to use 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. * Set NOSEARCHALL = off * Prevent automatic linking of [[%TWIKIWEB%.WikiWords][WikiWords]] and acronyms (if set to =on=); link WikiWords (if empty); can be overwritten by web preferences: * Set NOAUTOLINK = off * __Note:__ Use the =[[...][...]]= syntax to link topics in case you disabled WikiWord linking. The =<noautolink> ... </noautolink>= syntax can be used to prevents links within a block of text. * Warn if =%INCLUDE{}%= of topic fails: Fail silently if empty or =off=. Output warning message (defined in templates/oopsalerts.tmpl) if set to =on=. Otherwise output specific text (use =$topic= for topic). You can override this in web preferences, or by using a =warn="..."= parameter with =%INCLUDE{}%= : * Set INCLUDEWARNING = on ---++ Default User Settings %X% *NOTE:* They are typically redefined in topics of individual %MAINWEB%.TWikiUsers * Show tool-tip topic info on mouse-over of 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 %MAINWEB%.WikiName, $topic for the topic name, and $web for the web name * Set LINKTOOLTIPINFO = off * #Set LINKTOOLTIPINFO = $username - $date - $rev: $summary * 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 %MAKETEXT{"WYSIWYG"}% link in =pattern= or =classic= skins). If COMPOSER is not set, the second editor will work the same as the _default_ editor. If the !WysiwygPlugin is installed and it is set to 'kupu' (the default), then the *Kupu* WYSIWYG editor will be enabled. You can change the setting to use any editor that is enabled by setting the =cover= parameter on the edit URL. * Set COMPOSER = kupu * Enable content checks before editing * Set WYSWIYGPLUGIN_WYSIWYGSKIN = kupu * Disable WYSIWYG on pages that contain complex TML. On pages that have complex TML, WYSIWYG will fall back to the default text editor. * Set WYSIWYG_EXCLUDE = calls * Horizontal size of text edit box: (can be overwritten by user preferences) * Set EDITBOXWIDTH = 70 * Vertical size of text edit box: (can be overwritten by user preferences) * Set EDITBOXHEIGHT = 22 * Style of text edit box. Set to =width: 99%= for full window width (default; this will overwrite the EDITBOXWIDTH setting), or =width: auto= to disable. This setting works for IE and some other recent browsers. (can be overwritten by user preferences) * Set EDITBOXSTYLE = width: 99% * Default state of the __Force New Revision__ (ForceNewRevision) check box in preview. Check box is initially checked if =Set FORCENEWREVISIONCHECKBOX = checked="checked"=, or unchecked if empty: (can be overwritten by user preferences) * Set FORCENEWREVISIONCHECKBOX = * Default state of the __Minor Changes, Don't Notify__ (DontNotify) check box in preview. Check box is initially checked if =Set DONTNOTIFYCHECKBOX = checked="checked"=, or unchecked if empty: (can be overwritten by user preferences) * Set DONTNOTIFYCHECKBOX = * Default state of the __link__ check box in the attach file page. Checkbox is initially checked if =Set ATTACHLINKBOX = checked="checked"=, or 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) * Set ATTACHLINKBOX = * Format of file link when the __link__ check box is checked: (can be overwritten by user preferences) * %H% *NOTE:* Keyword ==$name== gets expanded to filename; ==$comment== to comment; ==\t== to tab (3 spaces for bullets). * Set ATTACHEDFILELINKFORMAT = \n * [[%ATTACHURL%/$name][$name]]: $comment * Format of images when the __link__ check box is checked: (can be overwritten by user preferences) * %H% *NOTE:* Keyword ==$name== gets expanded to filename; ==$comment== to comment; ==$size== to ==width="..." height="..."== attribute of ==img== tag; ==\t== to tab and ==\n== to linefeed (3 spaces for bullets). * Set ATTACHEDIMAGEFORMAT = \n * $comment:
\n $name

---++ TWiki Platform Settings * TWiki site name: * Set WIKITOOLNAME = TWiki * Image, URL and alternate tooltip text of the logo *for this installation*: you should change these settings for your site, or they can be overwridden in !WebPreferences for individual webs by defining these variables there. * Set WIKILOGOIMG = %PUBURL%/%TWIKIWEB%/TWikiLogos/T-logo-140x40-t.gif * Set WIKILOGOURL = http://TWiki.org/ * Set WIKILOGOALT = Powered by %WIKITOOLNAME% * Home page of this site * Set WIKIHOMEURL = %SCRIPTURLPATH{"view"}% * List of %WIKITOOLNAME% webs - on the first line of the upper toolbar (to add a new web, see ManagingWebs and %TWIKIWEB%.SiteMap): * Set WIKIWEBLIST = [[%MAINWEB%.%HOMETOPIC%][%MAINWEB%]] %SEP% [[%TWIKIWEB%.%HOMETOPIC%][%TWIKIWEB%]] %SEP% [[Sandbox.%HOMETOPIC%][Sandbox]] * %T% *NOTE:* To automatically list all non-hidden webs in alphabetical order, use the =%WEBLIST{}%= variable instead:
%WEBLIST{"[[$name.%HOMETOPIC%][$name]]" separator=" | "}% * Maximum size of %TWIKIWEB%.FileAttachments in KB, 0 for no limit: * Set ATTACHFILESIZELIMIT = 10000 * 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) * Set BROADCASTMESSAGE = * #Set BROADCASTMESSAGE =

NOTE: 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.

* If you use PatternSkin: * #Set BROADCASTMESSAGE =

*NOTE:* 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.

* Users or groups allowed to [[%TWIKIWEB%.ManagingWebs][create new webs]]: (ex: %MAINWEB%.TWikiAdminGroup) * *This has been disabled for the TWiki-4.0.0 release due to a potential security hole - you must be in the TWikiAdminGroup to create a web* * Set ALLOWWEBMANAGE = %MAINWEB%.TWikiAdminGroup ---+++ Search Settings * Default type for search, one of: keyword (for search engine like syntax), regex (for RegularExpression search), or literal (for verbatim search) * Set SEARCHDEFAULTTTYPE = keyword * Default for =%SEARCH{}%= variable, one of: keyword, regex, or literal * Set SEARCHVARDEFAULTTYPE = literal * Stop words, e.g., common words and characters to exclude from a keyword search: * 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 ---+++ E-mail Settings * 'Mail this topic' mailto: link - can be included in topics, templates or skins * Set MAILTHISTOPIC = %MAILTHISTOPICTEXT% * 'Mail this topic' link text * Set MAILTHISTOPICTEXT = Send a link to this page * URL for current topic * Set TOPICURL = %SCRIPTURL{"view"}%/%WEB%/%BASETOPIC% ---+++ HTTP-EQUIV Settings * %T% *NOTE:* 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. * *NOTE:* The current values of these preferences are not displayed in view mode (values are <link>-tags). * ==http-equiv== meta tags for ==view==, ==rdiff==, ==attach==, ==search*== scripts: * #Set HTTP_EQUIV_ON_VIEW = * Set HTTP_EQUIV_ON_VIEW = * ==http-equiv== meta tags for ==edit== script: * Set HTTP_EQUIV_ON_EDIT = * ==http-equiv== meta tags for ==preview== script: * Set HTTP_EQUIV_ON_PREVIEW = ---++ Skin Settings * Skin overriding the default TWiki templates: (can be overwritten by WebPreferences and user preferences) * Set SKIN = pattern * __Note:__ See TWikiSkinBrowser for currently installed skins ---+++ PatternSkin * Set SKIN = tdwg01,pattern * Set TWIKILAYOUTURL = %PUBURLPATH%/%TWIKIWEB%/Tdwg01Skin/layout.css * Set TWIKISTYLEURL = %PUBURLPATH%/%TWIKIWEB%/Tdwg01Skin/style.css * Set TWIKICOLORSURL = %PUBURLPATH%/%TWIKIWEB%/Tdwg01Skin/colors.css * #Default TWiki styles * #Set TWIKILAYOUTURL = %PUBURLPATH%/%TWIKIWEB%/PatternSkin/layout.css * #Set TWIKISTYLEURL = %PUBURLPATH%/%TWIKIWEB%/PatternSkin/style.css * #Set TWIKICOLORSURL = %PUBURLPATH%/%TWIKIWEB%/PatternSkin/colors.css * Custom overriding styles (enabled pr. default but empty, to prevent browsers from fetching %USERLAYOUTURL%-style URLs) * Set USERLAYOUTURL = * Set USERSTYLEURL = * Set USERCOLORSURL = * *PatternSkin header settings* * Set WEBHEADERART = %PUBURLPATH%/%TWIKIWEB%/PatternSkin/TWiki_header.gif * Set WEBHEADERBGCOLOR = #ffffff ---+++ Skin icons * Topic containing the icon graphics library. Icons can easily be rendered with =%ICON{name}%=. * Set ICONTOPIC = %TWIKIWEB%.TWikiDocGraphics ---+++ Legacy support * Support for legacy "EDITTOPIC", used to be hard-coded, now replaced by TMPL:P conditional instantiation * Set EDITURL = %SCRIPTURLPATH{"edit"}%/%WEB%/%TOPIC%?t=%GMTIME{"$epoch"}% * Set EDITTOPIC = Edit ---++ Plugins Settings * You can enable/disable Plugins using the [[%SCRIPTURLPATH{"configure"}%][configure]] interface. * 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. * Set DISABLEDPLUGINS = SpreadSheetPlugin,EditTablePlugin * Currently, %DISABLEDPLUGINS% is set to "%DISABLEDPLUGINS%" * Currently activated Plugins: %ACTIVATEDPLUGINS% * %T% *NOTE:* You can enable/disable Plugins by passing a comma-separated list of Plugin names in the =debugenableplugins= url parameter; for example, %SCRIPTURL{"view"}%/%WEB%/%TOPIC%?debugenableplugins=SmiliesPlugin will display this topic with all Plugins disabled except the SmiliesPlugin. * Detailed diagnostics can be found in InstalledPlugins * Legacy settings: * Set INSTALLEDPLUGINS = The INSTALLEDPLUGINS variable is no longer supported. You can set the Plugins execution order using the [[%SCRIPTURLPATH{"configure"}%][configure]] interface. #RenderingShortcuts ---++ Rendering Shortcuts Settings * Line break: * Set BR =
* Bullet sign: * Set BULLET = • * Vertical bar / pipe symbol: * Set VBAR = | * Line break and bullet with different levels of indentation: * Set BB =
• * Set BB2 =
  • * Set BB3 =
    • * Set BB4 =
      • * __Hint:__ Above shortcuts are useful in TWiki tables where you cannot use newlines #DocGraphics * 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.)_: * Set H =

* Set I =

* Set M =

* Set N =

* Set P =

* Set Q =

* Set S =

* Set T =

* Set U =

* Set X =

* Set Y =

* Colored text: (see more StandardColors) | You type: | =%RED% red text %ENDCOLOR% and %GREEN% green text %ENDCOLOR%= | | You get: | %RED% red text %ENDCOLOR% and %GREEN% green text %ENDCOLOR% | * __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%=. * %YELLOW% *Set YELLOW = looks like this* %ENDCOLOR% * %ORANGE% *Set ORANGE = looks like this* %ENDCOLOR% * %RED% *Set RED = looks like this* %ENDCOLOR% * %PINK% *Set PINK = looks like this* %ENDCOLOR% * %PURPLE% *Set PURPLE = looks like this* %ENDCOLOR% * %TEAL% *Set TEAL = looks like this* %ENDCOLOR% * %NAVY% *Set NAVY = looks like this* %ENDCOLOR% * %BLUE% *Set BLUE = looks like this* %ENDCOLOR% * %AQUA% *Set AQUA = looks like this* %ENDCOLOR% * %LIME% *Set LIME = looks like this* %ENDCOLOR% * %GREEN% *Set GREEN = looks like this* %ENDCOLOR% * %OLIVE% *Set OLIVE = looks like this* %ENDCOLOR% * %MAROON% *Set MAROON = looks like this* %ENDCOLOR% * %BROWN% *Set BROWN = looks like this* %ENDCOLOR% * %BLACK% *Set BLACK = looks like this* %ENDCOLOR% * %GRAY% *Set GRAY = looks like this* %ENDCOLOR% * %SILVER% *Set SILVER = looks like this* %ENDCOLOR% * %WHITE% *Set WHITE = looks like this (with gray background)* %ENDCOLOR% * The following color settings are enclosed in verbatim tags to avoid incorrect nesting of XHTML tags: * Set YELLOW = * Set ORANGE = * Set RED = * Set PINK = * Set PURPLE = * Set TEAL = * Set NAVY = * Set BLUE = * Set AQUA = * Set LIME = * Set GREEN = * Set OLIVE = * Set MAROON = * Set BROWN = * Set BLACK = * Set GRAY = * Set SILVER = * Set WHITE = * Set ENDCOLOR = ---++ Miscellaneous Settings * Format of a NewWikiWord link: %BR% * default setting: * Set NEWLINKFORMAT = $text? * alternative setting: * #Set NEWLINKFORMAT = $text * %TWIKIWEB%.PreviewBackground image: * Set PREVIEWBGIMAGE = %PUBURLPATH%/%TWIKIWEB%/PreviewBackground/preview2bg.gif * User-friendly synonyms for MAINWEB and TWIKIWEB * Set USERSWEB = %MAINWEB% * Set SYSTEMWEB = %TWIKIWEB% * Set DOCWEB = %TWIKIWEB% ---++ Access Control Settings * Users or groups allowed to change or rename this %TOPIC% topic: * Set ALLOWTOPICCHANGE = %MAINWEB%.TWikiAdminGroup * By default, only admins can create webs in the root * Set ALLOWROOTCHANGE = %MAINWEB%.TWikiAdminGroup ---++ Creating New Preference Variables You can introduce new VARIABLES and use them in your topics and templates. There is no need to change the TWiki engine (Perl scripts). * A preference is defined in a TWikiShorthand bullet item: ==[3 spaces] * [space] Set NAME = value==
Example (as a nested bullet item, indented 6 spaces): * Set WEBBGCOLOR = #FFFFC0 * Preferences are used as %TWIKIWEB%.TWikiVariables by enclosing the name in percent signs: ==%==. Example: * When you write variable ==%WEBBGCOLOR%==, it gets expanded to =%WEBBGCOLOR%= . * %X% The sequential order of the preference settings is significant. Define preferences that use other preferences FIRST. For example, set ==WEBCOPYRIGHT== before ==WIKIWEBMASTER== since the copyright notice uses the TWiki administrator e-mail address. * %X% In order to protect your custom variables from being overwritten when upgrading the [[%TWIKIWEB%.%TOPIC%]] topic, it is recommended that custom variables are defined in [[%MAINWEB%.%TOPIC%]]. ---++ Related Topics * %WEBPREFSTOPIC% has preferences of the %WEB% web. * %MAINWEB%.%WIKIUSERSTOPIC% has a list of user topics. User topics can have optional user preferences. * %TWIKIWEB%.TWikiVariables has a list of common =%VARIABLES%=. * %TWIKIWEB%.TWikiAccessControl explains how to restrict access by users or groups. * TWiki:Plugins.PreferencesPlugin makes editing preferences a snap. __Note__: Can't edit? [[%SCRIPTURLPATH{"view"}%/%WEB%/%TOPIC%?raw=on][View raw topic]]