head	1.38;
access;
symbols;
locks; strict;
comment	@# @;


1.38
date	2012.02.10.00.20.26;	author TWikiContributor;	state Exp;
branches;
next	1.37;

1.37
date	2011.09.24.05.33.10;	author TWikiContributor;	state Exp;
branches;
next	1.36;

1.36
date	2011.05.06.08.34.31;	author TWikiContributor;	state Exp;
branches;
next	1.35;

1.35
date	2010.05.29.14.44.40;	author TWikiContributor;	state Exp;
branches;
next	1.34;

1.34
date	2009.09.02.13.43.13;	author TWikiContributor;	state Exp;
branches;
next	1.33;

1.33
date	2008.12.06.09.02.24;	author TWikiContributor;	state Exp;
branches;
next	1.32;

1.32
date	2008.08.03.22.17.47;	author TWikiContributor;	state Exp;
branches;
next	1.31;

1.31
date	2008.01.22.03.21.30;	author TWikiContributor;	state Exp;
branches;
next	1.30;

1.30
date	2007.01.16.04.12.00;	author TWikiContributor;	state Exp;
branches;
next	1.29;

1.29
date	2006.06.25.16.26.25;	author TWikiContributor;	state Exp;
branches;
next	1.28;

1.28
date	2006.04.01.05.55.08;	author TWikiContributor;	state Exp;
branches;
next	1.27;

1.27
date	2006.02.01.12.01.17;	author TWikiContributor;	state Exp;
branches;
next	1.26;

1.26
date	2004.08.21.22.16.56;	author PeterThoeny;	state Exp;
branches;
next	1.25;

1.25
date	2004.08.20.05.53.32;	author PeterThoeny;	state Exp;
branches;
next	1.24;

1.24
date	2004.08.15.08.25.03;	author PeterThoeny;	state Exp;
branches;
next	1.23;

1.23
date	2003.01.19.08.22.00;	author PeterThoeny;	state Exp;
branches;
next	1.22;

1.22
date	2003.01.08.07.25.10;	author PeterThoeny;	state Exp;
branches;
next	1.21;

1.21
date	2003.01.05.04.42.26;	author PeterThoeny;	state Exp;
branches;
next	1.20;

1.20
date	2003.01.05.02.50.52;	author PeterThoeny;	state Exp;
branches;
next	1.19;

1.19
date	2002.04.14.09.08.00;	author PeterThoeny;	state Exp;
branches;
next	1.18;

1.18
date	2002.04.07.09.46.00;	author PeterThoeny;	state Exp;
branches;
next	1.17;

1.17
date	2001.09.14.10.09.53;	author PeterThoeny;	state Exp;
branches;
next	1.16;

1.16
date	2001.09.14.08.53.43;	author MikeMannix;	state Exp;
branches;
next	1.15;

1.15
date	2001.09.12.07.02.46;	author MikeMannix;	state Exp;
branches;
next	1.14;

1.14
date	2001.09.09.23.36.25;	author MikeMannix;	state Exp;
branches;
next	1.13;

1.13
date	2001.09.07.10.14.55;	author MikeMannix;	state Exp;
branches;
next	1.12;

1.12
date	2001.09.05.11.24.53;	author MikeMannix;	state Exp;
branches;
next	1.11;

1.11
date	2001.09.03.07.10.50;	author MikeMannix;	state Exp;
branches;
next	1.10;

1.10
date	2001.09.01.07.33.03;	author MikeMannix;	state Exp;
branches;
next	1.9;

1.9
date	2001.09.01.04.47.30;	author MikeMannix;	state Exp;
branches;
next	1.8;

1.8
date	2001.08.30.22.02.33;	author MikeMannix;	state Exp;
branches;
next	1.7;

1.7
date	2001.08.30.02.13.09;	author MikeMannix;	state Exp;
branches;
next	1.6;

1.6
date	2001.08.07.16.03.45;	author JohnTalintyre;	state Exp;
branches;
next	1.5;

1.5
date	2001.03.04.09.04.18;	author PeterThoeny;	state Exp;
branches;
next	1.4;

1.4
date	2000.12.14.03.00.53;	author PeterThoeny;	state Exp;
branches;
next	1.3;

1.3
date	2000.11.30.08.27.22;	author PeterThoeny;	state Exp;
branches;
next	1.2;

1.2
date	2000.11.12.08.16.30;	author PeterThoeny;	state Exp;
branches;
next	1.1;

1.1
date	2000.05.01.07.30.37;	author PeterThoeny;	state Exp;
branches;
next	;


desc
@none
@


1.38
log
@buildrelease
@
text
@%META:TOPICINFO{author="TWikiContributor" date="1328833226" format="1.1" version="38"}%
%STARTINCLUDE%
---+ Managing Webs

_Adding, renaming and deleting webs are all web-based operations._

%TOC%

---++ Overview

A TWikiSite is divided into webs; each one represents one workspace, one area of collaboration. Each web is a container for topics. Each topic is a container for page content and attachments. Administrators can add/rename/delete webs.

#NamespaceAndURL
---++ Namespace and URL

The name of the web and topic is represented in the page URL. For example, =http://twiki.example.com/do/view/Sandbox/WebNotify= tells us that we __view__ topic __WebNotify__ located in the __Sandbox__ web.

%T% __Tip:__ The URL of a web's homepage ends in =/%HOMETOPIC%= by default. The name of the homepage topic can safely be omitted to make for shorter and more legible links. For example, =http://twiki.example.com/do/view/Sandbox= links to the homepage of the Sandbox web.

#WebTemplate
---++ Choose Web Template

New webs are based on a web you specify. There are two types of webs you can use to create a new web:
   * Use a specially designed TemplateWeb. This is an invisible web that begins with an underscore &quot;_&quot; character (for example =_default=).
   * Use an existing web as a template web. This may be useful if you already have a web that you would like to use as a starting point.

In either case all topics in the template web will be copied into the new web. Make sure to verify that your new web has all the custom modifications that you desire. Any settings defined in the form below will automatically be set in the !WebPreferences of the new web.

#CreateNewWeb
---++ Adding a New Web

