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="#Adding a New Web"> Adding a New Web</a></li>
   6         <li><a href="#Renaming or Deleting a Web"> Renaming or Deleting 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 are manual operations 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 currently no browser-based equivalents of the Rename/move/delete topic tools for working with webs.
  19
  20 ## <a name="Adding a New Web"></a> Adding 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 `twiki/data/`, ex: `twiki/data/Newweb`<br />
  25   - the name has to start with a capital and _cannot_ be a [[WikiWord]]
  26 2. **Copy** in the contents of `twiki/data/_default`.
  27
  28 For detailed instructions, see [[TWiki Installation Guide: Adding a New Web|Main/TWikiInstallationGuide#CreateWeb]].
  29
  30 ## <a name="Renaming or Deleting a Web"></a> Renaming or Deleting a Web
  31
  32 **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).
  33
  34 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`.
  35   - Make changes as required, to `Newwebname.SomeTopic` or better yet, to `%MAINWEB%.SomeTopic`.
  36 2. Edit the [[TWikiPreferences]] topic: Rename or delete the web from the `WIKIWEBLIST` variable.
  37 3. Edit the [[TWikiWebsTable]] topic: Rename or delete the web from the table.
  38 4. Login to the %WIKITOOLNAME% server, via Telnet or FTP.
  39 5. Go to `twiki/data` and rename or remove the web directory.
  40 6. Go to `twiki/templates` and rename or remove the web directory if present.
  41 7. Go to `twiki/pub` and rename or remove the web directory if present.
  42
  43 -- [[MikeMannix]] - 14 Sep 2001 <br />