<div>
<ul>
- <li><a href="#Add, Name, or Delete Webs"> Add, Name, or Delete Webs</a><ul>
+ <li><a href="#Modifying Webs"> Modifying Webs</a><ul>
<li><a href="#How to Add a New Web"> How to Add a New Web</a></li>
<li><a href="#How to Rename or Delete a Web"> How to Rename or Delete a Web</a></li>
</ul>
</ul>
</div>
-## <a name="Add, Name, or Delete Webs"></a> Add, Name, or Delete Webs
+## <a name="Modifying Webs"></a> Modifying Webs
To work with entire TWiki webs, you need direct access to the installation files on the host server. Connecting by Telnet or FTP is the usual approach. Before making changes to a web, you can move individual topics through your browser (see [[ModifyTopics|TWiki/RenameTopic]]). No similar web controls are available through the browser interface.
+<div>
+ <ul>
+ <li><a href="#TWiki Access Control"> TWiki Access Control</a><ul>
+ <li><a href="#Users and Groups"> Users and Groups</a></li>
+ <li><a href="#Write Access Restriction by Topi"> Write Access Restriction by Topic</a></li>
+ <li><a href="#Write Access Restriction by Web"> Write Access Restriction by Web</a></li>
+ <li><a href="#Rename Access Restriction by Top"> Rename Access Restriction by Topic</a></li>
+ <li><a href="#Rename Access Restriction by Web"> Rename Access Restriction by Web</a></li>
+ <li><a href="#Read Access Restriction by Web"> Read Access Restriction by Web</a><ul>
+ <li><a href="#Read Access Restriction Notes"> Read Access Restriction Notes</a></li>
+ </ul>
+ </li>
+ <li><a href="#The _SuperAdminGroup"> The SuperAdminGroup</a></li>
+ </ul>
+ </li>
+ </ul>
+</div>
+
## <a name="TWiki Access Control"></a> TWiki Access Control
%WIKITOOLNAME% allows you to define restrictions of who is allowed to view a %WIKITOOLNAME% web, make changes to topics or attach files.
- GROUP defines the members of the group; it is a comma delimited list of users and other groups. Example: <br />` * Set GROUP = Main.SomeUser, Main.OtherUser, Main.SomeOtherGroup`
- ALLOWTOPICCHANGE defines who is allowed to change the group topic; it is a comma delimited list of users and groups. You typically want to restrict that to the members of the group itself, so it should contain the name of the topic, i.e. <br />` * Set ALLOWTOPICCHANGE = Main.TWikiAdminGroup`<br /> for the TWikiAdminGroup topic. (This is to prevent users not in the group from editing the topic and gaining unauthorized membership to the group.)
-### <a name="Write Access Restriction for Ind"></a> Write Access Restriction for Individual Topics
+### <a name="Write Access Restriction by Topi"></a> Write Access Restriction by Topic
You can define restrictions of who is allowed to make changes to a topic or attach files to it.
DENYTOPICCHANGE is evaluated before ALLOWTOPICCHANGE. Access is denied if the authenticated person is in the DENYTOPICCHANGE list, or not in the ALLOWTOPICCHANGE list. Access is granted in case DENYTOPICCHANGE and ALLOWTOPICCHANGE is not defined.
-### <a name="Write Access Restriction for a W"></a> Write Access Restriction for a Whole %WIKITOOLNAME% Web
+### <a name="Write Access Restriction by Web"></a> Write Access Restriction by Web
You can define restrictions of who is allowed to make changes to a %WIKITOOLNAME% web. This includes creating new topics, changing topics or attaching files.
- DENYTOPICCHANGE (in topic) overrides DENYWEBCHANGE (in WebPreferences)
- ALLOWTOPICCHANGE (in topic) overrides ALLOWWEBCHANGE (in WebPreferences)
-### <a name="Rename Access Restriction for In"></a> Rename Access Restriction for Individual Topics
+### <a name="Rename Access Restriction by Top"></a> Rename Access Restriction by Topic
You can define restrictions of who is allowed to rename a topic. Note that users need this permission in addition to the CHANGE permission in order to rename a topic. They also need CHANGE access to change references in referring topics.
DENYTOPICRENAME is evaluated before ALLOWTOPICRENAME. Access is denied if the authenticated person is in the DENYTOPICRENAME list, or not in the ALLOWTOPICRENAME list. Access is granted in case DENYTOPICRENAME and ALLOWTOPICRENAME is not defined.
-### <a name="Rename Access Restriction for a"></a><a name="Rename Access Restriction for a "></a> Rename Access Restriction for a Whole %WIKITOOLNAME% Web
+### <a name="Rename Access Restriction by Web"></a> Rename Access Restriction by Web
You can define restrictions of who is allowed to do renames for a %WIKITOOLNAME% web.
- DENYTOPICRENAME (in topic) overrides DENYWEBRENAME (in WebPreferences)
- ALLOWTOPICRENAME (in topic) overrides ALLOWWEBRENAME (in WebPreferences)
-### <a name="Read Access Restriction for a Wh"></a> Read Access Restriction for a Whole %WIKITOOLNAME% Web
+### <a name="Read Access Restriction by Web"></a> Read Access Restriction by Web
You can define restrictions of who is allowed to view a %WIKITOOLNAME% web.
- Set DENYWEBVIEW = < list of users and groups >
- Set ALLOWWEBVIEW = < list of users and groups >
-_Notes for read access restriction:_
+#### <a name="Read Access Restriction Notes"></a> Read Access Restriction Notes
- The view restriction is not suitable for very sensitive content since there is a way to circumvent the read access restriction.
- Read access restriction only works if the view script is authenticated, that means that users need to log on also just to read topics. [TWiki Installation](TWikiDocumentation#installation) has more on basic authentication based on the `.htaccess` file.
- It is not recommended to restrict view access to individual topics since all content is searchable **_within_** a web.
- The view restriction is not suitable for very sensitive content since there is a way to circumvent the read access restriction.
--- [[PeterThoeny]] - 16 Mar 2001 <br />
-
-**_NOTE:_**
+### <a name="The _SuperAdminGroup"></a> The [[SuperAdminGroup]]
The above schema can lock completely a topic in case of a typing error of the ALLOWTOPICCHANGE setting (see [UnchangeableTopicBug](http://www.twiki.org/cgi-bin/view/Codev/UnchangeableTopicBug)). To avoid this:
- the default setting is not to have superusers
--- [[AndreaSterbini]] - 11 Apr 2001 <br />
+-- [[PeterThoeny]] - 16 Mar 2001 <br /> -- [[AndreaSterbini]] - 11 Apr 2001 <br />
**_Related topics:_** [[TWikiPreferences]], [[WebPreferences]] (in every web), [[TWikiAdminGroup]], [[TWikiGroups]]
## <a name="TWiki Skins"></a> TWiki Skins
-Skins are customized [[TWikiTemplate|Main/TWikiTemplates]] files. You can use skins to change the look of a %WIKITOOLNAME% topic, for example the layout of the header and footer. Note that the renderd text between header and footer does **_not_** change. You can use skins also to define an alternate view, i.e. a view optimized for printing.
+Skins are customized [[TWikiTemplate|Main/TWikiTemplates]] files. You can use skins to change the look of a %WIKITOOLNAME% topic, for example the layout of the header and footer. Note that the renderd text between header and footer does **_not_** change. You can also use skins to define an alternate view, ex: a view optimized for printing.
-A skin file is located in the <code>**twiki/template**</code> directory and has a name like <code>**<scriptname>.<skin>.tmpl**</code>. For example, the <code>**print**</code> skin for the <code>**view**</code> template is <code>**view<font>.print</font>.tmpl**</code> (red color added for clarification).
+Skin files are located in the <code>**twiki/template**</code> directory and are name with this syntax: <code>**<scriptname>.<skin>.tmpl**</code>. For example, the <code>**print**</code> skin for the <code>**view**</code> template is <code>**view<font>.print</font>.tmpl**</code> (red color added for clarification).
A skin can be activated in two ways:
-- Define the SKIN preference variable in [[TWikiPreferences]], one of the [[WebPreferences]], or a user preference. I.e.
- - `Set SKIN = wikiwiki`
-- Add `?skin=name` to the URL, i.e. for this topic:
+- Define the SKIN preference variable in [[TWikiPreferences]], one of the [[WebPreferences]], or a user preference. Ex:
+ - `Set SKIN = print`
+- Add `?skin=name` to the URL, for this example:
- <http://www.dementia.org/twiki//view/%WEB%/%TOPIC%?skin=print> (for the print view skin)
- <http://www.dementia.org/twiki//view/%WEB%/%TOPIC%?skin=plain> (for the plain view skin that has no header and footer)
-- Separate each paragraph with a blank line.
+## <a name="TWiki Language by the Line"></a> TWiki Language by the Line
+
+- Separate each **paragraph** with a blank line.
- To display a word or phrase in **bold type**, surround it by asterisks: `*bold type*`
- To display a word or phrase in **_bold italic_**, surround it by double underscores: `__bold italic__`
-- To link to another Wiki topic, type the [[WikiWord]] for that topic. To link to a Wiki topic in another web, type the name of the web, a dot, and the WikiWord for that topic: `Test.WebHome`.
+- **To link** to another Wiki topic, type the [[WikiWord]] for that topic. To link to a Wiki topic in another web, type the name of the web, a dot, and the WikiWord for that topic: <code>**Test.WebHome**</code>.
+
+- If you add a [[WikiWord]] for a topic that doesn't exist, you'll see a question mark after it, prompting you (or someone else) to edit the new topic: [[FreshTopic]]. Once edited, enter the new WikiName and it will appear as a link to the that page.
+
+- When entering WikiName links, include the home web name as a prefix, ex: all TWiki member pages are in the Main web, so enter <code>**Main.YourName**</code>.
+
+- For an external link, just type the URL, starting with <code>**http://**</code>.
-- If you add a [[WikiWord]] for a topic that does not yet exist, you'll see a question mark after it, prompting you (or someone else) to edit the new topic: [[FreshTopic]]. After that's done, the WikiWord will be automatically recognized as a link to the new page.
+- To prevent a WikiName from becoming a link, type `<nop>` first, <code>**<nop>NoLinkPlease**</code>.
-- For an external hyperlink, just type the URL, starting with `http://`.
+- To indent with a **bullet**, enter space-space-space-asterisk-space.
+ - Use a multiple of 3 spaces to start **nested bullets**.
-- Start a bullet point with space-space-space-asterisk-space.
- - Use a multiple of 3 spaces to start nested bullets.
+1. Start items in a **numbered list** with space-space-space-1-space.
+2. The "1" (or **any number**) will be replaced by the correct number in order.
-1. Start items in a numbered list with space-space-space-1-space.
-2. The "1" will be replaced by the correct number
+- Always start **counting** for bullets and such from the beginning of a new line.
-- To include an image inline, just type its URL. You also can attach an image to the page and display it with text `%ATTACHURL%/imagefile.jpg` .
+- To include an **image**, type its URL. You also can Attach an image to the page and display it with text `%ATTACHURL%/yourimagefilename.jpg` .
- To display a word or phrase in `MONOSPACED TYPE`, surround it by '=' characters. Use two for bold: <code>**bold mono**</code> .
- Surround code excerpts and other
- formatted text with
- <verbatim> and </verbatim> tags.
+ Surround code excerpts, filenames, and other
+ unformatted text with <pre> or </pre>
+ <verbatim> and </verbatim> tags.
-- Use three consecutive hyphens for a horizontal rule: `---`
+- Use three or more consecutive **hyphens** for a horizontal rule: `---`
- To see the markup for any page, click on **Raw text** on the lower toolbar.
-- See [[TextFormattingRules]] for more detail.
+- See [[TextFormattingRules]] for more....
git://git.openafs.org / openafs-wiki.git / commitdiff