<form name="admin" action="%SCRIPTURLPATH{manage}%/%WEB%/%TOPIC%" method="post">
Create a new web by filling out this form.%BR%
__%X% Note:__ *Keep the number of webs to a minimum!* Don't create a new web for each little project. Cross-linking topics is easier, and searches are faster, if there are only a few larger webs. You can organize content within a web using categories, TWikiForms and FormattedSearch.
|  *Name of new web:* | <input name="newweb" class="twikiInputField" type="text" value="%URLPARAM{"newweb" encode="entity"}%" size="16" /> | The name must start with an upper case letter, followed by upper or lower case letters or numbers. Specify a short name to avoid long URLs. |
|  *Based on web:* | <select name="baseweb" class="twikiSelect"> %WEBLIST{ "<option $marker>$name</option>" webs="webtemplate,public" selection="_default" separator=" "}% </select> | Select a TemplateWeb. |
|  *Web color:* | %COLORPICKER{ name="WEBBGCOLOR" size="16" value="#d0d0d0" class="twikiInputField" }% | Select color for the new web, shown in the list of webs.<br /><br /> __Note:__ Use a light color within the top 1/4th area of the center square depicting the saturation/luminance gradients. |
|  *Site Map:* | <input type="radio" name="SITEMAPLIST" value="on" checked="checked" /> Yes &nbsp; <input type="radio" name="SITEMAPLIST" value="" /> No | Include this web in the site map |
|  *Description:<br /> &nbsp;<br /> &nbsp;* | <input type="text" class="twikiInputField" name="SITEMAPWHAT" value="" size="60" /><br /> Enter a short description of the web. Write =[<nop>[Web.TopicName][title]]= instead of just =TopicName= if you include links. This description will be used in the %SYSTEMWEB%.SiteMap. ||
|  *Hidden:* | <input type="radio" name="NOSEARCHALL" value="on" /> Yes &nbsp; <input type="radio" name="NOSEARCHALL" value="" checked="checked" /> No | Specify if you want to exclude the web from a "search all webs" search. *This will not prevent users accessing the web*, it will simply hide it from searches. Use [[TWikiAccessControl][access control]] if needed. |
| *&nbsp;* | <input type="submit" class="twikiSubmit" value="Create new web" /> ||
<input name="newtopic" type="hidden" value="%URLPARAM{"newtopic" encode="entity"}%" />
<input name="action" type="hidden" value="createweb" />
</form>

__Notes:__
   * You must have =ROOTCHANGE= access to create a top-level web (one with no parent)
   * Only the person who created it has permission to change the <nop>%WEBPREFSTOPIC% in the new web

---++ Hierarchical Webs

You can only create hierarchical webs (webs within webs) if the ={EnableHierarchicalWebs}= setting in [[%SCRIPTURLPATH{"configure"}%][configure]] is enabled. Hierarchical webs are currently %IF{"{EnableHierarchicalWebs}" then="enabled." else="disabled. Without this setting, TWiki will only allow a single level of hierarchy. With it, you can use multiple levels, like a directory tree, i.e. webs within webs."}%

__%T% Note:__ You might not need hierarchical webs. TWiki topics already have a parent/child relationship within a web, which is shown in the breadcrumb. Try to keep the number of webs to a minimum in order to keep search and cross-referencing simple. TWiki runs faster if hierarchical webs are disabled.

You can create hierarchical webs via the _Adding a New Web_ form above, by using a slash- or dot-separated path name which is based on an existing web name in the _Name of new web:_ field.

*Example:*

To create a sub-web named =Bar= inside a web named =Foo=, use =Foo/Bar= or =Foo.Bar= as the new web name in the form above.

---+++ Sub-web Preferences are Inherited

The preferences of a sub-web are inherited from the parent web and overridden locally.  Preferences are ultimately inherited from the [[%SYSTEMWEB%.TWikiPreferences]] topic.

*Example Preference Inheritance for =Sandbox/TestWeb/SubWeb.SubWebTopic= topic:*

   1. =%SYSTEMWEB%.TWikiPreferences= site-wide preferences
   2. =Sandbox.%WEBPREFSTOPIC%= inherits from and overrides settings in =%SYSTEMWEB%.TWikiPreferences=
   3. =Sandbox/TestWeb.%WEBPREFSTOPIC%= inherits from and overrides settings in =Sandbox.%WEBPREFSTOPIC%=
   4. =Sandbox/TestWeb/SubWeb.%WEBPREFSTOPIC%= inherits from and overrides settings in =Sandbox/TestWeb.%WEBPREFSTOPIC%= 
   5. =Sandbox/TestWeb/SubWeb.SubWebTopic= inherits from and overrides settings in =Sandbox/TestWeb/SubWeb.%WEBPREFSTOPIC%= 

---+++ Navigation

The PatternSkin indicates sub-webs by indenting them in the sidebar relative to their level in the hierarchy. The SiteMap shows a list of webs; sub-webs are separated by dots, such as =Web.SubWeb.SubSubWeb=.

#RenameWeb
---++ Renaming or Deleting a Web

Rename a web via the Tools section in each web's %WEBPREFSTOPIC% topic. You may delete a web by moving it into a Trash web.  

---+++ Permissions

You may only rename a web if you have the following permissions
   * You must be allowed to rename and changes topics in the web you want to rename
   * You must be allowed to rename topics in the parent web of the web you want to rename
   * If the web is a root web (i.e. it has no parent web) then you must have permission to both create and rename root webs. These permissions are controlled by the ALLOWROOTCHANGE preference, which can be set in [[%USERSWEB%.TWikiPreferences]].
   * If you move the web to another parent web you must be allowed to create and change topics in the new parent web.
   
When you rename a web TWiki will try and update all links that refer to the old web. You should note that links only get updated in topics that you are allowed to edit. If you use access rights in the TWiki installation it is generally best to let an administrator rename webs to avoid too many broken links. 

---+++ Edit Conflicts

If anyone is editing a topic which requires updating, or which lives in the web being renamed, a second confirmation screen will come up which will indicate which topics are still locked for edit.  You may continue to hit the refresh button until an edit lease is obtained for each topic which requires updating (the "Refresh" button will change to "Submit"), or hit "Cancel", which will cancel your edit lease on all affected topics.

---+++ Renaming the %SYSTEMWEB% or %USERSWEB% webs

Although technically possible, it is strongly advised __not__ to rename the %SYSTEMWEB% and %USERSWEB% webs. It complicates upgrades, and some extensions may make assumptions on the names of those system webs. For this reason, the rename web link is disabled in the <nop>%WEBPREFSTOPIC% topic in those webs.

__%H% Suggestion:__ Create a web that is the entry point for your TWiki, and change the link of the upper left site logo to that web. Do that with a WIKILOGOURL setting in [[%LOCALSITEPREFS%]].

