RewriteEngine on

RewriteOptions AllowNoSlash InheritBefore

SetEnvIf Request_URI ^ innermost_dir=VegBIEN

# dir without trailing / is provided as an absolute filesystem path

RewriteCond %{ENV:innermost_dir} =VegBIEN

RewriteCond $0 ^/ [ornext]

RewriteCond /$0 ^(.*)$

RewriteRule ^.+$ db%1 [discardpath,last,noescape,qsappend]

include ../input.Makefile

RewriteEngine on

RewriteOptions AllowNoSlash InheritBefore

RewriteBase /VegBIEN/Redmine/wiki/

SetEnvIf Request_URI ^ innermost_dir=wiki

# dir without trailing / is provided as an absolute filesystem path

RewriteCond %{ENV:innermost_dir} =wiki

RewriteCond $0 ^(?!/)(.+)$ [ornext]

RewriteCond - ()

RewriteRule ^.+$ ../main/wiki/%1 [discardpath,last,noescape,qsappend]

RewriteEngine on

RewriteOptions AllowNoSlash InheritBefore

SetEnvIf Request_URI ^ innermost_dir=main

# dir without trailing / is provided as an absolute filesystem path

RewriteCond %{ENV:innermost_dir} =main

RewriteCond $0 ^/ [ornext]

RewriteCond /$0 ^(.*)$

RewriteRule ^.+$ https://projects.nceas.ucsb.edu/nceas/projects/bien%1 [discardpath,last,noescape,qsappend]

RewriteEngine on

RewriteOptions AllowNoSlash InheritBefore

RewriteBase /VegBIEN/Redmine/svn/

SetEnvIf Request_URI ^ innermost_dir=svn

# dir without trailing / is provided as an absolute filesystem path

RewriteCond %{ENV:innermost_dir} =svn

RewriteCond $0 ^/ [ornext]

RewriteCond /$0 ^(.*)$

RewriteRule ^.+$ https://code.nceas.ucsb.edu/code/projects/bien/trunk%1 [discardpath,last,noescape,qsappend]

RewriteEngine on

RewriteOptions AllowNoSlash InheritBefore

SetEnvIf Request_URI ^ innermost_dir=Redmine

# dir without trailing / is provided as an absolute filesystem path

RewriteCond %{ENV:innermost_dir} =Redmine

RewriteCond $0 ^/ [ornext]

RewriteCond /$0 ^(.*)$

RewriteRule ^.+$ wiki%1 [discardpath,last,noescape,qsappend]

RewriteEngine on

RewriteOptions AllowNoSlash InheritBefore

RewriteBase /VegBIEN/Redmine/svn-web/

SetEnvIf Request_URI ^ innermost_dir=svn-web

# dir without trailing / is provided as an absolute filesystem path

RewriteCond %{ENV:innermost_dir} =svn-web

RewriteCond $0 ^/ [ornext]

RewriteCond /$0 ^(.*)$

RewriteRule ^.+$ ../main/repository/entry%1 [discardpath,last,noescape,qsappend]

RewriteEngine on

RewriteOptions AllowNoSlash InheritBefore

SetEnvIf Request_URI ^ innermost_dir=db

# dir without trailing / is provided as an absolute filesystem path

RewriteCond %{ENV:innermost_dir} =db

RewriteCond $0 ^/ [ornext]

RewriteCond /$0 ^(.*)$

RewriteRule ^.+$ /servers/vegbiendev/vegbien%1 [discardpath,last,noescape,qsappend]

link fs/planning

# Autogenerated httpd.conf file for TWiki.

# Generated at http://twiki.org/cgi-bin/view/TWiki/ApacheConfigGenerator

# IMPORTANT NOTE: Make sure to enable mod_cgid in the primary apache configuration file.

# We set an environment variable called blockAccess.

#

# Setting a BrowserMatchNoCase to ^$ is important. It prevents TWiki from

# including its own topics as URLs and also prevents other TWikis from

# doing the same. This is important to prevent the most obvious

# Denial of Service attacks.

#

# You can expand this by adding more BrowserMatchNoCase statements to

# block evil browser agents trying the impossible task of mirroring a twiki

#

# Example:

# BrowserMatchNoCase ^SiteSucker blockAccess

# BrowserMatchNoCase ^$ blockAccess

BrowserMatchNoCase ^Accoona blockAccess

BrowserMatchNoCase ^ActiveAgent blockAccess

BrowserMatchNoCase ^Attache blockAccess

BrowserMatchNoCase BecomeBot blockAccess

BrowserMatchNoCase ^bot blockAccess

BrowserMatchNoCase Charlotte/ blockAccess

BrowserMatchNoCase ^ConveraCrawler blockAccess

BrowserMatchNoCase ^CrownPeak-HttpAgent blockAccess

BrowserMatchNoCase ^EmailCollector blockAccess

BrowserMatchNoCase ^EmailSiphon blockAccess

BrowserMatchNoCase ^e-SocietyRobot blockAccess

BrowserMatchNoCase ^Exabot blockAccess

BrowserMatchNoCase ^FAST blockAccess

BrowserMatchNoCase ^FDM blockAccess

BrowserMatchNoCase ^GetRight/6.0a blockAccess

BrowserMatchNoCase ^GetWebPics blockAccess

BrowserMatchNoCase ^Gigabot blockAccess

BrowserMatchNoCase ^gonzo1 blockAccess

BrowserMatchNoCase ^Google\sSpider blockAccess

BrowserMatchNoCase ^ichiro blockAccess

BrowserMatchNoCase ^ie_crawler blockAccess

BrowserMatchNoCase ^iGetter blockAccess

BrowserMatchNoCase ^IRLbot blockAccess

BrowserMatchNoCase Jakarta blockAccess

BrowserMatchNoCase ^Java blockAccess

BrowserMatchNoCase ^KrakSpider blockAccess

BrowserMatchNoCase ^larbin blockAccess

BrowserMatchNoCase ^LeechGet blockAccess

BrowserMatchNoCase ^LinkWalker blockAccess

BrowserMatchNoCase ^Lsearch blockAccess

BrowserMatchNoCase ^Microsoft blockAccess

BrowserMatchNoCase ^MJ12bot blockAccess

BrowserMatchNoCase MSIECrawler blockAccess

BrowserMatchNoCase ^MSRBOT blockAccess

BrowserMatchNoCase ^noxtrumbot blockAccess

BrowserMatchNoCase ^NutchCVS blockAccess

BrowserMatchNoCase ^RealDownload blockAccess

BrowserMatchNoCase ^Rome blockAccess

BrowserMatchNoCase ^Roverbot blockAccess

BrowserMatchNoCase ^schibstedsokbot blockAccess

BrowserMatchNoCase ^Seekbot blockAccess

BrowserMatchNoCase ^SiteSnagger blockAccess

BrowserMatchNoCase ^SiteSucker blockAccess

BrowserMatchNoCase ^Snapbot blockAccess

BrowserMatchNoCase ^sogou blockAccess

BrowserMatchNoCase ^SpiderKU blockAccess

BrowserMatchNoCase ^SpiderMan blockAccess

BrowserMatchNoCase ^Squid blockAccess

BrowserMatchNoCase ^Teleport blockAccess

BrowserMatchNoCase ^User-Agent\: blockAccess

BrowserMatchNoCase VoilaBot blockAccess

BrowserMatchNoCase ^voyager blockAccess

BrowserMatchNoCase ^W3C blockAccess

BrowserMatchNoCase ^w3search blockAccess

BrowserMatchNoCase ^Web\sDownloader blockAccess

BrowserMatchNoCase ^WebCopier blockAccess

BrowserMatchNoCase ^WebDevil blockAccess

BrowserMatchNoCase ^WebSec blockAccess

BrowserMatchNoCase ^WebVac blockAccess

BrowserMatchNoCase ^Webwhacker blockAccess

