From: PeterThoeny Date: Fri, 14 Sep 2001 09:05:09 +0000 (+0000) Subject: none X-Git-Url: https://git.openafs.org/?p=openafs-wiki.git;a=commitdiff_plain;h=fce1feaf3a03a156c1cf8a13dc1a15ba18179bac none --- diff --git a/TWiki/ManagingWebs.mdwn b/TWiki/ManagingWebs.mdwn index cebe10a..4e21901 100644 --- a/TWiki/ManagingWebs.mdwn +++ b/TWiki/ManagingWebs.mdwn @@ -2,8 +2,8 @@ @@ -11,31 +11,33 @@ # Managing Webs -_Adding, renaming and deleting webs is done directly on the server_ +_Adding, renaming and deleting webs are manual operations done directly on the server_ ## Overview -Managing TWiki webs requires direct access to the installation files on the host server. There are no browser-based web tools. +Managing TWiki webs requires direct access to the installation files on the host server. There are currently no browser-based equivalents of the Rename/move/delete topic tools for working with webs. -## How to Add a New Web +## Adding a New Web Adding new webs is quick and easy - you can have a basic web up and running in a couple of minutes: -1. **Create** a new directory under **twiki/data/**, ex: `twiki/data/newweb` +1. **Create** a new directory under `twiki/data/`, ex: `twiki/data/Newweb`
+ - the name has to start with a capital and _cannot_ be a [[WikiWord]] 2. **Copy** in the contents of `twiki/data/_default`. -For detailed instructions: [[TWiki Installation Guide: Creating a New Web|Main/TWikiDocumentation#CreateWeb]]. +For detailed instructions, see [[TWiki Installation Guide: Adding a New Web|Main/TWikiDocumentation#CreateWeb]]. -## How to Rename or Delete a Web +## Renaming or Deleting a Web -**NOTE:** Think twice if you intend to rename the %WIKITOOLNAME%.Main web, since many files point to it. If you rename it, you also have to change all occurrences of `Main` to the new web name (like the web prefixes for all user signatures, `Main.SomeName`). (On the other hand, if the `%MAINWEB%` variable is used throughout, you won't have that problem.) +**NOTE:** If you plan to rename the %WIKITOOLNAME%.Main web, remember that TWiki stores user and group topics in %MAINWEB%, default named `Main`. That means, every [[WikiName]] signature - `Main.SomeUserName` - points to it and would need updating (unless the variable, `%MAINWEB%.SomeUserName`, is used throughout). -1. Prepare your site: Other webs may link to the web you want to rename or delete. Search each web for links to the target web: search all webs for `Abouttochange.` - include the period to find topics like `Abouttochange.SomeTopic`. Make changes as required. +1. Prepare your site: Search each web for links to the target web, searching topic text for `Oldwebname.`, including the dot so you'll find references like `Oldwebname.SomeTopic`. + - Make changes as required, to `Newwebname.SomeTopic` or better yet, to `=%MAINWEB%.SomeTopic`. 2. Edit the [[TWikiPreferences]] topic: Rename or delete the web from the `WIKIWEBLIST` variable. 3. Edit the [[TWikiWebsTable]] topic: Rename or delete the web from the table. -4. Connect to the %WIKITOOLNAME% server: Login via Telnet or FTP. -5. Edit the data files: Go to `twiki/data` and rename or delete the web directory. -6. Edit the template files: Go to `twiki/templates` and rename or delete the web directory if present. -7. Edit the public files: Go to `twiki/pub` and rename or delete the web directory if present. +4. Login to the %WIKITOOLNAME% server, via Telnet or FTP. +5. Go to `twiki/data` and rename or remove the web directory. +6. Go to `twiki/templates` and rename or remove the web directory if present. +7. Go to `twiki/pub` and rename or remove the web directory if present. --- [[MikeMannix]] - 29 Aug 2001
+-- [[MikeMannix]] - 14 Sep 2001
diff --git a/TWiki/TWikiAccessControl.mdwn b/TWiki/TWikiAccessControl.mdwn index f569769..7c43487 100644 --- a/TWiki/TWikiAccessControl.mdwn +++ b/TWiki/TWikiAccessControl.mdwn @@ -37,7 +37,7 @@ _Restricting read and write access to topics and webs, by users and groups_ ## Overview -[[TWikiAccessControl]] allows you restrict access to single topics and entire webs, by individual user and by user groups, in three main areas: view; edit & attach; and rename/move/delete. These controls, combined with [[TWikiUserAuthentication|Main/TWikiDocumentation#TWiki_User_Authentication]], let you easily create and manage an extremely flexible, fine-grained privilege system. +[[TWikiAccessControl]] allows you restrict access to single topics and entire webs, by individual user and by user groups, in three main areas: view; edit & attach; and rename/move/delete. These controls, combined with [[TWikiUserAuthentication]], let you easily create and manage an extremely flexible, fine-grained privilege system. ## An Important Control Consideration @@ -48,7 +48,7 @@ Open, freeform editing is the essence of the [[WikiCulture]] - it's what makes T - Peer editing - the ability to rearrange anything on a page - keeps topics focussed. - All content is preserved under revision control. - - Edits can be undone by the [[TWikiAdminGroup]] (the default administrators group; see [[Managing Groups|Main/WebHome#ManagingGroups]]). + - Edits can be undone by the [[TWikiAdminGroup]] (the default administrators group; see #ManagingGroups). - Users are encouraged to edit and refactor (condense a long topic), since there's a safety net. As a collaboration guideline: @@ -62,9 +62,9 @@ Access control is based on users and groups. Users are defined by their [[WikiNa ### Managing Users -A user is created by with the [TWikiRegistration](%SCRIPTULRPATH%/view/TWiki/TWikiRegistration) form. The process generates a topic in the Main web in the new user's [[WikiName]]. The default visitor name is [[TWikiGuest]]. +A user is created by with the [[TWikiRegistration]] form. The process generates a topic in the Main web in the new user's [[WikiName]]. The default visitor name is [[TWikiGuest]]. -- Users can be authenticated using Basic Authentication or SSL. [[Authentication|Main/TWikiDocumentation#TWikiAuthentication]] is required in order to track user identities. +- Users can be authenticated using Basic Authentication or SSL. [[TWikiUserAuthentication]] is required in order to track user identities. @@ -154,13 +154,13 @@ You can define restrictions of who is allowed to view a %WIKITOOLNAME% web. ### Known Issues - 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 Guide|Main/TWikiDocumentation#TWikiInstallationGuide]] has more on Basic Authentication based on the **.htaccess** file. +- Read access restriction only works if the view script is authenticated, that means that users need to log on also just to read topics. [[TWikiInstallationGuide]] has more on Basic Authentication based on the **.htaccess** file. #### Selective Unrestricted Web Access - There is a workaround if you prefer to have unrestricted access to view topics located in normal webs, and to authenticate users only for webs where view restriction is enabled: 1. **Omit** the **view** script from the `.htaccess` file. - 2. **Enable** the **$doRememberRemoteUser** flag in **lib/wikicfg.pm** as described in [[User Authentication|Main/TWikiDocumentation#TWikiUserAuthentication]]. %WIKITOOLNAME% will now remember the IP address of an authenticated user. + 2. **Enable** the **$doRememberRemoteUser** flag in **lib/TWiki.cfg** as described in [[TWikiUserAuthentication]]. %WIKITOOLNAME% will now remember the IP address of an authenticated user. 3. **Copy** the **view** script to **viewauth** (or better, create a symbolic link) 4. **Add** **viewauth** to the list of authenticated scripts in the .htaccess file. - When a user accesses a web where you enabled view restriction, %WIKITOOLNAME% will redirect from the `view` script to the `viewauth` script once (this happens only if the user has never edited a topic). Doing so will ask for authentication. The `viewauth` script shows the requested topic if the user could log on and if the user is authorized to see that web. diff --git a/TWiki/TWikiMetaData.mdwn b/TWiki/TWikiMetaData.mdwn index e695080..f51ef85 100644 --- a/TWiki/TWikiMetaData.mdwn +++ b/TWiki/TWikiMetaData.mdwn @@ -2,16 +2,14 @@