If you want to rename the %SYSTEMWEB% or %USERSWEB% webs anyway:
   * Physically move the webs below =twiki/data= and =twiki/pub= on the shell level.
   * Change the ={SystemWebName}=, ={UsersWebName}= and/or ={LocalSitePreferences}= settings in the configuration using the [[%SCRIPTURL{configure}%][configure]] interface.

__Related Topics:__ AdminDocumentationCategory, AdminToolsCategory

-- __Contributors:__ TWiki:Main/MikeMannix, TWiki:Main/PeterThoeny, TWiki:Main/GrantBow
@


1.37
log
@buildrelease
@
text
@d1 1
a1 1
%META:TOPICINFO{author="TWikiContributor" date="1316842390" format="1.1" version="37"}%
d23 3
a25 1
There are two methods used to create a new web.  First you can use a specially designed TemplateWeb.  This is an invisible web that begins with an underscore &quot;_&quot; character (for example =_default=).  All topics in the template web will be copied into your new web.
d27 1
a27 3
The second method is to use an existing web as a template web.  This may be useful if you already have a web that you would like to use as a starting point.  Only topics that have names beginning with *Web...* (like "%HOMETOPIC%", "%NOTIFYTOPIC%", etc.) are copied.

In either case you will want to be sure to verify that your new web has all the custom modifications that you desire. Any TWikiVariables defined in the form below will automatically be set in the !WebPreferences of the new web.
@


1.36
log
@buildrelease
@
text
@d1 1
a1 1
%META:TOPICINFO{author="TWikiContributor" date="1304670871" format="1.1" version="36"}%
d11 8
a18 1
A TWikiSite is divided into webs; each one represents one subject, one area of collaboration. Administrators can add/rename/delete webs.
@


1.35
log
@buildrelease
@
text
@d1 1
a1 1
%META:TOPICINFO{author="TWikiContributor" date="1273167157" format="1.1" version="35"}%
d29 2
a30 2
|  *Based on web:* | <select name="baseweb" class="twikiSelect"> %WEBLIST{ "<option $marker>$name</option>" webs="webtemplate,public" selection="_default" separator=" "}% </select> | Select a TemplateWeb |
|  *Web color:* | <input name="WEBBGCOLOR" class="twikiInputField" type="text" value="#D0D0D0" size="16" /> | Enter a StandardColors code for the web |
d32 2
a33 2
|  *Description:<br /> &nbsp;<br /> &nbsp;* | <input type="text" class="twikiInputField" name="SITEMAPWHAT" value="" size="60" /><br /> Enter a short description of the web. Write =[<nop>[Web.TopicName][title]]= instead of just =TopicName= if you include links. This description will be used in the %SYSTEMWEB%.SiteMap ||
|  *Hidden:* | <input type="radio" name="NOSEARCHALL" value="on" /> Yes &nbsp; <input type="radio" name="NOSEARCHALL" value="" checked="checked" /> No | Specify if you want to exclude the web from a "search all webs" search. *This will not prevent users accessing the web*. It will simply hide it from searches. |
d47 1
a47 1
__%T% Note:__ You might not need hierarchical webs. TWiki topics already have a parent/child relationship within a web, which is shown in the breadcrumb. Try to keep the number of webs to a minimum in order to keep search and cross-referencing simple.
d53 1
a53 1
To create a subweb named =Bar= inside a web named =Foo=, use =Foo/Bar= or =Foo.Bar= as the new web name in the form above.
d55 1
a55 1
---+++ Subweb Preferences are Inherited
d57 1
a57 1
The preferences of a subweb are inherited from the parent web and overridden locally.  Preferences are ultimately inherited from the [[%SYSTEMWEB%.TWikiPreferences]] topic.
d69 1
a69 1
The Pattern skin (default) indicates Subwebs by indenting them in the sidebar relative to their level in the hierarchy.
@


1.34
log
@buildrelease
@
text
@d1 1
a1 1
%META:TOPICINFO{author="TWikiContributor" date="1241296650" format="1.1" version="34"}%
d32 1
a32 2
|  *Description:<br /> &nbsp;<br /> &nbsp;* | <input type="text" class="twikiInputField" name="SITEMAPWHAT" value="" size="60" /><br /> Enter a short description of the web. Write =Web.TopicName= instead of just =TopicName= if you include links. This description will be used in the %SYSTEMWEB%.SiteMap ||
|  *Use to...<br /> &nbsp;* | <input type="text" class="twikiInputField" name="SITEMAPUSETO" value="...collaborate on" size="60" /><br /> Continue the sentence describing the intended use. This is also for the %SYSTEMWEB%.SiteMap ||
@


1.33
log
@buildrelease
@
text
@d1 1
a1 1
%META:TOPICINFO{author="TWikiContributor" date="1228163901" format="1.1" version="33"}%
d27 1
a27 1
__%X% Note:__ *Keep the number of webs to a minimum!* Don't create a new web for each little project. Cross-linking topics is easier, and searches are faster, if there are only a few larger webs.
d75 1
a75 1
Rename a web via the Tools section in each %WEBPREFSTOPIC% topic.  You may delete a web by moving it into a Trash web.  
d91 1
a91 1
---+++ Renaming the webs in the distribution
d93 1
a93 1
It is possible, though not recommended, to change the names of the webs in the distribution.
d95 1
a95 1
If you plan to rename the %USERSWEB% web, remember that TWiki stores user topics in this web. That means that every WikiName signature - =%USERSWEB%.<nop>SomeUserName= - points to it and would need updating (unless the variable, =%<nop>USERSWEB%.<nop>SomeUserName=, is used throughout). This potentially large change can be performed automatically if you rename the web from the Tools section of %WEBPREFSTOPIC%, as described above.
d97 3
a99 1
%X% If you want to rename the %SYSTEMWEB% or %USERSWEB% webs, remember they are referred to in the TWiki configuration. You will need to change the ={SystemWebName}=, ={UsersWebName}= and/or ={LocalSitePreferences}= settings in the configuration using the [[%SCRIPTURL{configure}%][configure]] interface.
d101 1
a101 1
%X% Renaming the webs in the distribution is not recommended because it makes upgrades much more complicated.
d103 1
a103 1
__Related Topics:__ AdminDocumentationCategory, AdminToolsCategory
@


