</ul>
</div>
-## <a name="Managing Topics"></a> Managing Topics
+# <a name="Managing Topics"></a> Managing Topics
_Browser-based rename, move, and delete for individual topics_
-### <a name="Overview"></a> Overview
+## <a name="Overview"></a> Overview
Select **Rename/move** when viewing a topic to change its name, move it to another TWiki web, or delete it:
- 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"></a> Referring Topics
+### <a name="Referring Topics"></a> Referring Topics
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.
<a name="DeleteTopic"></a>
-#### <a name="Deleting a Topic"></a> Deleting a Topic
+### <a name="Deleting a Topic"></a> 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.
-##### <a name="Clearing the Trash"></a> Clearing the Trash
+#### <a name="Clearing the Trash"></a> 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.
-### <a name="Redirecting from an Old Topic"></a> Redirecting from an Old Topic
+## <a name="Redirecting from an Old Topic"></a> Redirecting from an Old Topic
You can use [[TWikiMetaData]] to place a command in [[WebTopicViewTemplate]] and [[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"></a> Impact of Topic Access Settings
+## <a name="Impact of Topic Access Settings"></a> Impact of Topic 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 [[TWikiDocumentation#TWiki_Access_Control]] for information on setting up access permissions.
-### <a name="How Rename/move Works"></a> How Rename/move Works
+## <a name="How Rename/move Works"></a> 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 [[MetaData|Main/TWikiDocumentation#Meta_Data_Definition]]
- User chooses which topics will be altered
- 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"></a> Known Limitations
+## <a name="Known Limitations"></a> Known Limitations
**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.
git://git.openafs.org / openafs-wiki.git / blobdiff