| |
| META TOPICPARENT | name="WebHome" |
|---|
|
| | Overview |
|
<
< | Using browser controls while viewing a topic, you change its name, move it to another TWiki web, or delete it: |
>
> | Use browser controls while viewing a topic, to change its name, move it to another TWiki web, or delete it to a hidden Trash web. |
| | |
|
<
< |
- Select target web if other than the current web - chose
Trash to delete a topic
|
>
> | How to Rename/Move/Delete a Topic
- Click on
[More] (bottom right of page) on the topic to be changed, then, in the new screen, on [Rename/move].
- Select target web if other than the current web - chose
Trash to delete a topic
|
| |
- Enter the new topic name - default is current name
|
|
<
< | NOTE: You will be warned if there are locks or if there is a name conflict
- Select from the list of links to the topic that will be changed those to OMIT from changes (by default, all referring links will be updated)
- Click on Rename/Move to rename/remove topic will be renamed and links to the topic updated as requested.
- If any of the referring pages are locked then they will be listed
- You can correct these later by again pressing Rename/Move
|
>
> | NOTE: You will be warned if there are locks or if there is a name conflict.
- Select from the list of referring links any topics NOT to be updated with the new name (by default, all referring links will be updated).
- Click on
[Rename/Move]: the topic will be renamed and links to the topic updated as requested.
- If any of the referring pages are locked then they will be listed.
- You can correct these later by again pressing
[Rename/Move].
|
| | Referring Topics
Referring topics are found using the the %SEARCH% variable, see the template searchrenameview.tmpl. First, matching topics in the current Web are listed - matches are to topic. Next, all Webs (including the current one) are listed that match web.topic. Because %SEARCH% is used, Webs marked in WebPreferences as NOSEARCHALL will not show up in the search for refernces to the topic being changed. |
|
<
< | Changed references are kept are as short as possible, i.e. topic is used in preference to web.topic. |
>
> | Changed references are kept are as short as possible, ex: topic is used in preference to web.topic. |
| | |
|
<
< | Deleting a Topic |
>
> | About Deleting a Topic |
| | Deleted topics are moved to the Trash web - NOT physically erased from the server. All webs share Trash - in case of a name conflict with a topic already Trash, the user is alerted and asked to choose a new name. |
|
<
< | Clearing the Trash |
>
> | Clearing the Trash |
| | |
|
<
< | NOTE: The Trash web should be be cleared periodically, by archiving the contents if required (recommended), then deleting the files from the Trash directory. |
>
> | The Trash web should be be cleared periodically, by archiving the contents if required (recommended), then deleting the files from the Trash directory. |
| | Redirecting from an Old Topic |
| |
|
|
<
< | Impact of Topic Access Settings |
>
> | Effect of Access Settings |
| | Permissions affect the rename function in various ways. To rename a topic, you need both change and rename permissions. To alter refer4ing topics, you need change permission. See TWikiAccessControl for information on setting up access permissions.
How Rename/move Works |
|
<
< |
- %SEARCH% is used with a special template to show text in topics that requires updating to point to the new topic and/or web name. This includes relevent TWikiMetaData definition.
- User chooses which topics will be altered
-
<pre> and <verbatim> are honoured - no changes are made to text within these areas
- Topic is moved (if locks allow)
- References are changed (locks and permissions permitting)
- Any referring topics that can't be changed due to locks are listed - user can change them at another time.
|
>
> |
- %SEARCH%, with a special template, finds and displays all occurrences of the topic name in other topics, site-wide. These referring links are by default automatically changed to the new topic and/or web name. This includes relevant TWikiMetaData definitions.
- User can omit one or more topics from the update list.
-
<pre> and <verbatim> are honoured - no changes are made to text within these areas.
- The topic is moved (if locks allow).
- References are changed (locks and permissions permitting).
- Any referring topics that can't be changed due to locks are listed - user can change them at another time.
|
| | Known Limitations |