wiki-archive/twiki/data/TWiki/ManagingWebs.txt,v

986 lines
39 KiB
Plaintext

head 1.31;
access;
symbols;
locks; strict;
comment @# @;
1.31
date 2007.05.07.14.41.56; author RicardoPereira; 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.31
log
@none
@
text
@%META:TOPICINFO{author="RicardoPereira" date="1178548916" format="1.1" reprev="1.31" version="1.31"}%
%TOC%
%STARTINCLUDE%
---# Managing Webs
_Adding, renaming and deleting webs are all web-based operations._
---++ Overview
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.
#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 "_" character (for example =_default=). All topics in the 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 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.
#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!* 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.
| *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 |
| *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. |
| *&nbsp;* | <input type="submit" class="twikiSubmit" value="Create new web" /> ||
<input name="newtopic" type="hidden" value="%URLPARAM{"newtopic"}%" />
<input name="action" type="hidden" value="createweb" />
</form>
__Notes:__
* 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
#Add Web to Homepage and Web List
---++ Adding the New Web to the Homepage and Web List
_Specific instructions for TDWG wiki, added by Main.RicardoPereira on 07-May-2007_
After a web is created, references to it must be included on Main.WebHome and Main.SubgroupWebLeftBarWebList. Edit those two pages and follow the pattern used to present the other wiki webs.
#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.
---++ Hierarchical Webs
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.
__%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.
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 subweb named =Bar= inside a web named =Foo=, use =Foo/Bar= or =Foo.Bar= as the new web name in the form above.
---+++ Subweb Preferences are Inherited
The preferences of a subweb are inherited from the parent web and overridden locally. Preferences are ultimately inherited from the [[%TWIKIWEB%.TWikiPreferences]] topic.
*Example Preference Inheritance for =Sandbox/TestWeb/SubWeb.SubWebTopic= topic:*
1. =%TWIKIWEB%.TWikiPreferences= site-wide preferences
2. =Sandbox.%WEBPREFSTOPIC%= inherits from and overrides settings in =%TWIKIWEB%.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 Pattern skin (default) indicates Subwebs by indenting them in the sidebar relative to their level in the hierarchy.
__Related Topics:__ AdminDocumentationCategory, AdminToolsCategory
@
1.30
log
@buildrelease
@
text
@d1 1
a1 1
%META:TOPICINFO{author="TWikiContributor" date="1153528583" format="1.1" version="30"}%
d44 7
@
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>
@