1.32
log
@buildrelease
@
text
@d1 1
a1 1
%META:TOPICINFO{author="TWikiContributor" date="1153528583" format="1.1" version="32"}%
d28 1
a28 1
|  *Name of new web:* | <input name="newweb" class="twikiInputField" type="text" value="%URLPARAM{"newweb"}%" size="16" /> | The name must start with an upper case letter, followed by upper or lower case letters or numbers. Specify a short name to avoid long URLs. |
d36 1
a36 1
<input name="newtopic" type="hidden" value="%URLPARAM{"newtopic"}%" />
@


1.31
log
@buildrelease
@
text
@d1 1
a1 1
%META:TOPICINFO{author="TWikiContributor" date="1153528583" format="1.1" version="31"}%
d28 3
a30 3
|  *Name of new web:* | <input name="newweb" type="text" value="%URLPARAM{"newweb"}%" size="16" /> | The name must start with an upper case letter, followed by upper or lower case letters or numbers. Specify a short name to avoid long URLs. |
|  *Based on web:* | <select name="baseweb"> %WEBLIST{ "<option $marker>$name</option>" webs="webtemplate,public" selection="_default" separator=" "}% </select> | Select a TemplateWeb |
|  *Web color:* | <input name="WEBBGCOLOR" type="text" value="#D0D0D0" size="16" /> | Enter a StandardColors code for the web |
d32 2
a33 2
|  *Description:<br /> &nbsp;<br /> &nbsp;* | <input type="text" name="SITEMAPWHAT" value="" size="60" /><br /> Enter a short description of the web. Write =Web.TopicName= instead of just =TopicName= if you include links. This description will be used in the %SYSTEMWEB%.SiteMap ||
|  *Use to...<br /> &nbsp;* | <input type="text" name="SITEMAPUSETO" value="...collaborate on" size="60" /><br /> Continue the sentence describing the intended use. This is also for the %SYSTEMWEB%.SiteMap ||
d79 7
a85 1
You may only rename a web if you have permissions to rename all the topics within that web, including any topics in that web's subwebs.  You will also need permissions to update any topics containing references to that web.
@


1.30
log
@buildrelease
@
text
@d1 1
a1 2
%META:TOPICINFO{author="TWikiContributor" date="1153528583" format="1.1" version="30"}%
%TOC%
d3 1
a3 1
---# Managing Webs
d7 2
d11 1
a11 1
A TWikiSite is divided into webs; each one represents one subject, one area of collaboration. Administrators (in the %MAINWEB%.TWikiAdminGroup) can add/rename/delete webs.
d20 1
a20 1
In either case you will want to be sure to verify that your new web has all the custom modifications that you desire.
d27 1
a27 1
__%X% Note:__ *Keep the number of webs to a minimum!* It is not recommended to create a new web for each little project. You can organize content within a web using categories, TWikiForms and FormattedSearch. Cross-linking topics and search is easier if there are only a few larger webs.
d30 5
a34 4
|  *Web color:* | <input name="webbgcolor" type="text" value="#D0D0D0" size="16" /> | Enter a StandardColors code for the web |
|  *Description:<br /> &nbsp;<br /> &nbsp;* | <input type="text" name="sitemapwhat" value="" size="60" /><br /> Enter a short description of the web. Write =Web.TopicName= instead of just =TopicName= if you include links. This will list the web in the %TWIKIWEB%.SiteMap (leave field empty if you prefer not to update the directory.) ||
|  *Use to...<br /> &nbsp;* | <input type="text" name="sitemapuseto" value="...collaborate on" size="60" /><br /> Continue the sentence describing the intended use. This is also for the %TWIKIWEB%.SiteMap ||
|  *Set NOSEARCHALL:* | <input type="radio" name="nosearchall" value="" checked="checked" /> No &nbsp; <input type="radio" name="nosearchall" value="on" /> Yes | Specify if you want to exclude the web from a "search all webs" search. *This will not prevent users accessing the web*. It will simply hide it from searches. |
d41 2
a42 23
   * You have to have =ROOTCHANGE= access to create a top-level web (one with no parent)
   * Attachments will NOT get copied over along with their topics
   * While creating the new web, TWiki will update the following variables in the %WEBPREFSTOPIC%: =WEBBGCOLOR=, =SITEMAPLIST=, =SITEMAPWHAT=, =SITEMAPUSETO= and =NOSEARCHALL=.  These variables are used to dynamically generate the SiteMap
   * TWiki does not edit the [[%TWIKIWEB%.TWikiPreferences]] to update the =WIKIWEBLIST=.  This must be done by hand

#RenameWeb
---++ Renaming or Deleting a Web

Rename a web via the Tools section in each web's %WEBPREFSTOPIC% topic.  You may delete a web by moving it into a Trash web.  

---+++ Permissions

You may only rename a web if you have permissions to rename all the topics within that web, including any topics in that web's subwebs.  You will also need permissions to update any topics containing references to that web.

---+++ Edit Conflicts

If anyone is editing a topic which requires updating, or which lives in the web being renamed, a second confirmation screen will come up which will indicate which topics are still locked for edit.  You may continue to hit the refresh button until an edit lease is obtained for each topic which requires updating (the "Refresh" button will change to "Submit"), or hit "Cancel", which will cancel your edit lease on all affected topics.

---+++ Renaming the webs in the distribution

If you plan to rename the %MAINWEB% web, remember that TWiki stores user and group topics in this web. That means that every WikiName signature - =%MAINWEB%.<nop>SomeUserName= - points to it and would need updating (unless the variable, =%<nop>MAINWEB%.<nop>SomeUserName=, is used throughout). This potentially large change can be performed automatically if you rename the web from the Tools section of %WEBPREFSTOPIC%, as described above.

%X% If you want to rename the %TWIKIWEB% or %MAINWEB% webs, remember they are referred to in the TWiki configuration. You will need to change the ={SystemWebName}=, ={UsersWebName}= and/or ={LocalSitePreferences}= settings in the configuration using the [[%SCRIPTURL{configure}%][configure]] interface.
d46 1
a46 1
Hierarchical web support is enabled by turning on the ={EnableHierarchicalWebs}= setting in [[%SCRIPTURLPATH{"configure"}%][configure]]. Without this setting, TWiki will only allow a single level of hierarchy (webs). If you set this, you can use multiple levels, like a directory tree, i.e. webs within webs.
d58 1
a58 1
The preferences of a subweb are inherited from the parent web and overridden locally.  Preferences are ultimately inherited from the [[%TWIKIWEB%.TWikiPreferences]] topic.
d62 2
a63 2
   1. =%TWIKIWEB%.TWikiPreferences= site-wide preferences
   2. =Sandbox.%WEBPREFSTOPIC%= inherits from and overrides settings in =%TWIKIWEB%.TWikiPreferences=
