none
[openafs-wiki.git] / TWiki / TWikiPreferences.mdwn
index 5d70f50..b5003e8 100644 (file)
@@ -5,11 +5,11 @@ The following settings are **_site-level preferences_** , e.g. affecting all use
 **_Preferences:_**
 
 - List of %WIKITOOLNAME% webs: (the first line of a topic; to add a web see [[TWikiDocumentation]] and [[TWikiWebsTable]])
-  - Set WIKIWEBLIST = [%WIKITOOLNAME%](%WIKIHOMEURL%) . \{ [Main](http://www.dementia.org/twiki//view/Main/WebHome) | [TWiki](http://www.dementia.org/twiki//view/TWiki/WebHome) | [Know](http://www.dementia.org/twiki//view/Know/WebHome) | [Test](http://www.dementia.org/twiki//view/Test/WebHome) \}
+  - Set WIKIWEBLIST = [[Main|Main/WebHome]] | [[TWiki|TWiki/WebHome]] | [[Know|Know/WebHome]] | [[Test|Test/WebHome]]
+  - **_Note:_** To automatically list all non-hidden webs in alphabetical order you can use this variable instead: Set WIKIWEBLIST =
 
 - List of topics of a web: (the second line of a topic, is overwritten by web preferences)
-  - Set WEBTOPICLIST = %WEB% . \{ [Home](WebHome) | [Changes](WebChanges) | [Index](http://www.dementia.org/twiki//search/%WEB%/?scope=topic&regex=on&search=.*) | [Search](WebSearch) | Go <input name="topic" size="16" type="text" />
- \}
+  - Set WEBTOPICLIST = [[Home|Main/WebHome]] | [[Changes|Main/WebChanges]] | [[Index|Main/WebIndex]] | [[Search|Main/WebSearch]] | Go <input name="topic" size="16" type="text" />
 
 - Copyright notice:
   - Set WEBCOPYRIGHT = <font>Copyright © 2000 by the contributing authors. \\nAll material on this collaboration tool is the property of the contributing authors. <br /> \\nIdeas, requests, problems regarding %WIKITOOLNAME%? [Send](mailto:?subject=%WIKITOOLNAME% Feedback) feedback. </font>
@@ -44,10 +44,19 @@ The following settings are **_site-level preferences_** , e.g. affecting all use
 - 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)
+  - Set ATTACHEDFILELINKFORMAT = \\t\* [$name](http://www.dementia.org/twiki//view/$name): $comment
+  - **_Note:_** Keyword `$name` gets expanded to filename; `$comment` to comment; `\t` to tab (3 spaces for bullets).
+
+- Format of images when the **_link_** check box is checked: (can be overwritten by user preferences)
+  - Set ATTACHEDIMAGEFORMAT = \\t\* $comment: <br />![$name](http://www.dementia.org/twiki//view/$name)
+  - **_Note:_** Above image is shown as broken, it gets expanded correctly when you attach an image.
+  - **_Note:_** Keyword `$name` gets expanded to filename; `$comment` to comment; `$size` to `width="..." height="..."` attribute of `img` tag; `\t` to tab (3 spaces for bullets).
+
 - Wiki webmaster email address:
   - Set WIKIWEBMASTER = <webmaster@your.company>
 
-- Mail host for outgoing mail. This is used for [[TWikiNotificationOfChanges]] if Perl module <code>**Net::SMTP**</code> is installed. If not, sendmail is used instead (defined by <code>**$mailProgram**</code> in <code>**TWiki.cfg**</code>). Examples: `mail.your.company` or `localhost`
+- Mail host for outgoing mail. This is used for [[WebNotification]] if Perl module <code>**Net::SMTP**</code> is installed. If not, sendmail is used instead (defined by <code>**$mailProgram**</code> in <code>**TWiki.cfg**</code>). Examples: `mail.your.company` or `localhost`
   - Set SMTPMAILHOST = mail
 
 - [[TWikiPlugins]] configuration: All plugin modules that exist in the `lib/TWiki/Plugins` directory are activated automatically unless disabled by DISABLEDPLUGINS. You can optionally list the installed plugins in INSTALLEDPLUGINS. This is useful to define the sequence of plugin execution, or to specify other webs then the TWiki web for the plugin topics. Specify plugins as a comma separated list of topics.
@@ -71,6 +80,9 @@ The following settings are **_site-level preferences_** , e.g. affecting all use
 - Users or groups allowed to change this %TOPIC% topic: (I.e. [[TWikiAdminGroup]])
   - Set ALLOWTOPICCHANGE =
 
+- Users or groups allow to rename this %TOPIC% topic:
+  - #Set ALLOWTOPICRENAME = [[TWikiAdminGroup]]
+
 - Site-level preferences that are **not** allowed to be overridden by [[WebPreferences]] and user preferences:
   - Set FINALPREFERENCES = PREVIEWBGIMAGE, WIKIWEBMASTER, MAILHOST