none
[openafs-wiki.git] / TWiki / ManagingWebs.mdwn
index 336d216..be00c66 100644 (file)
@@ -1,29 +1,36 @@
-The current implementation of TWiki is designed to never forget, that means all topic changes are under revision control and you can't delete or rename topics.
+<div>
+  <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>
+      </ul>
+    </li>
+  </ul>
+</div>
 
-Nevertheless there are cases where you wish to delete topics. TWiki requires administrative stuff like that to be done on the shell level, so please ask your TWiki administrator to do that for you. A future version will allow administrators to do that on the browser level.
+# <a name="Managing Webs"></a> Managing Webs
 
-**How to Rename or Delete a Topic**
+_Adding, renaming and deleting webs is done directly on the server_
 
-- Go to the topic you want to rename / delete.
-- Find out the back-links to this page from _Ref-By_ . Modify other topics if needed. **_Note:_** _Ref-By_ only finds topics in the current web. Search also in other webs if needed.
-- Telnet to the TWiki installation.
-- cd to `twiki/data` and then to the web where the topic is located. Rename / delete the topic ( `name.txt` ) and repository file ( `name.txt,v` ). **_Hint:_** Instead of deleting a topic you could create a `Trash` web and move topics/repositories to this web. (A future version of TWiki might have a Trash web.)
-- Edit the `.changes` file and rename / delete all occurrences of the topic. **_Note:_** There might be several lines of the topic.
-- cd to `twiki/pub` and then to the web where the topic is located. Rename / delete the topic attachment directory if present.
+## <a name="Overview"></a> Overview
 
-**How to add a New Web**
+Managing TWiki webs requires direct access to the installation files on the host server. There are no browser-based web tools.
 
-- See [[TWikiImplementationNotes]].
+## <a name="How to Add a New Web"></a> How to Add a New Web
 
-**How to Rename or Delete a Web**
+- See [[TWikiInstallationGuide|Main/TWikiDocumentation#TWikiInstallationGuide]]
 
-- It is advisable not to rename the TWiki.Main web.
-- Be aware that other webs might link to the web you want to rename / delete. Search each web for links to this web, i.e. in each web search for `Obsolete.` (including the period, this is to find topics like `Obsolete.SomeTopic` ). Take measures if necessary.
-- Edit the [[TWikiPreferences]] topic and rename / delete the web from the `WIKIWEBLIST` variable.
-- Edit the [[TWikiWebsTable]] topic and rename / delete the web from the table.
-- Telnet to the TWiki installation.
-- cd to `twiki/data` and rename / delete the web directory.
-- cd to `twiki/templates` and rename / delete the web directory.
-- cd to `twiki/pub` and rename / delete the web directory if present.
+## <a name="How to Rename or Delete a Web"></a> How to Rename or Delete a Web
 
--- [[PeterThoeny]] - 01 May 2000 <br />
+**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.)
+
+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.
+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.
+
+-- [[MikeMannix]] - 29 Aug 2001 <br />