d72 22
@


1.29
log
@buildrelease
@
text
@d1 1
a1 1
%META:TOPICINFO{author="TWikiContributor" date="1111929255" format="1.0" version="29"}%
d39 1
d61 1
a61 1
%X% If you want to rename the %TWIKIWEB% or %MAINWEB% webs, remember they are referred to in the TWiki configuration. You will need to change the relevant settings in the configuration using the [[%SCRIPTURL{configure}%][configure]] interface.
d65 1
a65 1
Hierarchical web support is enabled by turning on the ={EnableHierarchicalWebs}= setting in =configure=. Without this setting, TWiki will only allow a single level of hierarchy (webs). If you set this, you can use multiple levels, like a directory tree, i.e. webs within webs.
@


1.28
log
@buildrelease
@
text
@d1 1
a1 1
%META:TOPICINFO{author="TWikiContributor" date="1111929255" format="1.0" version="28"}%
d17 1
a17 1
The second method is to use an existing web as a template web.  This may be useful if you already have a web that you like to use as a starting point.  Only topics that have names beginning with *Web...* (like "%HOMETOPIC%", "%NOTIFYTOPIC%", etc.) are copied.
d40 1
a40 1
   * While creating the new web, TWiki will update the following variables in the WebPreferences: =WEBBGCOLOR=, =SITEMAPLIST=, =SITEMAPWHAT=, =SITEMAPUSETO= and =NOSEARCHALL=.  These variables are used to dynamically generate the SiteMap
d43 1
d46 1
a46 1
Rename a web via the Tools section in each web's WebPreferences topic.  You may delete a web by moving it into a Trash web.  
d58 1
a58 1
If you plan to rename the %MAINWEB% web, remember that TWiki stores user and group topics in =%<nop>MAINWEB%=, which by default is =Main= (this is assigned in the site configuration). That means that every WikiName signature - =Main.<nop>SomeUserName= - points to it and would need updating (unless the variable, =%<nop>MAINWEB%.<nop>SomeUserName=, is used throughout).  This potentially large change can be performed automatically with the renameweb function mentioned above, in the [[%MAINWEB%.WebPreferences]] topic.
d60 1
a60 1
If you want to rename the TWiki web, remember it is referred to by =%<nop>TWIKIWEB%= which is also defined by a configuration setting.
d81 4
a84 4
   2. =Sandbox.WebPreferences= inherits from and overrides settings in =%TWIKIWEB%.TWikiPreferences=
   3. =Sandbox/TestWeb.WebPreferences= inherits from and overrides settings in =Sandbox.WebPreferences=
   4. =Sandbox/TestWeb/SubWeb.WebPreferences= inherits from and overrides settings in =Sandbox/TestWeb.WebPreferences= 
   5. =Sandbox/TestWeb/SubWeb.SubWebTopic= inherits from and overrides settings in =Sandbox/TestWeb/SubWeb.WebPreferences= 
@


1.27
log
@buildrelease
@
text
@d1 1
a1 1
%META:TOPICINFO{author="TWikiContributor" date="1111929255" format="1.0" version="27"}%
d32 1
a32 1
|  *Exclude web from "search all":* | <input type="radio" name="nosearchall" value="" checked="checked" /> No &nbsp; <input type="radio" name="nosearchall" value="on" /> Yes | Specify if you want to exclude the web from a "search all webs" search. Note that the %TWIKIWEB%.SiteMap will not list the web if you select Yes. |
d39 3
a41 3
	* Attachments will NOT get copied over along with their topics
	* While creating the new web, TWiki will update the following variables in the WebPreferences: =WEBBGCOLOR=, =SITEMAPLIST=, =SITEMAPWHAT=, =SITEMAPUSETO= and =NOSEARCHALL=.  These variables are used to dynamically generate the SiteMap
	* TWiki does not edit the [[%TWIKIWEB%.TWikiPreferences]] to update the =WIKIWEBLIST=.  This must be done by hand
d79 5
a83 5
	1. =%TWIKIWEB%.TWikiPreferences= site-wide preferences
	2. =Sandbox.WebPreferences= inherits from and overrides settings in =%TWIKIWEB%.TWikiPreferences=
	3. =Sandbox/TestWeb.WebPreferences= inherits from and overrides settings in =Sandbox.WebPreferences=
	4. =Sandbox/TestWeb/SubWeb.WebPreferences= inherits from and overrides settings in =Sandbox/TestWeb.WebPreferences= 
	5. =Sandbox/TestWeb/SubWeb.SubWebTopic= inherits from and overrides settings in =Sandbox/TestWeb/SubWeb.WebPreferences= 
@


1.26
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="PeterThoeny" date="1093126616" format="1.0" version="1.26"}%
d6 1
a6 1
_Adding webs is a web based operation; renaming and deleting webs are manual operations done directly on the server_
d10 1
a10 1
A TWikiSite is divided into webs; each one represents one subject, one area of collaboration. Administrators can add/rename/delete webs.
d15 1
a15 1
There are two methods used to create a new web.  First you can use a specially designed TemplateWeb.  This is an invisible web that begins with an underscore &quot;_&quot; character.  All topics in the _default template web will be copied into your new web.
d24 5
a28 4
<form name="admin" action="%SCRIPTURLPATH%/manage%SCRIPTSUFFIX%/%INTURLENCODE{"%WEB%/%TOPIC%"}%" method="post">
Create a new web by filling out this form. __Note:__ It is not recommended to create a new web for each little project. You can organize content within a web using TWikiForms and FormattedSearch. Cross-linking topics and search is easier if there are only a few larger webs.
|  *Name of new web:* | <input name="newweb" type="text" value="%URLPARAM{"newweb"}%" size="16" /> | Enter a short name of up to 10 characters. The name must start with an upper case letters, followed by optional upper or lower case letters or numbers |
|  *Based on web:* | <select name="baseweb"> %WEBLIST{ "<option>$name</option>" webs="webtemplate,public" selection="_default" separator=" "}% </select> | Select a TemplateWeb |
d33 1
a33 1
| | <input type="submit" value="Create new web" /> ||
d40 2
a41 3
	* The manage script while creating the new web will update the following variables in the WebPreferences: =WEBBGCOLOR=, =SITEMAPLIST=, =SITEMAPWHAT=, =SITEMAPUSETO= and =NOSEARCHALL=.  These variables are used to dynamically generate the SiteMap
	* This script does not edit the [[%TWIKIWEB%.TWikiPreferences]] file to update the =WIKIWEBLIST=.  This must be done by hand
	* As of TWiki Release 01 Sep 2004, a web name can be a WikiWord. Prior to that it could be only =UPPER= or =UPPERlower=. A side effect of this is that if you do use a wiki name, =%<nop>WEB%= must be written as =&lt;nop&gt;%<nop>WEB%= or else it will try to link to a non-existing topic of that name
