diff options
| -rw-r--r-- | TWiki/ManagingTopics.mdwn | 18 |
1 files changed, 9 insertions, 9 deletions
diff --git a/TWiki/ManagingTopics.mdwn b/TWiki/ManagingTopics.mdwn index 647efbb4..8761dc1c 100644 --- a/TWiki/ManagingTopics.mdwn +++ b/TWiki/ManagingTopics.mdwn @@ -1,10 +1,10 @@ %TOC% %STARTINCLUDE% -## <a name="Managing_Topics"> Managing Topics </a> +# <a name="Managing_Topics"> Managing Topics </a> _Browser-based rename, move, and delete for individual topics_ -### <a name="Overview"> Overview </a> +## <a name="Overview"> Overview </a> Select **Rename/move** when viewing a topic to change its name, move it to another TWiki web, or delete it: @@ -15,7 +15,7 @@ Select **Rename/move** when viewing a topic to change its name, move it to anoth * If any of the referring pages are locked then they will be listed * You can correct these later by again pressing Rename/Move -#### <a name="Referring_Topics"> Referring Topics </a> +### <a name="Referring_Topics"> Referring Topics </a> Referring topics are found using the the %SEARCH% variable, see the template <code>**searchrenameview.tmpl**</code>. 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. @@ -23,25 +23,25 @@ Changed references are kept are as short as possible, i.e. _topic_ is used in pr <a name="DeleteTopic"></a> -#### <a name="Deleting_a_Topic"> Deleting a Topic </a> +### <a name="Deleting_a_Topic"> Deleting a Topic </a> 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. -##### <a name="Clearing_the_Trash"> Clearing the Trash </a> +#### <a name="Clearing_the_Trash"> Clearing the Trash </a> **_NOTE:_** The `Trash` web should be be cleared periodically, by archiving the contents if required (recommended), then deleting the files from the `Trash` directory. -### <a name="Redirecting_from_an_Old_Topic"> Redirecting from an Old Topic </a> +## <a name="Redirecting_from_an_Old_Topic"> Redirecting from an Old Topic </a> You can use [[TWikiMetaData]] to place a command in %TWIKIWEB%.WebTopicViewTemplate and %TWIKIWEB%.WebTopicNonWikiTemplate that will show if a topic has moved by searching for the tag %META:TOPICMOVED\{...\}%. Customize something like this: > %<nop>METASEARCH{type="topicmoved" web="%WEB%" topic="%TOPIC%" title="This topic used to exist and was moved to: "}% -### <a name="Impact_of_Topic_Access_Settings"> Impact of Topic Access Settings </a> +## <a name="Impact_of_Topic_Access_Settings"> Impact of Topic Access Settings </a> 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 [[TWikiDocumentation]] for information on setting up access permissions. -### <a name="How_Rename_move_Works"> How Rename/move Works </a> +## <a name="How_Rename_move_Works"> How Rename/move Works </a> * %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 [[TWikiDocumentation]] * User chooses which topics will be altered @@ -50,7 +50,7 @@ Permissions affect the rename function in various ways. To rename a topic, you n * 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. -### <a name="Known_Limitations"> Known Limitations </a> +## <a name="Known_Limitations"> Known Limitations </a> **Rename/move** in is fairly complicated due to the dynamic generation of links. Ideally, it would be possible to run the required part of rendering in a way that would allow identification of the text to be changed. Unfortunately, these hooks don't exist in TWiki at present. Instead, %SEARCH% is used with a special template to show the text to be changed, and the selected topics are then altered. One drawback is that `search` can show matches that will not be updated because of case differences. Other mismatches to actual rendered output are also possible as the approaches are so different. |