Adding, renaming and deleting webs are all web-based operations.
On this page:
A site is divided into webs; each one represents one subject, one area of collaboration. Administrators can add/rename/delete webs.
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
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 "WebHome", "WebNotify", 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 Macros defined in the form below will automatically be set in the WebPreferences of the new web.
New webs can be created using the WebCreateNewWeb AdminTool. You must have
You can only create hierarchical webs (webs within webs) if the
Note: You might not need hierarchical webs. Foswiki 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.
To create a subweb named
Example Preference Inheritance for
The Pattern skin (default) indicates Subwebs by indenting them in the sidebar relative to their level in the hierarchy.
Rename a web via the Tools section in each WebPreferences topic. You may delete a web by moving it into a Trash web.
You may only rename a web if you have the following permissions
! * 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 SitePreferences.
When you rename a web Foswiki 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 Foswiki installation it is generally best to let an administrator rename webs to avoid too many broken links.
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.
It is possible, though not recommended, to change the names of the webs in the distribution.
If you plan to rename the Main web, remember that Foswiki stores user topics in this web. That means that every WikiName signature -
If you want to rename the System or Main webs, remember they are referred to in the Foswiki configuration. You will need to change the
Renaming the webs in the distribution is not recommended because it makes upgrades much more complicated.