BrowserMatchNoCase ^Webzip blockAccess

BrowserMatchNoCase ^Wells blockAccess

BrowserMatchNoCase ^WhoWhere blockAccess

BrowserMatchNoCase www\.netforex\.org blockAccess

BrowserMatchNoCase ^WX_mail blockAccess

BrowserMatchNoCase ^yacybot blockAccess

BrowserMatchNoCase ^ZIBB blockAccess

BrowserMatchNoCase ^$ blockAccess

<IfModule mod_perl.c>

	# Mod_perl preloading

	PerlSwitches -T

</IfModule>

# The ScriptAlias defines the bin directory as a directory where CGI

# scripts are allowed.

# The first parameter will be part of the URL to your installation e.g.

# http://example.com/do/view/...

# The second parameter must point to the physical path on your disc.

ScriptAlias /twiki/do "/home/bien/svn/web/.twiki/bin"

# The Alias defines a url that points to the twiki pub directory, which

# is the root of file attachments.

Alias /twiki/pub "/home/bien/svn/web/.twiki/pub"

Alias /twiki "/home/bien/svn/web/.twiki"

# Block access to typical spam related attachments

# Except the TWiki directory which is read only and does have attached html files.

SetEnvIf Request_URI "/twiki/pub/.*\.[hH][tT][mM][lL]?$" blockAccess

SetEnvIf Request_URI "/twiki/pub/TWiki/.*\.[hH][tT][mM][lL]?$" !blockAccess

# This specifies the options on the TWiki scripts directory. The ExecCGI

# and SetHandler tell apache that it contains scripts. "Require all granted"

# lets any IP address access this URL.

<Directory "/home/bien/svn/web/.twiki/bin">

	AllowOverride None

	Require all granted

	Deny from env=blockAccess

	Options ExecCGI FollowSymLinks

	SetHandler cgi-script

	# Password file for TWiki users

	#AuthUserFile /home/bien/svn/web/.twiki/data/.htpasswd

	#AuthName 'Enter your WikiName: (First name and last name, no space, no dots, capitalized, e.g. JohnSmith)'

	#AuthType Basic

	# File to return on access control error (e.g. wrong password)

	ErrorDocument 401 /twiki/do/view/TWiki/ResetPassword

</Directory>

<Directory "/home/bien/svn/web/.twiki">

	Require all granted

	Deny from env=blockAccess

	RedirectMatch ^/twiki/([A-Z0-9].*)?$ /twiki/do/view/Main/$1

	# File to return on access control error (e.g. wrong password)

	ErrorDocument 401 /twiki/do/view/TWiki/ResetPassword

</Directory>

# This sets the options on the pub directory, which contains attachments and

# other files like CSS stylesheets and icons. AllowOverride None stops a

# user installing a .htaccess file that overrides these options.

# Note that files in pub are *not* protected by TWiki Access Controls,

# so if you want to control access to files attached to topics you need to

# block access to the specific directories same way as the ApacheConfigGenerator

# blocks access to the pub directory of the Trash web

<Directory "/home/bien/svn/web/.twiki/pub">

	#Options None

	Options FollowSymLinks

	AllowOverride None

	Require all granted

	Deny from env=blockAccess

	# Disable execusion of PHP scripts

	php_admin_flag engine off

	# This line will redefine the mime type for the most common types of scripts

	AddType text/plain .shtml .php .php3 .phtml .phtm .pl .py .cgi

#add an Expires header that is sufficiently in the future that the browser does not even ask if its uptodate

# reducing the load on the server significantly

#IF you can, you should enable this - it _will_ improve your twiki experience, even if you set it to under one day.

# you may need to enable expires_module in your main apache config

#LoadModule expires_module libexec/httpd/mod_expires.so

#AddModule mod_expires.c

#<ifmodule mod_expires.c>

#  <filesmatch "\.(jpg|gif|png|css|js)$">

#		ExpiresActive on

#		ExpiresDefault "access plus 11 days"

#	</filesmatch>

#</ifmodule>

</Directory>

# Spammers are known to attach their stuff and then move it to trash where it remains unnoticed.

# We prevent viewing any attachments directly from pub

<Directory "/home/bien/svn/web/.twiki/pub/Trash">

   deny from all

</Directory>

%{ This is a default template }%%TMPL:INCLUDE{"twiki"}%

%TMPL:DEF{"webaction"}%%MAKETEXT{"TWiki User Authentication"}%%TMPL:END%

%TMPL:DEF{"titleaction"}%%MAKETEXT{"(login)"}% %TMPL:END%

%TMPL:DEF{"LOG_IN_BANNER"}%%TMPL:END%

%TMPL:DEF{"LOGGED_IN_BANNER"}%%MAKETEXT{"[_1] is currently logged in" args="%USERSWEB%.%WIKINAME%"}%%TMPL:END%

%TMPL:DEF{"NEW_USER_NOTE"}%%MAKETEXT{"Enter a new username and password to change identity"}%%TMPL:END%

%TMPL:DEF{"UNRECOGNISED_USER"}%%MAKETEXT{"Oops: we could not recognize you. Try again or [[[_1]][reset your password]]." args="%SYSTEMWEB%.ResetPassword"}%%TMPL:END%

%TMPL:DEF{"pagetitle"}%%TMPL:END%

%TMPL:DEF{"titleaction"}%%MAKETEXT{"([_1] login)" args="<nop>%WIKITOOLNAME%"}%%TMPL:END%

%TMPL:DEF{"title"}%---++ %MAKETEXT{"Please enter your username and password"}%

<p>&nbsp;</p>

---+ *<span style="line-height: normal; font-size: 140%;">%MAKETEXT{"If you do not have an account,<br/>[[TWiki.TWikiRegistration][click here to register]]"}%</span>*

%TMPL:END%

%TMPL:DEF{"titlestep"}%<div class="twikiFormStep">

%TMPL:P{"title"}%

%TMPL:P{"notestep"}%

%TMPL:P{"errorstep"}%</div><!-- /twikiFormStep-->%TMPL:END%

%TMPL:DEF{"notestep"}%<div style="display:%IF{'defined ERROR or defined NOTE or defined BANNER' then='block' else='none'}%;">

%IF{"defined NOTE AND $NOTE != ''" then='---+++ %NOTE%'}%</div>%TMPL:END%

%TMPL:DEF{"errorstep"}%%IF{"defined BANNER AND $BANNER != ''" then='<div class="twikiNotification twikiAlert twikiUnvisited patternLoginNotification">%BANNER%%IF{"defined ERROR AND $ERROR != ''" then='<!--%TMPL:P{"error"}%-->'}%</div>'}%%TMPL:END%

%TMPL:DEF{"error"}%%MAKETEXT{"Error: [_1]" args="%ERROR%"}%%TMPL:END%

%TMPL:DEF{"authrealm"}%%AUTHREALM%%TMPL:END%

%TMPL:DEF{"formstart"}%<form action='%SCRIPTURLPATH{"login"}%/%WEB%/%TOPIC%' name='loginform' method='post'>%TMPL:END%

%TMPL:DEF{"formend"}%<literal>

%QUERYPARAMS{encoding="entity" format="<input type='hidden' name='$name' value='$value' />"}%

</literal><input type="hidden" name="origurl" value="%ORIGURL%" /></form>%TMPL:END%

%TMPL:DEF{"usernamefield"}%<input tabindex='1' type='text' class='twikiInputField twikiFocus' size='40' name='username' value='%URLPARAM{"usernamestep"}%' %TMPL:P{context="no_auto_complete_login" then="autocomplete_off"}% />%TMPL:END%

%TMPL:DEF{"usernamestep"}%<div class="twikiFormStep">

---+++ %MAKETEXT{"Username"}%

%TMPL:P{"usernamefield"}% %TMPL:P{"usernamefieldhelp"}%