d45 1
a45 1
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.
d47 1
a47 16
	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 =%<nop>MAINWEB%.<nop>SomeTopic=
	1. Edit the %WIKIPREFSTOPIC% topic: Rename or delete the web from the =WIKIWEBLIST= variable
	1. Login to the %WIKITOOLNAME% server, via Telnet or FTP
	1. Go to =twiki/data= and rename or remove the web directory
	1. Go to =twiki/templates= and rename or remove the web directory if present
		* __Note:__ See TWiki:Codev.RenameWebs for some complications
	1. Go to =twiki/pub= and rename or remove the web directory if present

---+++ Renaming the MAINWEB

If you plan to rename the %MAINWEB% web, remember that TWiki stores user and group topics in =%<nop>MAINWEB%=, default named =Main=. That means, every WikiName signature - =Main.<nop>SomeUserName= - points to it and would need updating (unless the variable, =%<nop>MAINWEB%.<nop>SomeUserName=, is used throughout).

-- TWiki:Main.MikeMannix - 14 Sep 2001 %BR%
-- TWiki:Main.PeterThoeny - 07 Apr 2002 %BR%
-- TWiki:Main.GrantBow - 16 Jan 2003
d49 42
@


1.25
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="PeterThoeny" date="1092981212" format="1.0" version="1.25"}%
a46 3
---+++ Renaming the MAINWEB

If you plan to rename the %MAINWEB% web, remember that TWiki stores user and group topics in =%<nop>MAINWEB%=, default named =Main=. That means, every WikiName signature - =Main.<nop>SomeUserName= - points to it and would need updating (unless the variable, =%<nop>MAINWEB%.<nop>SomeUserName=, is used throughout).
d55 4
@


1.24
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="PeterThoeny" date="1092558303" format="1.0" version="1.24"}%
@


1.23
log
@none
@
text
@d1 62
a62 58
%META:TOPICINFO{author="PeterThoeny" date="1042964520" format="1.0" version="1.23"}%
%TOC%
%STARTINCLUDE%
---# Managing Webs

_Adding webs is a web based operation; renaming and deleting webs are manual operations done directly on the server_

---++ Overview

A TWikiSite is divided into webs; each one represents one subject, one area of collaboration. Administrators can add/rename/delete webs.

#WebTemplate
---++ Choose Web Template

There are two methods used to create a new web.  First you can use a specially designed TemplateWeb.  This is an invisible web that begins with an underscore &quot;_&quot; character.  All topics in the _default template web will be copied into your new web.

The second method is to use an existing web as a template web.  This may be useful if you already have a web that you like to use as a starting point.  Only topics that have names beginning with *Web...* (like "%HOMETOPIC%", "%NOTIFYTOPIC%", etc.) are copied.

In either case you will want to be sure to verify that your new web has all the custom modifications that you desire.

#CreateNewWeb
---++ Adding a New Web

<form name="admin" action="%SCRIPTURLPATH%/manage%SCRIPTSUFFIX%/%INTURLENCODE{"%WEB%/%TOPIC%"}%" method="post">
Create a new web by filling out this form. __Note:__ It is not recommended to create a new web for each little project. You can organize content within a web using TWikiForms and FormattedSearch. Cross-linking topics and search is easier if there are only a few larger webs.
|  *Name of new web:* | <input name="newweb" type="text" value="%URLPARAM{"newweb"}%" size="16" /> | 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 %TWIKIWEB%.WikiWord |
|  *Based on web:* | <select name="baseweb"> %WEBLIST{ "<option>$name</option>" webs="webtemplate,public" selection="_default" separator=" "}% </select> | Select a TemplateWeb |
|  *Web color:* | <input name="webbgcolor" type="text" value="#D0D0D0" size="16" /> | Enter a StandardColors code for the web |
|  *Description:<br /> &nbsp;<br /> &nbsp;* | <input type="text" name="sitemapwhat" value="" size="60" /><br /> Enter a short description of the web. Write =Web.TopicName= instead of just =TopicName= if you include links. This will list the web in the %TWIKIWEB%.SiteMap (leave field empty if you prefer not to update the directory.) ||
|  *Use to...<br /> &nbsp;* | <input type="text" name="sitemapuseto" value="...collaborate on" size="60" /><br /> Continue the sentence describing the intended use. This is also for the %TWIKIWEB%.SiteMap ||
|  *Exclude web from "search all":* | <input type="radio" name="nosearchall" value="" checked="checked" /> No &nbsp; <input type="radio" name="nosearchall" value="on" /> Yes | Specify if you want to exclude the web from a "search all webs" search. Note that the %TWIKIWEB%.SiteMap will not list the web if you select Yes. |
| | <input type="submit" value="Create new web" /> ||
<input name="newtopic" type="hidden" value="%URLPARAM{"newtopic"}%" />
<input name="action" type="hidden" value="createweb" />
</form>

*Note:* Attachments will NOT get copied over along with their topics.  This will be a feature added for the TWiki:Codev/CairoRelease.

*Note:* This script does not yet edit the [[%TWIKIWEB%.TWikiPreferences]] file to update the =WIKIWEBLIST=.  This must be done by hand.

The manage script while creating the new web will update the following variables in the WebPreferences: =WEBBGCOLOR=, =SITEMAPLIST=, =SITEMAPWHAT=, =SITEMAPUSETO= and =NOSEARCHALL=.  These variables are now used to dynamically generate the SiteMap.

---++ Renaming or Deleting a Web

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.

