TWiki/ManagingWebs.mdwn

   1 <div>
   2   <ul>
   3     <li><a href="#Managing Webs"> Managing Webs</a><ul>
   4         <li><a href="#Overview"> Overview</a></li>
   5         <li><a href="#How to Add a New Web"> How to Add a New Web</a></li>
   6         <li><a href="#How to Rename or Delete a Web"> How to Rename or Delete a Web</a></li>
   7       </ul>
   8     </li>
   9   </ul>
  10 </div>
  11
  12 # <a name="Managing Webs"></a> Managing Webs
  13
  14 _Adding, renaming and deleting webs is done directly on the server_
  15
  16 ## <a name="Overview"></a> Overview
  17
  18 Managing TWiki webs requires direct access to the installation files on the host server. There are no browser-based web tools.
  19
  20 ## <a name="How to Add a New Web"></a> How to Add a New Web
  21
  22 Adding new webs is quick and easy - you can have a basic web up and running in a couple of minutes:
  23
  24 1. **Create** a new directory under <code>**twiki/data/**</code>, ex: `twiki/data/newweb`
  25 2. **Copy** in the contents of `twiki/data/_default`.
  26
  27 For detailed instructions: [[TWiki Installation Guide: Creating a New Web|Main/TWikiDocumentation#CreateWeb]].
  28
  29 ## <a name="How to Rename or Delete a Web"></a> How to Rename or Delete a Web
  30
  31 **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.)
  32
  33 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.
  34 2. Edit the [[TWikiPreferences]] topic: Rename or delete the web from the `WIKIWEBLIST` variable.
  35 3. Edit the [[TWikiWebsTable]] topic: Rename or delete the web from the table.
  36 4. Connect to the %WIKITOOLNAME% server: Login via Telnet or FTP.
  37 5. Edit the data files: Go to `twiki/data` and rename or delete the web directory.
  38 6. Edit the template files: Go to `twiki/templates` and rename or delete the web directory if present.
  39 7. Edit the public files: Go to `twiki/pub` and rename or delete the web directory if present.
  40
  41 -- [[MikeMannix]] - 29 Aug 2001 <br />