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 that include:
18
19 - a [[WikiWord]] title that lets you:
20   - instantly identify what the page is about
21   - autolink to it from other pages simply by typing it in
22 - an edit-anywhere collaboration area where you can:
23   - enter plain or HTML-formatted text
24   - work with simple [[TWikiShorthand]] (the power of HTML plus special TWiki tags)
25   - include links, images, anything else you can put on a regular Web page
26 - an optional [[form|Main/TWikiDocumentation#TWiki_Form_Templates]] feature to:
27   - store structured info along with the freeform page content
28   - use text fields and boxes, radio buttons, pulldown selector menus, checkboxes
29   - select the right input template for each page from a choice of multiple form
30 - a [[FileAttachment]] function that allows you to:
31   - upload files through your browser to the TWiki server
32   - attach any size and type of file (documents, images, applications) for viewing or downloading
33   - make changes and update existing files
34 - [[TWiki Skins|Main/TWikiDocumentation#TWiki_Skins]] that work on the web level, but can also be used to customize the look of headers and footers on a single page
35 - browser-based controls for [[renaming, moving, and deleting|Main/WebHome#RenamingTopics]] pages:
36   - rename a page and automatically update all the links referring 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 view, edit, rename, move or delete topics
41   - set permissions by individual users and user groups
42
43 The configuration of your TWiki site and your own user account determine which of these features you can use.
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. Access to one or more of these three options, for a topic, a web or an entire site, may be available to administrators only. In any case, all three are similar and extremely self-explanatory.
50
51 1. On the page 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 is editing), it appears on an alert. You can update missed pages later by again pressing **Rename/move**.
58
59 %H% Deleting means moving the topic to the Trash web. Since all webs share the one Trash, name conflicts may come up.
60
61 %X% **NOTE:** Keep in mind that moving a topic from a view-restricted web to a public web or the Trash web will compromise security.
62
63 See [[ManagingTopics|Main/TWikiDocumentation#Managing_Topics]] for more details.
64
65 -- [[MikeMannix]] - 02 Oct 2001 <br />