make the links on the front page more readable
[openafs-wiki.git] / WebPreferences.mdwn
1 ## <a name="%WIKITOOLNAME%.%WEB% Web Prefere"></a> %WIKITOOLNAME%.%WEB% Web Preferences
2
3 The following settings are **_web preferences_** of the %WIKITOOLNAME%.%WEB% web. These preferences overwrite the **_site-level preferences_** in [[TWikiPreferences]], and can be overwritten by **_user preferences_** (your personal topic, i.e. [[TWikiGuest]] in the %WIKITOOLNAME%.Main web)
4
5 **_Preferences:_**
6
7 - List of topics of the %WIKITOOLNAME%.%WEB% web:
8   - Set WEBTOPICLIST = [[Home|Main/WebHome]] | [[Changes|Main/WebChanges]] | [[Index|Main/WebIndex]] | [[Search|Main/WebSearch]] | Go <input name="topic" size="16" type="text" />
9
10 - Web specific background color: (Pick a lighter one of the [[StandardColors]])
11   - Set WEBBGCOLOR = #99CCFF
12
13 - List this web in the [[SiteMap]]:
14   - set SITEMAPLIST = on
15   - set SITEMAPWHAT = [[Getting Started|GettingStarted]], [[Protocol Info|ProtocolInfo]], [[History|AncientHistory]]
16   - set SITEMAPUSETO = Learn about the AFS distributed filesystem.
17
18 - Exclude web from a `web="all"` search: (Set to `on` for hidden webs)
19   - Set NOSEARCHALL =
20
21 - Default template for new topics and form(s) for this web:
22   - [[WebTopicEditTemplate]]: Default template for new topics in this web. (Site-level is used if topic does not exist)
23   - [[TWiki.WebTopicEditTemplate|TWiki/WebTopicEditTemplate]]: Site-level default template
24   - [[TWikiForms]]: How to enable form(s)
25   - Set WEBFORMS =
26
27 - Users or groups who **_are not_** / **_are_** allowed to **_view_** / **_change_** / **_rename_** topics in the %WEB% web: (See [[TWikiAccessControl]])
28   - Set DENYWEBVIEW =
29   - Set ALLOWWEBVIEW =
30   - Set DENYWEBCHANGE = [[TWikiGuest]]
31   - Set ALLOWWEBCHANGE = [[AFSLoreGroup]]
32   - Set DENYWEBRENAME = [[TWikiGuest]]
33   - Set ALLOWWEBRENAME = [[AFSLoreGroup]]
34
35 - Users or groups allowed to change or rename this %TOPIC% topic: (I.e. [[TWikiAdminGroup]])
36   - Set ALLOWTOPICCHANGE = [[TWikiAdminGroup]]
37   - Set ALLOWTOPICRENAME = [[TWikiAdminGroup]]
38
39 - Web preferences that are **not** allowed to be overridden by user preferences:
40   - Set FINALPREFERENCES = WEBTOPICLIST, DENYWEBVIEW, ALLOWWEBVIEW, DENYWEBCHANGE, ALLOWWEBCHANGE, DENYWEBRENAME, ALLOWWEBRENAME
41
42 **_Notes:_**
43
44 - A preference is defined as: <br />`6 spaces * Set NAME = value`<br /> Example:
45   - Set WEBBGCOLOR = #FFFFC0
46 - Preferences are used as [[TWikiVariables]] by enclosing the name in percent signs. Example:
47   - When you write variable `%WEBBGCOLOR%` , it gets expanded to `%WEBBGCOLOR%` .
48 - The sequential order of the preference settings is significant. Define preferences that use other preferences first, i.e. set `WEBCOPYRIGHT` before `WIKIWEBMASTER` since `%WEBCOPYRIGHT%` uses the `%WIKIWEBMASTER%` variable.
49 - You can introduce new preferences variables and use them in your topics and templates. There is no need to change the %WIKITOOLNAME% engine (Perl scripts).
50
51 **_Related Topics:_**
52
53 - [[TWikiPreferences]] has site-level preferences.
54 - [[TWikiUsers]] has a list of user topics. User topics can have optional user preferences.
55 - [[TWikiVariables]] has a list of common `%VARIABLES%`.
56 - [[TWikiAccessControl]] explains how to restrict access by users or groups.