none
[openafs-wiki.git] / TWiki / ManagingWebs.mdwn
index cebe10a..4e21901 100644 (file)
@@ -2,8 +2,8 @@
   <ul>
     <li><a href="#Managing Webs"> Managing Webs</a><ul>
         <li><a href="#Overview"> Overview</a></li>
-        <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>
+        <li><a href="#Adding a New Web"> Adding a New Web</a></li>
+        <li><a href="#Renaming or Deleting a Web"> Renaming or Deleting a Web</a></li>
       </ul>
     </li>
   </ul>
 
 # <a name="Managing Webs"></a> 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_
 
 ## <a name="Overview"></a> 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.
 
-## <a name="How to Add a New Web"></a> How to Add a New Web
+## <a name="Adding a New Web"></a> 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 <code>**twiki/data/**</code>, ex: `twiki/data/newweb`
+1. **Create** a new directory under `twiki/data/`, ex: `twiki/data/Newweb`<br />
+  - 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]].
 
-## <a name="How to Rename or Delete a Web"></a> How to Rename or Delete a Web
+## <a name="Renaming or Deleting a Web"></a> 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 <code>%MAINWEB%</code>, 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 <br />
+-- [[MikeMannix]] - 14 Sep 2001 <br />