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 webs is a web based operation; renaming and deleting webs are manual operations done directly on the server_
  15
  16 ## <a name="Overview"></a> Overview
  17
  18 A [[TWikiSite]] is divided into webs; each one represents one subject, one area of collaboration. Administrators can add/rename/delete webs.
  19
  20 <a name="CreateNewWeb"></a>
  21
  22 ## <a name="Adding a New Web"></a> Adding a New Web
  23
  24 <form action="http://www.dementia.org/twiki//manage/%WEB%/%TOPIC%" method="post" name="admin"> Create a new web by filling out this form. <strong><em>Note:</em></strong> It is not recommended to create a new web for each little project. Cross-linking topics and search is easier if there are only a few larger webs. <p>
  25   </p>
  26   <table border="1" cellpadding="0" cellspacing="0">
  27     <tr>
  28       <th align="right" bgcolor="#99CCCC"><strong> Name of new web: </strong></th>
  29       <td><input name="newweb" size="16" type="text" value="" /></td>
  30       <td> Enter a short name of up to 10 characters. The name must start with one or more upper case letters, followed by optional lower case letters or numbers; it cannot be a [[TWiki/WikiWord]]</td>
  31     </tr>
  32     <tr>
  33       <th align="right" bgcolor="#99CCCC"><strong> Based on web: </strong></th>
  34       <td><select name="webtemplate"> </select></td>
  35       <td> Select a template web (starting with an underscore) or an existing web as a template for the new web. All topics are copied over from a template web; only topics that start with <strong>Web...</strong> (like "WebHome", "WebNotify") are copied from an existing web </td>
  36     </tr>
  37     <tr>
  38       <th align="right" bgcolor="#99CCCC"><strong> Web color: </strong></th>
  39       <td><input name="webbgcolor" size="16" type="text" value="#D0D0D0" /></td>
  40       <td> Enter a [[Main/StandardColors]] code for the web </td>
  41     </tr>
  42     <tr>
  43       <th align="right" bgcolor="#99CCCC"><strong> Exclude web from "search all": </strong></th>
  44       <td><input checked name="nosearchall" type="radio" value="" /> No   <input name="nosearchall" type="radio" value="on" /> Yes </td>
  45       <td> Specify if you want to exclude the web from a "search all webs" search </td>
  46     </tr>
  47     <tr>
  48       <th align="right" bgcolor="#99CCCC"><strong> Update WIKIWEBLIST: </strong></th>
  49       <td><input name="updatewikiweblist" type="radio" value="" /> No   <input checked name="updatewikiweblist" type="radio" value="on" /> Yes </td>
  50       <td> Specify if you want to list the new web in the WIKIWEBLIST displayed by some skins in the upper right hand corner </td>
  51     </tr>
  52     <tr>
  53       <th align="right" bgcolor="#99CCCC"><strong> Description:<br />   </strong></th>
  54       <td colspan="2"><input name="description" size="60" type="text" value="" /><br /> Enter a short description of the web. This is for listing the web in the [[TWiki/SiteMap]] (leave field empty if you prefer not to update the directory) </td>
  55     </tr>
  56     <tr>
  57       <th align="right" bgcolor="#99CCCC"><strong> Used to...<br />   </strong></th>
  58       <td colspan="2"><input name="usedto" size="60" type="text" value="..." /><br /> Continue the sentence describing the intended use. This is also for the [[TWiki/SiteMap]]</td>
  59     </tr>
  60     <tr>
  61       <td>   </td>
  62       <td colspan="2"><input type="submit" value="Create new web" /></td>
  63     </tr>
  64   </table><input name="newtopic" type="hidden" value="" /> <input name="action" type="hidden" value="createnewweb" /></form>
  65
  66 For detailed instructions, see [[TWiki Installation Guide: Adding a New Web|Main/TWikiInstallationGuide#CreateWeb]].
  67
  68 ## <a name="Renaming or Deleting a Web"></a> Renaming or Deleting a Web
  69
  70 Renaming or deleting a web 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.
  71
  72 **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).
  73
  74 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`.
  75   - Make changes as required, to `Newwebname.SomeTopic` or better yet, to `%MAINWEB%.SomeTopic`.
  76 2. Edit the [[TWikiPreferences]] topic: Rename or delete the web from the `WIKIWEBLIST` variable.
  77 3. Login to the %WIKITOOLNAME% server, via Telnet or FTP.
  78 4. Go to `twiki/data` and rename or remove the web directory.
  79 5. Go to `twiki/templates` and rename or remove the web directory if present.
  80 6. Go to `twiki/pub` and rename or remove the web directory if present.
  81
  82 -- [[MikeMannix]] - 14 Sep 2001 <br /> -- [[PeterThoeny]] - 07 Apr 2002 <br />