none
[openafs-wiki.git] / TWiki / TWikiTopics.mdwn
1 # <a name="TWiki Pages"></a> TWiki Pages
2
3 <div>
4   <ul>
5     <li><a href="#TWiki Pages"> TWiki Pages</a><ul>
6         <li><a href="#Page Features"> Page Features</a></li>
7         <li><a href="#How to rename, move or delete a"> How to rename, move or delete a page</a></li>
8       </ul>
9     </li>
10   </ul>
11 </div>
12
13 Each page in a TWiki web is called a **_topic_**, defined by its meaningful, descriptive [[WikiWord]] title.
14
15 ## <a name="Page Features"></a> Page Features
16
17 A TWiki topic is a self-contained information unit rich in features:
18
19 - a [[WikiWord]] title that lets you:
20   - instantly identify what the page is about
21   - automatically link to it from other pages
22 - an edit-anywhere collaboration area where you can:
23   - enter plain or fully-HTML formatted text
24   - work with simple TWiki editing shorthand (that includes HTML mark-up and special TWiki functions)
25   - include Web links, images, anything else you can put on a Web page
26 - an extra [[forms input|Main/TWikiDocumentation#TWiki_Form_Templates]] option:
27   - store structured info alongside the free-form page content
28   - use text fields and boxes, radio buttons, pulldown selector menus, checkboxes
29   - select from one or many different input forms, with all data preserved
30 - a [[FileAttachment]] feature that lets you:
31   - upload files through your browser to the TWiki server
32   - attach any type of file (documents, images, applications) for viewing or downloading
33   - make changes and update existing files
34 - [[TWiki Skins|Main/TWikiDocumentation#TWiki_Skins]] work on the web level, but can also be used to customize the look of headers and footers on a single pages
35 - browser-based controls for [[renaming, moving, and deleting|Main/WebHome#RenamingTopics]] pages:
36   - rename a page and automatically update all the references to it, site-wide
37   - move a page from one TWiki web to another
38   - safely delete a topic to a special Trash web (invisible, but accessible to the TWiki administrators if needed)
39 - flexible [[access control|Main/TWikiDocumentation#TWiki_Access_Control]]:
40   - independently determine who can see, edit, rename, move or delete topics
41   - set permissions by individual users and user groups
42
43 Depending on the set-up of your TWiki site and your own user account, you have several or all of the above.
44
45 <a name="RenamingTopics"></a>
46
47 ## <a name="How to rename, move or delete a"></a><a name="How to rename, move or delete a "></a> How to rename, move or delete a page
48
49 You can now rename, move and delete individual topics from your browser. All three options are available by clicking **More** on the control strip at the bottom of every page. The access settings for a topic, web or entire site may be disabled for one or more of the three options. In any case, all three are similar and extremely self-explanatory.
50
51 1. On the topic you want to change, click **More** &gt; **Rename/move**
52 2. To move or delete: select the target web (`Trash` for delete)from the pull-down menu; otherwise, leave on the current web
53 3. To rename: fill in a new [[WikiName]] (otherwise, leave the current topic name)
54 4. To update occurrences of the topic name on other pages: From the list of pages that link to the topic, check or uncheck each entry as you desire - only checked links will be updated;
55 5. Click **Rename/move**: the topic will be renamed and links to the topic updated.
56   - Any problems are listed ; you can change them later.
57   - If a referring page can't be update because it's locked (ex: someone's editing), it appears on an alert. You can missed pages later by again pressing **Rename/move**.
58
59 **Note:** Deleting means moving the topic to the Trash web. Since all webs share the one Trash, name conflicts may come up.
60
61 See [[ManagingTopics|Main/TWikiDocumentation#Managing_Topics]] for more details.