</div><!-- /twikiFormStep-->%TMPL:END%

%TMPL:DEF{"usernamenote"}%%TMPL:P{"authrealm"}%%TMPL:END%

%TMPL:DEF{"usernamefieldhelp"}%%TWISTY{mode="span" showlink="%MAKETEXT{"Help"}%" hidelink="%MAKETEXT{"Hide help"}%" remember="on"}% <div class="twikiHelp">%TMPL:P{"usernamenote"}%</div> %ENDTWISTY%%TMPL:END%

%TMPL:DEF{"passwordfield"}%<input tabindex='2' type='password' class='twikiInputField' size='40' name='password' value='' %TMPL:P{context="no_auto_complete_login" then="autocomplete_off"}% />%TMPL:END%

%TMPL:DEF{"autocomplete_off"}% autocomplete='off' %TMPL:END%

%TMPL:DEF{"passwordfieldnoteremember"}%%TMPL:P{"passwordfield"}% %TMPL:P{"passwordnote"}%

%TMPL:P{context="can_remember_login" then="rememberbox"}%%TMPL:END%

%TMPL:DEF{"passwordstep"}%<div class="twikiFormStep">

---+++ %MAKETEXT{"Password"}%

%TMPL:P{"passwordfieldnoteremember"}%

</div><!-- /twikiFormStep-->%TMPL:END%

%TMPL:DEF{"passwordnote"}%<span class="twikiUnvisited">[[%SYSTEMWEB%.ResetPassword][%MAKETEXT{"I forgot my password"}%]]</span>%TMPL:END%

%TMPL:DEF{"rememberbox"}%%BR%<input tabindex='3' id="remember" name="remember" type="checkbox" value="1" /><label for="remember">&nbsp;%MAKETEXT{"Remember me on this computer"}%</label>%TMPL:END%

%TMPL:DEF{"submitstep"}%<div class="twikiFormStep">%TMPL:P{"submit"}%</div><!-- /twikiFormStep-->%TMPL:END%

%TMPL:DEF{"submit"}%<input tabindex='4' type='submit' class='twikiSubmit' value='%MAKETEXT{"Logon"}%' />%TMPL:END%

%{ please keep the spaces between the div and the TMPL seealsonote, it allows TWiki to process the emailaddress }%

%TMPL:DEF{"seealsostep"}%<div class="twikiFormStep twikiGrayText twikiLast"> %TMPL:P{"seealsonote"}% </div><!-- /twikiFormStep-->%TMPL:END%

%TMPL:DEF{"seealsonote"}% %MAKETEXT{"If you have any questions, please contact [_1]" args="%IF{"defined WIKIWEBMASTER AND $WIKIWEBMASTER != ''" then="%WIKIWEBMASTER%" else="your TWiki administrator"}%"}% %TMPL:END%

%TMPL:DEF{"form"}%<div id="twikiLogin">

<div class="twikiFormSteps">%TMPL:P{"formstart"}%%TMPL:P{"titlestep"}%

%TMPL:P{"usernamestep"}%%TMPL:P{"passwordstep"}%%TMPL:P{"submitstep"}%

%TMPL:P{"formend"}%

%TMPL:P{"seealsostep"}%

</div><!-- /twikiFormSteps-->

</div><!-- /twikiLogin-->%TMPL:END%

%TMPL:DEF{"content"}%%TMPL:P{"form"}%%TMPL:END%