*NOTE:* If you plan to rename the %WIKITOOLNAME%.%MAINWEB% web, remember that TWiki stores user and group topics in =%<nop>MAINWEB%=, default named =Main=. That means, every WikiName signature - =Main.<nop>SomeUserName= - points to it and would need updating (unless the variable, =%<nop>MAINWEB%.<nop>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 =%<nop>MAINWEB%.<nop>SomeTopic=.
	1. Edit the %WIKIPREFSTOPIC% topic: Rename or delete the web from the =WIKIWEBLIST= variable.
	1. Login to the %WIKITOOLNAME% server, via Telnet or FTP.
	1. Go to =twiki/data= and rename or remove the web directory.
	1. Go to =twiki/templates= and rename or remove the web directory if present.
	1. Go to =twiki/pub= and rename or remove the web directory if present.

-- %MAINWEB%.MikeMannix - 14 Sep 2001 <br />
-- %MAINWEB%.PeterThoeny - 07 Apr 2002 <br />
-- %MAINWEB%.GrantBow - 16 Jan 2003
@


1.22
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="PeterThoeny" date="1042010710" format="1.0" version="1.22"}%
d12 9
d27 1
a27 1
|  *Based on web:* | <select name="baseweb"> %WEBLIST{ "<option>$name</option>" webs="webtemplate,public" selection="_default" separator=" "}% </select> | 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 *Web...* (like "%HOMETOPIC%", "%NOTIFYTOPIC%") are copied from other webs |
d37 6
d47 1
a47 1
*NOTE:* If you plan to rename the %WIKITOOLNAME%.%MAINWEB% web, remember that TWiki stores user and group topics in =%<nop />MAINWEB%=, default named =Main=. That means, every WikiName signature - =Main.<nop>SomeUserName= - points to it and would need updating (unless the variable, =%<nop>MAINWEB%.<nop>SomeUserName=, is used throughout).
d56 3
a58 2
-- MikeMannix - 14 Sep 2001 <br />
-- Main.PeterThoeny - 07 Apr 2002 <br />
@


1.21
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="PeterThoeny" date="1041741746" format="1.0" version="1.21"}%
d15 1
a15 1
<form name="admin" action="%SCRIPTURLPATH%/manage%SCRIPTSUFFIX%/%URLENCODE{"%WEB%/%TOPIC%"}%" method="post">
@


1.20
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="PeterThoeny" date="1041735052" format="1.0" version="1.20"}%
d15 1
a15 1
<form name="admin" action="%SCRIPTURLPATH%/manage%SCRIPTSUFFIX%/%WEBURLENDODED%/%TOPICURLENDODED%" method="post">
@


1.19
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="PeterThoeny" date="1018775280" format="1.0" version="1.19"}%
d15 1
a15 1
<form name="admin" action="%SCRIPTURLPATH%/manage%SCRIPTSUFFIX%/%WEB%/%TOPIC%" method="post">
@


1.18
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="PeterThoeny" date="1018172760" format="1.0" version="1.18"}%
d16 1
a16 2
Create a new web by filling out this form. __Note:__ 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.

d18 1
a18 1
|  *Based on web:* | <select name="webtemplate"> %WEBLIST{ "<option>$name</option>" webs="webtemplate,public" selection="_default" separator=" "}% </select> | 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 *Web...* (like "%HOMETOPIC%", "%NOTIFYTOPIC%") are copied from an existing web |
d20 3
a22 4
|  *Exclude web from "search all":* | <input type="radio" name="nosearchall" value="" checked="checked" /> No &nbsp; <input type="radio" name="nosearchall" value="on" /> Yes | Specify if you want to exclude the web from a "search all webs" search |
|  *Update WIKIWEBLIST:* | <input type="radio" name="updatewikiweblist" value="" /> No &nbsp; <input type="radio" name="updatewikiweblist" value="on" checked="checked" /> Yes | Specify if you want to list the new web in the WIKIWEBLIST displayed by some skins in the upper right hand corner |
|  *Description:<br /> &nbsp;* | <input type="text" name="description" value="" size="60" /><br /> Enter a short description of the web. This is for listing the web in the %TWIKIWEB%.SiteMap (leave field empty if you prefer not to update the directory) ||
|  *Used to...<br /> &nbsp;* | <input type="text" name="usedto" value="..." size="60" /><br /> Continue the sentence describing the intended use. This is also for the %TWIKIWEB%.SiteMap ||
d25 1
a25 1
<input name="action" type="hidden" value="createnewweb" />
a26 2

For detailed instructions, see [[TWikiInstallationGuide#CreateWeb][TWiki Installation Guide: Adding a New Web]].
@


1.17
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="PeterThoeny" date="1000462193" format="1.0" version="1.17"}%
d6 1
a6 1
_Adding, renaming and deleting webs are manual operations done directly on the server_
d10 1
a10 1
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.
d12 1
d15 2
a16 1
Adding new webs is quick and easy - you can have a basic web up and running in a couple of minutes:
d18 11
a28 3
	1. *Create* a new directory under =twiki/data/=, ex: =twiki/data/Newweb= <br />
		* the name has to start with a capital and _cannot_ be a WikiWord
	1. *Copy* in the contents of =twiki/data/_default=.
d34 2
a39 1
	1. Edit the TWikiWebsTable topic: Rename or delete the web from the table.
d46 1
@


1.16
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="MikeMannix" date="1000458041" format="1.0" version="1.16"}%
d16 1
a16 1
	1. *Create* a new directory under =twiki/data/=, ex: =twiki/data/Newweb= <br>
