From 3748d6f04706b05c20fb70e5daf66cea6c66ee38 Mon Sep 17 00:00:00 2001 From: MikeMannix Date: Tue, 18 Sep 2001 04:55:05 +0000 Subject: none --- TWiki/ManagingTopics.mdwn | 39 +++++++++++++++++++++------------------ 1 file changed, 21 insertions(+), 18 deletions(-) diff --git a/TWiki/ManagingTopics.mdwn b/TWiki/ManagingTopics.mdwn index 0225d09d..dddab2ac 100644 --- a/TWiki/ManagingTopics.mdwn +++ b/TWiki/ManagingTopics.mdwn @@ -6,30 +6,33 @@ _Browser-based rename, move, and delete for individual topics_ ## 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. -1. **Select** target web if other than the current web - chose **Trash** to delete a topic -2. **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 -3. **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) -4. **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 +## How to Rename/Move/Delete a Topic + +1. **Click** on **[More]** (bottom right of page) on the topic to be changed, then, in the new screen, on **[Rename/move]**. +2. **Select** target web if other than the current web - chose `Trash` to delete a topic +3. **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. +4. **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). +5. **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 @@ -38,18 +41,18 @@ You can use [[TWikiMetaData]] to place a command in %TWIKIWEB%.WebTopicViewTempl > %METASEARCH{type="topicmoved" web="%WEB%" topic="%TOPIC%" > title="This topic used to exist and was moved to: "}% -## 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 -* `
` and `` 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.
+1. %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.
+  * `
` and `` are honoured - no changes are made to text within these areas.
+2. The topic is moved (if locks allow).
+3. References are changed (locks and permissions permitting).
+4. Any referring topics that can't be changed due to locks are listed - user can change them at another time.
 
 ##  Known Limitations 
 
-- 
cgit v1.2.3