exclude /**

exclude /**

%META:TOPICINFO{author="BaseUserMapping_333" date="1366699085" format="1.1" version="1.9"}%

---+!! %MAKETEXT{"Local customisations of site-wide preferences"}%

<div class="twikiHelp">%ICON{"info"}% %MAKETEXT{"Site-level preferences are located in [_1], however this [_2] prefs topic has override priority and should be used for local customisations. This allows for easier upgrades as you don't need to worry about the shipped preferences clobbering yours. It's easier to keep a handle on if you only copy over the settings you actually change." args="[[%SYSTEMWEB%.%TOPIC%]], [[%USERSWEB%.%TOPIC%]]"}% </div>

%EDITPREFERENCES{"%SYSTEMWEB%/TWikiPreferencesForm"}%

%IF{"$ SCRIPTNAME != 'viewauth%SCRIPTSUFFIX%'" then="<span class='twikiGrayText'>%MAKETEXT{"Quick edit of existing preferences (edit the topic text to set new preferences)"}%</span>" }%

---++ Site Specific Site-wide Preferences

<!-- Add site-wide preferences here -->

      * Set FORCENEWREVISIONCHECKBOX = checked="checked"

      * Set DONTNOTIFYCHECKBOX = checked="checked"

---++ Final Preferences

   * =FINALPREFERENCES= locks site-level preferences that are *not* allowed to be overridden by [[%WEBPREFSTOPIC%]] or user preferences:

      * Set FINALPREFERENCES = ATTACHFILESIZELIMIT, PREVIEWBGIMAGE, WIKITOOLNAME, WIKIHOMEURL, ALLOWROOTCHANGE, DENYROOTCHANGE, TWIKILAYOUTURL, TWIKISTYLEURL, TWIKICOLORSURL, USERSWEB, SYSTEMWEB, DOCWEB

---++ Security Settings

   * Only TWiki administrators are allowed to change this topic:

      * Set ALLOWTOPICCHANGE = TWikiAdminGroup

      * Set ALLOWTOPICRENAME = TWikiAdminGroup

   * Disable WYSIWYG editor for this preferences topic only:

      * Local TINYMCEPLUGIN_DISABLE = on

__Related topics:__ [[%SYSTEMWEB%.%TOPIC%]], [[%SYSTEMWEB%.TWikiVariables][TWikiVariables]], [[%SYSTEMWEB%.TWikiAccessControl][TWikiAccessControl]]

%META:TOPICINFO{author="TWikiContributor" date="1310334724" format="1.1" version="13"}%

---+!! !TinyMCEPlugin

<!--

   Contributions to this plugin are appreciated. Please update the plugin page at

   http://twiki.org/cgi-bin/view/Plugins/TinyMCEPlugin or provide feedback at

   http://twiki.org/cgi-bin/view/Plugins/TinyMCEPluginDev.

   If you are a TWiki contributor please update the plugin in the SVN repository.

   * Set SHORTDESCRIPTION = Integration of the !TinyMCE WYSIWYG Editor

-->

<sticky><div style="float:right; margin:0 0 20px 20px;">

<div style="background-color:#EBEEF0; padding: 0 10px 0 10px;">

%TOC{title="Page contents"}%

</div>

<img src="%ATTACHURL%/screenshot.gif" alt="" width="400" height="278" />

</div></sticky>

%SHORTDESCRIPTION%

---++ Introduction

This is an integration of the <a href="http://tinymce.moxiecode.com?id=powered_by_tinymce_mini"><img src="http://tinymce.sourceforge.net/buttons/tinymce_button.png" border="0" width="80" height="15" alt="TinyMCE" /></a> WYSIWYG editor. This is great little editor, fast and highly functional, and supporting a wide range of browsers, including Firefox, IE and Safari. At the time of writing it doesn't work with Opera or Konqueror.

The integration uses the TWiki:Plugins.WysiwygPlugin to translate text to and from a format that !TinyMCE can edit.

Unlike the other editor integrations in TWiki, which install "Word in a Browser" style editors, this plugin is able to swap out the _standard_ text areas in an edit and replace them with WYSIWYG editors. This means you get WYSIWYG editors for textareas in forms, as well as for the main text of the topic. It can also co-exist alongside other WYSIWYG editors, such as Kupu.

The editor automatically "switches itself off" (i.e. reverts to the old text-only window) when editing topics that contain TWiki content it can't handle, such as complex TWiki variables.

---++ Editor Notes

The editor uses a translator module to convert from TWiki markup language (TML) to HTML and back. The translator converts special TWiki tags - such as %<nop>VARIABLES% - to plain text, and encloses them within HTML spans using a special style called =WYSIWYG_PROTECTED=. In this way the editor can detect text that is not meant to be HTML formatted. This style is _also_ used to protect special text you enter into the editor from being interpreted when the topic is translated back into TML. If you want to add any special TWiki features that are sensitive to formatting, such as =Set= statements, then you have to format those regions using 'Protect on save' or 'Protect forever'.

---++ Installation Instructions

__NOTES:__

   * This plugin comes pre-installed on TWiki. You should only need to re-install if there is an upgrade to the plugin.

   * It requires the very latest revision of WysiwygPlugin. It will *not* work with the version shipped with TWiki 4.1.2.

   * When installed, it *replaces* the old "textarea" editor. If you want to maintain access to the old editor from the standard screens, follow the instructions under [[#InstallingOnOldTWikis][Configuring the buttons on TWiki < 4.2.0]].

First follow the installation instructions to install the Plugin:

   * For an __automated installation__, run the [[%SCRIPTURL{configure}%][configure]] script and follow "Find More Extensions" in the in the __Extensions__ section.

      * See the [[http://twiki.org/cgi-bin/view/Plugins/BuildContribInstallationSupplement][installation supplement]] on TWiki.org for more information.

   * Or, follow these __manual installation__ steps:

      * Download the ZIP file from the extension home on twiki.org (see below).

      * Unzip ==%TOPIC%.zip== in your twiki installation directory.

      * Set the ownership of the extracted directories and files to the webserver user.

      * Install the dependencies (if any).

   * Plugin __configuration and testing__: 

      * Run the [[%SCRIPTURL{configure}%][configure]] script and enable the plugin in the __Plugins__ section.

      * Configure additional plugin settings in the __Extensions__ section if needed.

      * Test if the installation was successful using the examples provided.

   * *Enable* the WysiwygPlugin in =configure=.

   * *Enable* the TinyMCEPlugin in =configure=.

   * *Click* on edit of any topic.

---++ Settings

You can override this setting by defining TINYMCEPLUGIN_DEBUG to enable some simple debug features.

   * Set DEBUG = 0

This setting contains all the options passed to the !TinyMCE editor on startup. For a full explanation of the available options, and guidance on reconfiguring !TinyMCE, see the [[http://wiki.moxiecode.com/index.php/TinyMCE:Configuration][Moxicode TinyMCE Wiki]]. Note the inclusion of the Pattern Skin standard CSS files in the =content_css= setting.

<verbatim>

   * Set INIT = mode:"textareas",

   editor_selector : "twikiTextarea",

   save_on_tinymce_forms: true,

   cleanup : true,

   theme : "advanced",

   inline_styles : false,

   convert_urls : true,

   relative_urls : false,

   remove_script_host : false,

   setupcontent_callback : TWikiTiny.setUpContent,

   urlconverter_callback : "TWikiTiny.convertLink",

   hide_instance_callback : TWikiTiny.switchToRaw,

   show_instance_callback : TWikiTiny.switchToWYSIWYG,

   twikipuburl_callback : "TWikiTiny.convertPubURL",

   save_callback : "TWikiTiny.saveCallback",

   %IF{"$TINYMCEPLUGIN_DEBUG" then="debug:true,"}%

   plugins : "table,searchreplace,autosave,paste,twikibuttons,twikiimage%IF{"$TINYMCEPLUGIN_DEBUG" then=",devkit"}%",

   twiki_secret_id : "%WYSIWYG_SECRET_ID%",

   twiki_vars : { PUBURLPATH : "%PUBURLPATH%", PUBURL : "%PUBURL%", WEB : "%WEB%", TOPIC : "%TOPIC%", ATTACHURL : "%ATTACHURL%", ATTACHURLPATH : "%ATTACHURLPATH%", VIEWSCRIPTURL : "%SCRIPTURL{view}%", SCRIPTSUFFIX: "%SCRIPTSUFFIX%", SCRIPTURL : "%SCRIPTURL%" },

   theme_advanced_toolbar_align : "left",

   twikibuttons_formats : [

   { name: "Normal", el: "", style: null },

   { name: "Heading 1", el: "h1", style: false },

   { name: "Heading 2", el: "h2", style: false },

   { name: "Heading 3", el: "h3", style: false },

   { name: "Heading 4", el: "h4", style: false },

   { name: "Heading 5", el: "h5", style: false },

   { name: "Heading 6", el: "h6", style: false },

   { name: "Blockquote", el: "blockquote", style: false },

   { name: "VERBATIM", el: "pre", style: "TMLverbatim" },

   { name: "LITERAL", el: "span", style: "WYSIWYG_LITERAL" },

   { name: "Protect on save", el: null, style: "WYSIWYG_PROTECTED" },

   { name: "Protect forever", el: null, style: "WYSIWYG_STICKY" }

   ],

   paste_create_paragraphs : true,

   paste_create_linebreaks : false,

   paste_convert_middot_lists : true,

   paste_convert_headers_to_strong : false,

   paste_remove_spans: true,

   paste_remove_styles: true,

   paste_strip_class_attributes: "all",

   theme_advanced_buttons1 : "twikiformat,separator,bold,italic,underline,strikethrough,tt,colour,removeformat,separator,bullist,numlist,outdent,indent,separator,link,unlink,anchor,separator,attach,image,charmap,hr,separator,undo,redo,separator,search,replace",

   theme_advanced_buttons2: "tablecontrols,separator,code,hide",

   theme_advanced_buttons3: "",

   theme_advanced_toolbar_location: "top",

   theme_advanced_resize_horizontal : false,

   theme_advanced_resizing : true,

   theme_advanced_path: false,

   theme_advanced_statusbar_location : "bottom",

   content_css : "%PUBURLPATH%/%SYSTEMWEB%/TinyMCEPlugin/wysiwyg%IF{"$TINYMCEPLUGIN_DEBUG" then="_src"}%.css,%PUBURLPATH%/%SYSTEMWEB%/TWikiTemplates/base.css,%TWIKISTYLEURL%,%TWIKICOLORSURL%"

</verbatim>

   * Additional settings for specific browsers.

      * Warning: if you enable =paste_auto_cleanup_on_paste then it automatically implies =past_use_dialog= on all non-MSIE browsers.

      * Set INIT_MSIE = paste_auto_cleanup_on_paste : true

      * Set INIT_OPERA = 

      * Set INIT_GECKO = 

      * Set INIT_SAFARI = 

You can override these settings in the same way as any other TWiki variable, by setting e.g. =TINYMCEPLUGIN_INIT= in the site, web or topic preferences. You are *not* recommended to edit the setting here.

   * You can *disable* the plugin in any web or topic, or for any specific user, by setting the =TINYMCEPLUGIN_DISABLE= preferences setting to 1.

      * Alternatively (preferred), you can give the user an option to use the WYSIWYG editor or raw editor with the =EDITMETHOD= preferences setting set to =wysiwyg= (default) or =raw=.

   * Some browsers don't support !TinyMCE. You can prevent the editor from

     being invoked on these browsers by setting =TINYMCEPLUGIN_BAD_BROWSERS= to a regular expression that matches the user-agent string for any broken browsers. The default is =(?i-xsm:Konqueror|Opera)=.   

%INCLUDE{"%SYSTEMWEB%.WysiwygPluginSettings"}%

#InstallingOnOldTWikis

---++ Configuring the buttons on TWiki < 4.2.0

When installed on TWiki versions before 4.2.0, this plugin *replaces* the old textarea editor with the !TinyMCE editor. The shock of this change can be too much for some older contributors, so we have written instructions for reconfiguring your templates in TWiki:Plugins.TinyMCEFrequentlyAskedQuestions.

---++ Plugin Info

Many thanks to the following sponsors for supporting this work:

   * [[http://ilog.fr/][ILOG]]

   * [[http://www.carrier.com/][Carrier Corporation]]

   * [[http://twiki.net/][Twiki, Inc.]]

|  Plugin Author: | TWiki:Main.CrawfordCurrie |

|  Copyright: | © 2007-2008 Crawford Currie http://c-dot.co.uk, %BR% © 2007-2011 TWiki:TWiki.TWikiContributor |

|             | This package also includes the complete sources for version 3.2.4.1 of the !TinyMCE editor |

|  License: | [[http://www.gnu.org/licenses/gpl.html][GPL (Gnu General Public License)]] |

|  Plugin Version: | 2011-07-10 24853 (2013-02-16) |

|  Change History: | <!-- versions below in reverse order -->&nbsp; |

|  2011-07-10: | TWikibug:Item6725: Change global package variables from "use vars" to "our" |

|  2010-11-05 | TWikibug:Item6604: Add documentation for EDITMETHOD setting |

|  2010-04-24 | TWikibug:Item6433: Doc improvements, prepare for TWiki 5.0 release |

|  2009-09-08 | TWikibug:Item6334: Upgrade plugin to latest !TinyMCE version 3.2.4.1 from 2.1.1.1 -- TWiki:Main/SopanShewale |

|  03 Aug 2008 | TWiki 4.2.1 release version |

|  04 May 2008 | TWikibug:Item5547: Change mechanism by which TMCE recognises textareas to camp on. Use class instead of element name. |

|  12 Apr 2008 | TWikibug:Item4946: I think I have finally fixed non-iso-8859-1 character sets. Painful. |

|  31 Mar 2008 | TWikibug:Item5314: TWikibug:Item5457: Fixed pickaxe mode for editing UTF-8. Characters above 255 are converted to entitites, which is a bit of a PITA, but at least it no longer corrupts topics. *NOTE: YOU MUST UPGRADE WysiwygPlugin TO 16600 OR LATER* |

|  28 Mar 2008 | TWikibug:Item5432: added upper case file extensions for images TWikibug:Item5206: fixed expansion of simple filenames entered in image popup TWikibug:Item5462: fixed hide attachment switch |

|  25 Jan 2008 | TWikibug:Item5287: links entered through dialog weren't working |

|  24 Jan 2008 | TWikibug:Item4840: TWikibug:Item5138: UTF8 fixes, TWikibug:Item5022: made TT font size same as verbatim. Had to add a new style to do it, as TMCE didn't want to play with TT or CODE tags. TWikibug:Item5138: post-conversion of 8-bit entities to characters to aid searching, TWikibug:Item5254: non-fatal JS error fixed, TWikibug:Item5263: remove preview on WYSIWYG edit, TWikibug:Item5116: added Opera to bad browsers filter |

|  20 Dec 2007 | TWikibug:Item5047: disable save and preview during page load TWikibug:Item5111: make the entry in the format menu sensitive to where the cursor is TWikibug:Item5022: made TT font size same as verbatim. Had to add a new style to do it, as TMCE didn't want to play with TT or CODE tags. |

|  19 Nov 2007 | TWikibug:Item4742: auto-disable if Wysiwyg is not enabled TWikibug:Item4820: validate mandatory fields on save TWikibug:Item4747: add <sticky> TWikibug:Item4811: noautolink *looks* like an HTML construct but in fact is not; the tag is infact an "on-off" switch and does not imply any HTML structure, so cannot be converted to a DIV or a span, so has to be removed. TWikibug:Item4817: added typewriter text button TWikibug:Item4850: added font colour controls TWikibug:Item4645: added attachment management features TWikibug:Item4945: added switch to raw and back |

|  16 Sep 2007 | TWikibug:Item4630: polished up the way the secret string is done, to ensure synch between perl and JS. TWikibug:Item4622: added UTF-8 handling steps that fixup malformed UTF8 strings before presenting them to the editor (saves Moz) and stops the editor passing them back to TWiki (saves IE). TWikibug:Item4603: added the draft help, so we can at least build the beta without the nasty warning |

|  13 Sep 2007 | TWikibug:Item4613 fixed navigate-away prompt when unchanged TWikibug:Item4583 TWikibug:Item4604 TWikibug:Item4614 TWikibug:Item4616 A clutch of issues caused by use of the wrong encoding function when passing UTF8 parameters to REST using !XMLHttpRequest. |

|  12 Sep 2007 | TWikibug:Item4604 Converted to REST call for content conversion, to provide safe callback if JS is disabled in the browser TWikibug:Item4583 relaxed regex to try and make it work for UTF-8 topic names |

|  11 Sep 2007 | TWikibug:Item4535 refinements to link handling to improve topic name recognition |

|  7 Sep 2007 | TWikibug:Item4503 excess empty lines TWikibug:Item4486 no toc headers with unofficial syntax TWikibug:Item4560: empty lines lost TWikibug:Item4566: corrupted table on save |

|  6 Sep 2007 | TWikibug:Item4557 added missing files to package |

|  4 Sep 2007 | TWikibug:Item4534 TWikibug:Item4535 fixed |

|  14679 | TWikibug:Item4481 TWikibug:Item4524 fixed |

|  14668 | Bugfixes and refinements done as part of 4.2 release |

|  14543 | Added PROTECTED style, to allow protection of special text. Disable on unsupported browsers (untested) |

|  14538 | First release |

|  Dependencies: | <table border="1"><tr><th>Name</th><th>Version</th><th>Description</th></tr><tr><td align="left">TWiki::Plugins::BehaviourContrib</td><td align="left">&gt;=15357</td><td align="left">Javascript module</td></tr><tr><td align="left">TWiki::Plugins::WysiwygPlugin</td><td align="left">&gt;=16650</td><td align="left">Translator module</td></tr></table> |

|  Plugin Home: | http://twiki.org/cgi-bin/view/Plugins/TinyMCEPlugin |

|  Feedback: | http://twiki.org/cgi-bin/view/Plugins/TinyMCEPluginDev |

|  Appraisal: | http://twiki.org/cgi-bin/view/Plugins/TinyMCEPluginAppraisal |

%META:FILEATTACHMENT{name="tinymce.gif" attr="h" comment="screenshot" version="1"}%

%META:FILEATTACHMENT{name="screenshot.gif" attr="h" comment="" version="1"}%

%META:TOPICINFO{author="TWikiContributor" date="1357464271" format="1.1" version="87"}%

---+!! <nop>%WIKITOOLNAME% Site-Level Preferences

This topic defines __site-level__ settings that apply to all users and webs on this TWikiSite.

<div class="twikiNotification"> __%X% NOTE:__ Don't edit this topic, changes will be lost on the next TWiki upgrade. Define new site-level settings, or overload below settings in [[%LOCALSITEPREFS%]] </div>

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.

%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 <input type="text" name="topic" size="16" />

   * 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 %SYSTEMWEB%.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. <nop>%WEB%.Topic links.

      * Set SITEMAPLIST = on

      * Set SITEMAPWHAT = Describe what this web does

#CopyrightNotice

   * Copyright notice:

      * Set WEBCOPYRIGHT = %MAKETEXT{"Copyright &&copy; [_1] by the contributing authors. All material on this collaboration platform is the property of the contributing authors." args="2008-%GMTIME{$year}%"}% <br /> %MAKETEXT{"Ideas, requests, problems regarding [_1]? <a href='[_2]'>Send feedback</a>" args="<nop>%WIKITOOLNAME%,mailto:%WIKIWEBMASTER%?subject=%WIKITOOLNAME%%20Feedback%20on%20%BASEWEB%.%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 = 

   * Prevent automatic linking of [[%SYSTEMWEB%.WikiWords][WikiWords]] and acronyms (if set to =on=); link <nop>WikiWords (if empty); can be overwritten by web preferences:

      * Set NOAUTOLINK = 

      * __Note:__ Use the =[<nop>[...][...]]= syntax to link topics in case you disabled <nop>WikiWord linking. The =&lt;noautolink&gt; ... &lt;/noautolink&gt;= syntax can be used to prevents links within a block of text.

   * If you use non !WikiWords for topic names (for example "Expenses" or "Mighty1") and if you use bracket notation to link to those topics, it is useful to *turn of all warnings* (like: "WARNING: This topic name is not recommended because it will not be linked automatically") and checkboxes ("Allow non !WikiWord for the new topic name"). Can be overwritten by web preferences. Set to =on= to activate:

      * Set HIDE_NON_WIKI_WORD_WARNINGS =

   * Warn if =%<nop>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 =%<nop>INCLUDE{}%= :

      * Set INCLUDEWARNING = on

#TableOfContents

   * Generated Table of Contents (TOC) settings

      * The first header level to appear in the TOC:

         * Set TOC_MIN_DEPTH =

            * If not set: =1=

            * Possible values: =1= to =6=

      * The last header level to appear in the TOC:      

         * Set TOC_MAX_DEPTH =

            * If not set: =6=

            * Possible values: =1= to =6=

            * Can be overridden by =depth= parameter of [[%SYSTEMWEB%.VarTOC2][variable TOC]]

      * The default TOC title:

         * Set TOC_TITLE =

            * If not set: nothing

            * Possible values: any string, for example =On this page:=

            * Can be overridden by =title= parameter of [[%SYSTEMWEB%.VarTOC2][variable TOC]]

      * Do not show a TOC if the topic it contains is included in another topic:

         * Set TOC_HIDE_IF_INCLUDED =

            * If not set: included TOC is shown

            * Possible values: =on= or nothing

#DefaultUserSettings

---++ Default User Settings

%X% *NOTE:* They are typically redefined in topics of individual %USERSWEB%.TWikiUsers

   * Preference for the editor, default is the WYSIWYG editor. The options are raw, wysiwyg:

      * Set EDITMETHOD = wysiwyg

      * #Set EDITMETHOD = raw

   * Fixed [[%SYSTEMWEB%.TopMenuSkin#FixedTopMenu][pulldown menu-bar]], on or off. If on, the menu-bar is always visible at the top, regardless of the window scroll position. If off, the menu-bar hides when scrolled, and can be shown by hovering over the gray TWiki icon.

      * Set FIXEDTOPMENU = off

   * 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 <nop>WikiName, $wikiusername for <nop>%USERSWEB%.WikiName, $topic for the topic name, and $web for the web name

      * Set LINKTOOLTIPINFO = off

      * #Set LINKTOOLTIPINFO = $username - $date - $rev: $summary

   * Horizontal size of text edit box:

      * Set EDITBOXWIDTH = 70

   * Vertical size of text edit box:

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

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

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

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

      * Set ATTACHLINKBOX = 

   * Format of file link when the __link__ check box is checked:

      * %H% *NOTE:* Keyword ==$name== gets expanded to filename; ==$comment== to comment; ==\t== to tab (3 spaces for bullets).

<!-- verbatim tag required to prevent error in Apache log; does not suppress Set -->

<verbatim>

      * Set ATTACHEDFILELINKFORMAT = \n   * [[%PUBURLPATH%/%WEB%/%TOPIC%/$name][$name]]: $comment

</verbatim>

   * Format of images when the __link__ check box is checked:

      * %H% *NOTE:* Keyword ==$name== gets expanded to filename; ==$comment== to comment; ==$width== to width of image; ==$height== to height of image; ==$size== to ==width="..." height="..."== attribute of ==img== tag; ==\t== to tab and ==\n== to linefeed. Use 3 leading spaces for bullets.

<verbatim>

      * Set ATTACHEDIMAGEFORMAT = \n   * $comment: <br />\n     <img src="%PUBURLPATH%/%WEB%/%TOPIC%/$name" alt="$name" $size />

</verbatim>

#TWikiPlatformSettings

---++ 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%/%SYSTEMWEB%/TWikiLogos/T-logo-140x40-t.gif

      * Set WIKILOGOURL = %SCRIPTURL{view}%/%USERSWEB%/%HOMETOPIC%

      * Set WIKILOGOALT = Home - this site is powered by TWiki(R)

   * Home page of this site. This is DEPRECATED, please use %<nop>WIKILOGOURL% instead.

      * Set WIKIHOMEURL = %SCRIPTURLPATH{"view"}%/%USERSWEB%/%HOMETOPIC%

   * List of <nop>%WIKITOOLNAME% webs - on the first line of the upper toolbar (to add a new web, see ManagingWebs and %SYSTEMWEB%.SiteMap):

      * Set WIKIWEBLIST = [[%USERSWEB%.%HOMETOPIC%][%USERSWEB%]] %SEP% [[%SYSTEMWEB%.%HOMETOPIC%][%SYSTEMWEB%]] %SEP% [[Sandbox.%HOMETOPIC%][Sandbox]]

      * %T% *NOTE:* To automatically list all non-hidden webs in alphabetical order, use the =%<nop>WEBLIST{}%= variable instead: <br />

        %WEBLIST{"[[$name.%HOMETOPIC%][$name]]" separator=" | "}%

   * Maximum size of %SYSTEMWEB%.FileAttachments in KB, 0 for no limit:

      * Set ATTACHFILESIZELIMIT = 10000

#BroadcastMessage

   * Broadcast message for skins supporting a %<nop>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 <nop>%WIKITOOLNAME% maintenance.

   * Users or groups allowed to [[%SYSTEMWEB%.ManagingWebs][create new top-level webs]]: (ex: %USERSWEB%.WebCreatorsGroup). If set to nothing, only administrators will be able to do this.

      * Set ALLOWROOTCHANGE = %USERSWEB%.TWikiAdminGroup

#SearchSettings

---+++ Search Settings

   * Default type for search, one of: keyword (for search engine like syntax), regex (for RegularExpression search), or literal (for verbatim search)

      * Set SEARCHDEFAULTTYPE = keyword

   * Default for =%<nop>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

#EmailSettings

---+++ E-mail Settings

   * 'Mail this topic' mailto: link - can be included in topics, templates or skins

      * Set MAILTHISTOPIC = <a href="mailto:?subject=%BASETOPIC%&amp;body=%TOPICURL%">%MAILTHISTOPICTEXT%</a>

   * 'Mail this topic' link text

      * Set MAILTHISTOPICTEXT = Send a link to this page

#HttpEquivSettings

---+++ HTTP-<nop>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 <code>&lt;link&gt;</code>-tags).

   * ==http-equiv== meta tags for ==view==, ==rdiff==, ==attach==, ==search*== scripts:

      * #Set HTTP_EQUIV_ON_VIEW = 

      * Set HTTP_EQUIV_ON_VIEW = <link rel="alternate" type="application/rss+xml" title="RSS Feed" href="%SCRIPTURLPATH{"view"}%/%WEB%/WebRss" />

   * ==http-equiv== meta tags for ==edit== script:

      * Set HTTP_EQUIV_ON_EDIT = 

   * ==http-equiv== meta tags for ==preview== script:

      * Set HTTP_EQUIV_ON_PREVIEW = 

#SkinSettings

---++ Skin Settings

   * Skin overriding the default TWiki templates: (can be overwritten by WebPreferences and user preferences) 

      * Set SKIN = tagme, topmenu, pattern

   * __Note:__ See TWikiSkinBrowser for currently installed skins

#PatternSkin

---+++ Pattern Skin

   * Default TWiki styles of PatternSkin

      * Set TWIKILAYOUTURL = %PUBURLPATH%/%SYSTEMWEB%/PatternSkin/layout.css

      * Set TWIKISTYLEURL = %PUBURLPATH%/%SYSTEMWEB%/PatternSkin/style.css

      * Set TWIKICOLORSURL = %PUBURLPATH%/%SYSTEMWEB%/PatternSkin/colors.css

   * Custom overriding styles (enabled pr. default but empty, to prevent browsers from fetching %<nop>USERLAYOUTURL%-style URLs)

      * Set USERLAYOUTURL = 

      * Set USERSTYLEURL = 

      * Set USERCOLORSURL = 

   * *PatternSkin header settings*

      * Set WEBHEADERART = %PUBURLPATH%/%SYSTEMWEB%/PatternSkin/TWiki_header.gif

      * #Set WEBHEADERBGCOLOR = #faf8f0

#SkinIcons

---+++ Skin Icons

   * Topic containing the icon graphics library. Icons can easily be rendered with =%<nop>ICON{name}%=.

      * Set ICONTOPIC = %SYSTEMWEB%.TWikiDocGraphics, %USERSWEB%.SiteDocGraphics

#LegacySupport

---+++ 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 = <a href="%EDITURL%" title="Edit Topic - deprecated usage - please see release notes">Edit</a>

#PluginsSettings

---++ 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 %<nop>DISABLEDPLUGINS% TWiki variable to be a list of plugins to disable e.g.

      * <nop>Set DISABLEDPLUGINS = SpreadSheetPlugin,EditTablePlugin

      * Currently, %<nop>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.

<!-- Legacy settings for !CommentPlugin:

   * Name of file in the 'templates' directory that contains the comment templates:

      * Set COMMENTPLUGIN_TEMPLATES = comments

   * Default template type:

      * Set COMMENTPLUGIN_DEFAULT_TYPE = above

-->

#RenderingShortcuts

---++ Rendering Shortcuts Settings

   * Line break and bullet with different levels of indentation:

      * Set BB = <br />&#8226;

      * Set BB2 = <br />&nbsp;&nbsp;&#8226;

      * Set BB3 = <br />&nbsp;&nbsp;&nbsp;&nbsp;&#8226;

      * Set BB4 = <br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&#8226;

   * Line break: Note that the setting has an intentional trailing space

      * Set BR = <br /> 

   * Bullet sign:

      * Set BULLET = •

   * Vertical caret symbol:

      * Set CARET = ^

   * URL of current topic

      * Set TOPICURL = %SCRIPTURL{"view"}%/%WEB%/%BASETOPIC%

   * Vertical bar / pipe symbol:

      * Set VBAR = |

   * __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 = <img src="%ICONURLPATH{help}%" alt="HELP" title="HELP" width="16" height="16" border="0" />

      * Set I = <img src="%ICONURLPATH{tip}%" alt="IDEA!" title="IDEA!" width="16" height="16" border="0" />

      * Set M = <img src="%ICONURLPATH{arrowright}%" alt="MOVED TO..." title="MOVED TO..." width="16" height="16" border="0" />

      * Set N = <img src="%ICONURLPATH{new}%" alt="NEW" title="NEW" width="30" height="16" border="0" />

      * Set P = <img src="%ICONURLPATH{pencil}%" alt="REFACTOR" title="REFACTOR" width="16" height="16" border="0" />

      * Set Q = <img src="%ICONURLPATH{help}%" alt="QUESTION?" title="QUESTION?" width="16" height="16" border="0" />

      * Set S = <img src="%ICONURLPATH{starred}%" alt="PICK" title="PICK" width="16" height="16" border="0" />

      * Set T = <img src="%ICONURLPATH{tip}%" alt="TIP" title="TIP" width="16" height="16" border="0" />

      * Set U = <img src="%ICONURLPATH{updated}%" alt="UPDATED" title="UPDATED" width="55" height="16" border="0" />

      * Set X = <img src="%ICONURLPATH{warning}%" alt="ALERT!" title="ALERT!" width="16" height="16" border="0" />

      * Set Y = <img src="%ICONURLPATH{choice-yes}%" alt="DONE" title="DONE" width="16" height="16" border="0" />

#ColoredText

   * Colored text: (see more StandardColors)

     | You type: | =%<nop>RED% red text %<nop>ENDCOLOR% and %<nop>GREEN% green text %<nop>ENDCOLOR%= |

     | You get: | %RED% red text %ENDCOLOR% and %GREEN% green text %ENDCOLOR% |

      * __Note:__ =%&lt;color&gt;%= text must end with =%<nop>ENDCOLOR%=. If you want to switch from one color to another one you first need to end the active color with =%<nop>ENDCOLOR%=, such as =%<nop>RED% some text %<nop>ENDCOLOR% %<nop>GREEN% more text %<nop>ENDCOLOR%=.

        <!-- Two sets of colors follow: Color test and color setting -->

      * %YELLOW% *%<nop>YELLOW% looks like this* %ENDCOLOR%

      * %ORANGE% *%<nop>ORANGE% looks like this* %ENDCOLOR%

      * %RED% *%<nop>RED% looks like this* %ENDCOLOR%

      * %PINK% *%<nop>PINK% looks like this* %ENDCOLOR%

      * %PURPLE% *%<nop>PURPLE% looks like this* %ENDCOLOR%

      * %TEAL% *%<nop>TEAL% looks like this* %ENDCOLOR%

      * %NAVY% *%<nop>NAVY% looks like this* %ENDCOLOR%

      * %BLUE% *%<nop>BLUE% looks like this* %ENDCOLOR%

      * %AQUA% *%<nop>AQUA% looks like this* %ENDCOLOR%

      * %LIME% *%<nop>LIME% looks like this* %ENDCOLOR%

      * %GREEN% *%<nop>GREEN% looks like this* %ENDCOLOR%

      * %OLIVE% *%<nop>OLIVE% looks like this* %ENDCOLOR%

      * %MAROON% *%<nop>MAROON% looks like this* %ENDCOLOR%

      * %BROWN% *%<nop>BROWN% looks like this* %ENDCOLOR%

      * %BLACK% *%<nop>BLACK% looks like this* %ENDCOLOR%

      * %GRAY% *%<nop>GRAY% looks like this* %ENDCOLOR%

      * %SILVER% *%<nop>SILVER% looks like this* %ENDCOLOR%

      * <span style='background : #808080;'>%WHITE% *%<nop>WHITE% looks like this (with gray background)* %ENDCOLOR%</span>

      * The following settings define the colors: (they are enclosed in verbatim tags to avoid incorrect nesting of XHTML tags)

<verbatim>

      * Set YELLOW = <span style="color: #ffff00">

      * Set ORANGE = <span style="color: #ff6600">

      * Set RED = <span style="color: #ff0000">

      * Set PINK = <span style="color: #ff00ff">

      * Set PURPLE = <span style="color: #800080">

      * Set TEAL = <span style="color: #008080">

      * Set NAVY = <span style="color: #000080">

      * Set BLUE = <span style="color: #0000ff">

      * Set AQUA = <span style="color: #00ffff">

      * Set LIME = <span style="color: #00ff00">

      * Set GREEN = <span style="color: #008000">

      * Set OLIVE = <span style="color: #808000">

      * Set MAROON = <span style="color: #800000">

      * Set BROWN = <span style="color: #996633">

      * Set BLACK = <span style="color: #000000">

      * Set GRAY = <span style="color: #808080">

      * Set SILVER = <span style="color: #c0c0c0">

      * Set WHITE = <span style="color: #ffffff">

      * Set ENDCOLOR = </span>

</verbatim>

#ColoredBackground

   * Colored background: (see more StandardColors)

     | You type: | =%<nop>REDBG% red background %<nop>ENDBG% | %<nop>GREENBG% green background %<nop>ENDBG%= |

     | You get: | %REDBG% red background %ENDBG% | %GREENBG% green background %ENDBG% |

      * __Note:__ These background colors are block level elements, e.g. take up a whole row of text by default. Useful to set background colors in cells of TWiki tables.

        <!-- Two sets of colors follow: Color test and color setting -->

      * %YELLOWBG% *%<nop>YELLOWBG% looks like this* %ENDBG%

      * %ORANGEBG% *%<nop>ORANGEBG% looks like this* %ENDBG%

      * %REDBG% *%<nop>REDBG% looks like this* %ENDBG%

      * %PINKBG% *%<nop>PINKBG% looks like this* %ENDBG%

      * %PURPLEBG% *%<nop>PURPLEBG% looks like this* %ENDBG%

      * %TEALBG% *%<nop>TEALBG% looks like this* %ENDBG%

      * %NAVYBG% *%<nop>NAVYBG% looks like this* %ENDBG%

      * %BLUEBG% *%<nop>BLUEBG% looks like this* %ENDBG%

      * %AQUABG% *%<nop>AQUABG% looks like this* %ENDBG%

      * %LIMEBG% *%<nop>LIMEBG% looks like this* %ENDBG%

      * %GREENBG% *%<nop>GREENBG% looks like this* %ENDBG%

      * %OLIVEBG% *%<nop>OLIVEBG% looks like this* %ENDBG%

      * %MAROONBG% *%<nop>MAROONBG% looks like this* %ENDBG%

      * %BROWNBG% *%<nop>BROWNBG% looks like this* %ENDBG%

      * <span style="color:#ffffff">%BLACKBG% *%<nop>BLACKBG% looks like this* %ENDBG%</span>

      * %GRAYBG% *%<nop>GRAYBG% looks like this* %ENDBG%

      * %SILVERBG% *%<nop>SILVERBG% looks like this* %ENDBG%

      * %WHITEBG% *%<nop>WHITEBG% looks like this* %ENDBG%

      * The following settings define the background colors: (they are enclosed in verbatim tags to avoid incorrect nesting of XHTML tags)

<verbatim>

      * Set YELLOWBG = <div style="background-color: #ffff80; padding:0 3px 0 3px">

      * Set ORANGEBG = <div style="background-color: #ffbb80; padding:0 3px 0 3px">

      * Set REDBG = <div style="background-color: #ff8080; padding:0 3px 0 3px">

      * Set PINKBG = <div style="background-color: #ff80ff; padding:0 3px 0 3px">

      * Set PURPLEBG = <div style="background-color: #dd99dd; padding:0 3px 0 3px">

      * Set TEALBG = <div style="background-color: #80c0c0; padding:0 3px 0 3px">

      * Set NAVYBG = <div style="background-color: #8080c0; padding:0 3px 0 3px">

      * Set BLUEBG = <div style="background-color: #8080ff; padding:0 3px 0 3px">

      * Set AQUABG = <div style="background-color: #80ffff; padding:0 3px 0 3px">

      * Set LIMEBG = <div style="background-color: #80ff80; padding:0 3px 0 3px">

      * Set GREENBG = <div style="background-color: #99cc99; padding:0 3px 0 3px">

      * Set OLIVEBG = <div style="background-color: #c0c080; padding:0 3px 0 3px">

      * Set MAROONBG = <div style="background-color: #c08080; padding:0 3px 0 3px">

      * Set BROWNBG = <div style="background-color: #bb9988; padding:0 3px 0 3px">

      * Set BLACKBG = <div style="background-color: #000000; padding:0 3px 0 3px">

      * Set GRAYBG = <div style="background-color: #a0a0a0; padding:0 3px 0 3px">

      * Set SILVERBG = <div style="background-color: #c0c0c0; padding:0 3px 0 3px">

      * Set WHITEBG = <div style="background-color: #ffffff; padding:0 3px 0 3px">

      * Set ENDBG = </div>

</verbatim>

#MiscellaneousSettings

---++ Miscellaneous Settings

   * Format of a NewWikiWord link:

   * Note that =$text= is the topic link text, =$summary= is the HTML-cleaned topic link text, =$topic= is the name of the new topic, and =$web= is the name of the web for the new topic. Values are taken from the link syntax =[<nop>[$web.$topic][$text]]=. For normal plain !WikiWord links =$text= and =$topic= are the same. The value of =$web= is the current web unless the link is in the format =$web.$topic=.

      * default setting:

         * Set NEWLINKFORMAT = <span class="twikiNewLink"><a href="%SCRIPTURLPATH{"edit"}%/$web/$topic?topicparent=%WEB%.%TOPIC%;nowysiwyg=%IF{ "$ EDITMETHOD='wysiwyg'" then="0" else="1"  }%" rel="nofollow" title="%MAKETEXT{"$summary (this topic does not yet exist; you can create it)"}%">$text</a></span>

      * alternative setting:

         * #Set NEWLINKFORMAT = <a class="twikiNewLink" href="%SCRIPTURLPATH{"edit"}%/$web/$topic?topicparent=%WEB%.%TOPIC%" rel="nofollow" title="%MAKETEXT{"Create this topic"}%">$text</a>

   * %SYSTEMWEB%.PreviewBackground image:

      * Set PREVIEWBGIMAGE = %PUBURLPATH%/%SYSTEMWEB%/PreviewBackground/preview2bg.gif

   * User-friendly synonyms for system webs

      * Set DOCWEB = %SYSTEMWEB%

   * Show extra help for !ApacheLogin users for %USERSWEB%.TWikiAdminUser login

      * Set ADMINLOGIN = %IF{"{LoginManager} = 'TWiki::LoginManager::ApacheLogin' AND NOT context authenticated"

        then="TWiki is configured using <nop>ApacheLogin, please [[%LOGINURL%][login]] as a normal user first. Then the Admin Login will replace this text"

        else="[[%SCRIPTURL{login}%?sudo=sudo;origurl=%SCRIPTURL{"view"}%/%BASEWEB%/%BASETOPIC%][internal admin login]] (use the username suggested and the password set in configure)."}%

#SecuritySettings

---++ Security Settings

   * Only TWiki administrators are allowed to change this topic:

      * Set ALLOWTOPICCHANGE = %USERSWEB%.TWikiAdminGroup

      * Set ALLOWTOPICRENAME = %USERSWEB%.TWikiAdminGroup

   * Disable WYSIWYG editor for this preferences topic only:

      * Local TINYMCEPLUGIN_DISABLE = on

#NewPreferences

---++ 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== <br /> Example (as a nested bullet item, indented 6 spaces):

      * S<nop>et WEBBGCOLOR = #FFFFC0

   * Preferences are used as %SYSTEMWEB%.TWikiVariables by enclosing the name in percent signs: ==%==. Example:

      * When you write variable ==%WEB<nop>BGCOLOR%==, 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 ==<nop>WEBCOPYRIGHT== before ==<nop>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 [[%SYSTEMWEB%.%TOPIC%]] topic, it is recommended that custom variables are defined in [[%USERSWEB%.%TOPIC%]].

#ProtectedSystemSettings

---++ Protected System Settings

The following settings are declared final to protect them as read only. These are system variables that should 

never be attempted set or altered in any preference topic or topic settings. 

   * Set FINALPREFERENCES = WEB, TOPIC

#RelatedTopics

---++ Related Topics

   * %WEBPREFSTOPIC% has preferences of the <nop>%WEB% web.

   * User topics in %USERSWEB% can have optional user preferences.

   * %SYSTEMWEB%.TWikiVariables has a list of common =%<nop>VARIABLES%=.

   * %SYSTEMWEB%.TWikiAccessControl explains how to restrict access by users or groups.

   * %SYSTEMWEB%.PreferencesPlugin makes editing preferences a snap.

__Note__: Can't edit?

[[%SCRIPTURLPATH{"view"}%/%WEB%/%TOPIC%?raw=on][View raw topic]]

<div class="twikiNotification"> __%X% NOTE:__ Don't edit this topic, changes will be lost on the next TWiki upgrade. Define new site-level settings, or overload above settings in [[%LOCALSITEPREFS%]] </div>