d20 1
a20 1
For detailed instructions, see [[TWikiDocumentation#CreateWeb][TWiki Installation Guide: Adding a New Web]].
d26 1
a26 1
		* Make changes as required, to =Newwebname.SomeTopic= or better yet, to ==%<nop>MAINWEB%.<nop>SomeTopic=.
@


1.15
log
@none
@
text
@d1 1
a1 3
%META:TOPICINFO{author="MikeMannix" date="1000278166" format="1.0" version="1.15"}%
%INCLUDE{"UtilTempDocNote"}%

d6 1
a6 1
_Adding, renaming and deleting webs is done directly on the server_
d10 1
a10 1
Managing TWiki webs requires direct access to the installation files on the host server. There are no browser-based web tools.
d12 1
a12 1
---++ How to Add a New Web
d16 2
a17 1
	1. *Create* a new directory under ==twiki/data/==, ex: =twiki/data/newweb=
d20 1
a20 1
For detailed instructions: [[TWikiDocumentation#CreateWeb][TWiki Installation Guide: Creating a New Web]].
d22 1
a22 1
---++ How to Rename or Delete a Web
d24 3
a26 2
*NOTE:* Think twice if you intend to rename the %WIKITOOLNAME%.%MAINWEB% 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.<nop>SomeName=). (On the other hand, if the =%<nop>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.
d29 4
a32 4
	1. Connect to the %WIKITOOLNAME% server: Login via Telnet or FTP.
	1. Edit the data files: Go to =twiki/data= and rename or delete the web directory.
	1. Edit the template files: Go to =twiki/templates= and rename or delete the web directory if present.
	1. Edit the public files: Go to =twiki/pub= and rename or delete the web directory if present.
d34 1
a34 1
-- MikeMannix - 29 Aug 2001 <br>
@


1.14
log
@none
@
text
@d1 3
a3 1
%META:TOPICINFO{author="MikeMannix" date="1000078735" format="1.0" version="1.14"}%
@


1.13
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="MikeMannix" date="999857695" format="1.0" version="1.13"}%
d14 6
a19 1
	* See [[TWikiDocumentation#TWikiInstallationGuide][TWikiInstallationGuide]]
@


1.12
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="MikeMannix" date="999689258" format="1.0" version="1.12"}%
d4 1
a4 1
---## Managing Webs
d8 1
a8 1
---+++ Overview
d12 1
a12 1
---+++ How to Add a New Web
d16 1
a16 1
---+++ How to Rename or Delete a Web
@


1.11
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="MikeMannix" date="999501050" format="1.0" version="1.11"}%
d6 1
a6 1
Adding, renaming and deleting webs is done directly on the server
d10 1
a10 1
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 [[TWiki.ManagingTopics][ModifyTopics]]). 
d14 1
a14 1
	* See [[TWikiDocumentation#TWiki_Installation_Notes][TWiki Installation Notes]]
d18 8
a25 8
	* *NOTE:* Think twice if you intend to rename the %WIKITOOLNAME%.%MAINWEB% 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 ==%<nop>MAINWEB%== is used throughout, you have no 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.
	1. *Edit the %WIKIPREFSTOPIC% topic:* Rename or delete the web from the =WIKIWEBLIST= variable.
	1. *Edit the TWikiWebsTable topic:* Rename or delete the web from the table.
	1. *Connect to the %WIKITOOLNAME% server:* Login via Telnet or FTP.
	1. *Edit the data files:* Go to ==twiki/data== and rename or delete the web directory.
	1. *Edit the template files:* Go to ==twiki/templates== and rename or delete the web directory if present.
	1. *Edit the public files:* Go to ==twiki/pub== and rename or delete the web directory if present.
@


1.10
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="MikeMannix" date="999329908" format="1.0" version="1.10"}%
d6 5
a10 1
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. Before making changes to a web, you can move individual topics through your browser (see [[TWiki.ManagingTopics][ModifyTopics]]). No similar web controls are available through the browser interface.
@


1.9
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="MikeMannix" date="999319650" format="1.0" version="1.9"}%
d4 1
a4 1
---## Modifying Webs
d6 1
a6 1
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. Before making changes to a web, you can move individual topics through your browser (see [[TWiki.RenameTopic][ModifyTopics]]). No similar web controls are available through the browser interface.
@


1.8
log
@none
@
text
@d1 1
a1 2
%META:TOPICINFO{author="MikeMannix" date="999208953" format="1.0" version="1.8"}%
%META:TOPICPARENT{name="WebHome"}%
@


1.7
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="MikeMannix" date="999139447" format="1.0" version="1.7"}%
d5 1
a5 1
---## Add, Name, or Delete Webs
@


1.6
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="JohnTalintyre" date="997200382" format="1.0beta2" version="1.6"}%
d3 3
a5 1
---## TWiki Administration
d7 1
a7 1
The current implementation of %WIKITOOLNAME% is designed to never forget.  So you can't delete a topic, however you can move or rename a topic and the original information is saved in topic meta data.  If you want an even stronger memory, you can disable renaming on some or all topics; see TWikiAccessControl.
d9 1
a9 1
---+++ How to add a New Web
d15 8
a22 8
	* It is advisable not to rename the %WIKITOOLNAME%.%MAINWEB% 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. search all webs for =Obsolete.= (include the period, this is to find topics like =Obsolete.SomeTopic= ). Take measures if necessary.
	* Edit the %WIKIPREFSTOPIC% 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 %WIKITOOLNAME% installation.
	* cd to ==twiki/data== and rename / delete the web directory.
	* cd to ==twiki/templates== and rename / delete the web directory if present.
	* cd to ==twiki/pub== and rename / delete the web directory if present.
d24 1
a24 2
-- Main.PeterThoeny - 03 Mar 2001 <br>
-- JohnTalintyre - 07 Aug 2001 <br>
@


1.5
log
@none
@
text
@d1 2
d5 1
a5 12
The current implementation of %WIKITOOLNAME% is designed to never forget, that means all topic changes are under revision control and you can't delete or rename topics. 

Nevertheless there are cases where you wish to delete topics. %WIKITOOLNAME% requires administrative stuff like that to be done on the shell level, so please ask your %WIKITOOLNAME% administrator to do that for you. A future version will allow administrators to do that on the browser level.

---+++ How to Rename or Delete a Topic

	* 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.
	* Telnet to the %WIKITOOLNAME% 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.
d23 1
@


1.4
log
@none
@
text
@d1 2
d7 1
a7 1
*How to Rename or Delete a Topic*
d12 3
a14 3
	* 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.
d16 1
a16 1
*How to add a New Web*
d18 1
a18 1
	* See <a href="TWikiDocumentation#installation">Installation Notes</a>
d20 1
a20 1
*How to Rename or Delete a Web*
d27 3
a29 3
	* cd to =twiki/data= and rename / delete the web directory.
	* cd to =twiki/templates= and rename / delete the web directory if present.
	* cd to =twiki/pub= and rename / delete the web directory if present.
d31 1
a31 1
-- Main.PeterThoeny - 12 Nov 2000 <br>
@


1.3
log
@none
@
text
@d22 1
a22 1
	* Edit the TWikiPreferences topic and rename / delete the web from the =WIKIWEBLIST= variable.
@


1.2
log
@none
@
text
@d16 1
a16 1
	* See TWikiInstallationNotes.
@


1.1
log
@none
@
text
@d1 1
a1 1
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. 
d3 1
a3 1
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.
d8 2
a9 2
	* 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.
d16 1
a16 1
	* See TWikiImplementationNotes.
d20 2
a21 2
	* 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.
d24 1
a24 1
	* Telnet to the TWiki installation.
d26 1
a26 1
	* cd to =twiki/templates= and rename / delete the web directory.
d29 1
a29 1
-- Main.PeterThoeny - 01 May 2000 <br>
@
