none
[openafs-wiki.git] / TWiki / ManagingWebs.mdwn
index 3de89b7..26cad6b 100644 (file)
@@ -2,35 +2,72 @@
   <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>
 </div>
 
-## <a name="Managing Webs"></a> Managing Webs
+# <a name="Managing Webs"></a> Managing Webs
 
-Adding, renaming and deleting webs is done directly on the server
+_Adding webs is a web based operation; renaming and deleting webs are manual operations done directly on the server_
 
-### <a name="Overview"></a> Overview
+## <a name="Overview"></a> Overview
 
-To work with entire TWiki webs, you need direct access to the installation files on the host server. Connecting by Telnet or FTP is the usual approach. There are no browser-based web management tools. You can prepare a web for changes through browser-based individual topics by browser (see [[ModifyTopics|TWiki/ManagingTopics]]).
+A [[TWikiSite]] is divided into webs; each one represents one subject, one area of collaboration. Administrators can add/rename/delete webs.
 
-### <a name="How to Add a New Web"></a> How to Add a New Web
+<a name="CreateNewWeb"></a>
 
-- See [[TWiki Installation Notes|Main/TWikiDocumentation#TWiki_Installation_Notes]]
+## <a name="Adding a New Web"></a> Adding a New Web
 
-### <a name="How to Rename or Delete a Web"></a> How to Rename or Delete a Web
+<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. You can organize content within a web using [[Main/TWikiForms]] and [[Main/FormattedSearch]]. Cross-linking topics and search is easier if there are only a few larger webs. <table border="1" cellpadding="0" cellspacing="0">
+    <tr>
+      <th align="right" bgcolor="#99CCCC"><strong> Name of new web: </strong></th>
+      <td><input name="newweb" size="16" type="text" value="" /></td>
+      <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>
+    </tr>
+    <tr>
+      <th align="right" bgcolor="#99CCCC"><strong> Based on web: </strong></th>
+      <td><select name="baseweb"> </select></td>
+      <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 other webs </td>
+    </tr>
+    <tr>
+      <th align="right" bgcolor="#99CCCC"><strong> Web color: </strong></th>
+      <td><input name="webbgcolor" size="16" type="text" value="#D0D0D0" /></td>
+      <td> Enter a [[Main/StandardColors]] code for the web </td>
+    </tr>
+    <tr>
+      <th align="right" bgcolor="#99CCCC"><strong> Description:<br />  <br />   </strong></th>
+      <td colspan="2"><input name="sitemapwhat" size="60" type="text" value="" /><br /> Enter a short description of the web. Write <code>Web.TopicName</code> instead of just <code>TopicName</code> if you include links. This will list the web in the [[TWiki/SiteMap]] (leave field empty if you prefer not to update the directory.) </td>
+    </tr>
+    <tr>
+      <th align="right" bgcolor="#99CCCC"><strong> Use to...<br />   </strong></th>
+      <td colspan="2"><input name="sitemapuseto" size="60" type="text" value="...collaborate on" /><br /> Continue the sentence describing the intended use. This is also for the [[TWiki/SiteMap]]</td>
+    </tr>
+    <tr>
+      <th align="right" bgcolor="#99CCCC"><strong> Exclude web from "search all": </strong></th>
+      <td><input checked name="nosearchall" type="radio" value="" /> No   <input name="nosearchall" type="radio" value="on" /> Yes </td>
+      <td> Specify if you want to exclude the web from a "search all webs" search. Note that the [[TWiki/SiteMap]] will not list the web if you select Yes. </td>
+    </tr>
+    <tr>
+      <td>   </td>
+      <td colspan="2"><input type="submit" value="Create new web" /></td>
+    </tr>
+  </table><input name="newtopic" type="hidden" value="" /> <input name="action" type="hidden" value="createweb" /></form>
 
-- **NOTE:** Think twice if you intend to rename the %WIKITOOLNAME%.Main web, since many files point to it. If you do rename it, you'll also have to change all occurrences of `Main` to the new web name - this includes, for example, the user signatures across your entire TWiki site. (On the other hand, if the variable <code>**%MAINWEB%**</code> is used throughout, you have no problem.)
+## <a name="Renaming or Deleting a Web"></a> Renaming or Deleting a Web
 
-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 <code>**twiki/data**</code> and rename or delete the web directory.
-6. **Edit the template files:** Go to <code>**twiki/templates**</code> and rename or delete the web directory if present.
-7. **Edit the public files:** Go to <code>**twiki/pub**</code> and rename or delete the web directory if present.
+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.
 
--- [[MikeMannix]] - 29 Aug 2001 <br />
+**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: 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. Login to the %WIKITOOLNAME% server, via Telnet or FTP.
+4. Go to `twiki/data` and rename or remove the web directory.
+5. Go to `twiki/templates` and rename or remove the web directory if present.
+6. Go to `twiki/pub` and rename or remove the web directory if present.
+
+-- [[MikeMannix]] - 14 Sep 2001 <br /> -- [[PeterThoeny]] - 07 Apr 2002 <br />