Difference: TWikiTopics (9 vs. 10)

Revision 102001-12-29 - MikeMannix

Line: 1 to 1
 
META TOPICPARENT name="WebHome"
Deleted:
<
<
Warning: Can't find topic TWiki.DocsUserNote
 

TWiki Pages

Deleted:
<
<
 
Changed:
<
<
Each page in a TWiki web is called a topic, defined by its meaningful, descriptive WikiWord title.
>
>
Each page in a TWiki web is called a topic, identified by a unique, hopefully descriptive, WikiWord title. A topic is the basic building block of a TWikiSite.
<--TWikiPages aren't exactly the same as topics, but for practical purposes, they're close enough!-->
 

Page Features

Changed:
<
<
A TWiki topic is a self-contained information unit rich in features:
>
>
A TWiki topic is a self-contained information unit rich in features. Each topic has:
 
  • a WikiWord title that lets you:
    • instantly identify what the page is about
Changed:
<
<
    • automatically link to it from other pages
  • an edit-anywhere collaboration area where you can:
    • enter plain or fully-HTML formatted text
    • work with simple TWiki editing shorthand (that includes HTML mark-up and special TWiki functions)
>
>
    • link to it from other pages just by typing it in
  • an edit link to a collaboration area where you can:
    • enter plain or HTML-formatted text (plain text is all you need)
    • use simple TWiki shorthand to enter HTML and special TWiki functions
 
    • include Web links, images, anything else you can put on a Web page
Changed:
<
<
  • an extra forms input option:
    • store structured info alongside the free-form page content
>
>
  • an extra Web forms option:
    • store database-style info alongside the free-form page content
 
    • use text fields and boxes, radio buttons, pulldown selector menus, checkboxes
Changed:
<
<
    • select from one or many different input forms, with all data preserved
>
>
    • create your own forms to gather searchable, sortable input
    • select one form per topic from as many choices as you like
 
  • a FileAttachment feature that lets you:
    • upload files through your browser to the TWiki server
    • attach any type of file (documents, images, applications) for viewing or downloading
Changed:
<
<
    • make changes and update existing files
>
>
    • upload revisions of existing files with automatic backup of all previous versions
 
  • TWiki Skins to customize the look of headers and footers:
Changed:
<
<
    • apply skins across an entire TWiki web level, or to a single page
>
>
    • apply skins across an entire TWiki web, or to a single page
    • use included skins and easily create new ones
    • try the [Printable] skin below: stripped down headers and footers suitable for printing
 
Changed:
<
<
    • rename a page and automatically update all the references to it, site-wide
>
>
    • rename a page and automatically update all of the links to it, site-wide
 
    • move a page from one TWiki web to another
Changed:
<
<
    • safely delete a topic to a special Trash web (invisible, but accessible to the TWiki administrators if needed)
>
>
    • safely delete a topic to a special Trash web (invisible, but recoverable from the Web server if necessary)
 
  • flexible access control:
    • independently determine who can see, edit, rename, move or delete topics
    • set permissions by individual users and user groups
Changed:
<
<
  • revision control automatically saves topic changes:
>
>
  • RCS revision control to automatically save all topic changes:
 
    • uses the established standard RCS (Revision Control System)
    • efficiently stores every change made to the original version
Changed:
<
<
    • allows comparison of changes between any two versions, and review of any version, as formatted or raw text
  • referred-by searches that list all topics in a web or site wide that link to a particular page
>
>
    • lets you compare changes between any two versions or review all chnages
    • displays any previous version as a regular Web page or as raw text
  • referred-by searches that list all topics that link to a particular page
 
  • hierarchical parent-child topic navigation:
    • automatically links a new page as the "child" of the page it was created from
    • allows manual assignment of parent page from a list of all topics in the local web
    • offers navigation displays, by topic parent, or by related topic
Added:
>
>
  • many more features - see TWikiMetaData, for a start - as well as special TWiki effects that you can store on a top (start with TWikiVariables)...
 
Changed:
<
<
The configuration of your TWiki site and your own user account determine which of these features you can use.
>
>
The configuration of your TWiki site and your personal user account determine which of these features are installed and available to you.
 

How to create and edit a page

Changed:
<
<
Adding and editing information on existing pages, and creating new pages, is TWiki's main function.
>
>
Making it incredibly easy for you to add and edit information on existing pages, create new pages, and link all TWiki pages, is TWiki's main function.
 
Changed:
<
<
  • To modify a topic, click the [Edit] link at the bottom left of every page. An editing window appears. Type away. Use the GoodStyle and TextFormattingRules links to get pop-up window help.
>
>
  • To modify a page, click the [Edit] link at the left of the toolbar at the bottom of every page. An editing window appears. Type away. Use the GoodStyle and TextFormattingRules links to get pop-up window help.
 
    • Click [Preview Changes] to see how your edit looks.
    • Click [Save Changes] to save.
Changed:
<
<
  • To add a new page, the simplest way is to type a new WikiName on an existing page. When the page is saved, the new name will appear highlighted, with a ? at the end: click the ? and a new edit window appears. Enter, preview and save as usual. The new page now exists.
>
>
  • To add a new page, the simplest way is to type a new WikiName on an existing page, while you're in edit mode. When the page is saved, the new name will appear highlighted, with a ? at the end: click the ? and a new edit window appears. Enter, preview and save as usual. The new page now exists.
    • Go back to the page where you started, and you'll see the ? has disappeared, and your WikiWord name is now a regular link. Type it anywhere on any page in that web, and it will be turned into a link.
    • HELP One little links rule: each topic, and its WikiWord link, belongs to one unique web only. To link between webs, you must first enter the topic's web name.
      For example: This is TWikiPages, in the TWiki web, so that's all you need to type on any page in this web. But to link to TWikiPages from a page in the Main web, you have to type TWiki.TWikiPages - Web.TopicName. It's simple.
 

How to attach files and use other features

Changed:
<
<
The color-coded control strip at the bottom of every page displays a series of links, including [Attach] (for attachments), [Ref-by] (to display referring pages), and [More], which opens a new screen of additional controls).
>
>
The color-coded toolbar at the bottom of every page displays a series of links, including:
  • [Attach] - pops a new screen for file attachments
  • [Ref-By] - displays all the TWiki pages with links to the page you're on
  • [Diffs] - generates a page showing every change made to the page you're on, with names, dates, and changes
  • r1.3 | > | r1.2 (ex) - some specific previous version stuff that you can check out on your own
  • [More] - opens up a whole new screen of additional controls
 
Changed:
<
<
  • Most controls are self-explanatory, and also include explanatory text and help links.
>
>
It looks like a lot - it is a lot, and there's more. BUT, it's all simple, flexible, and optional - the only way to confuse yourself or your site set-up and users is by using features you really don't need. Unlike the usual expensive, complex collaboration and project management packages, TWiki is fully functional and effective just by typing in text and making WikiWord links. All the rest is there only if you need it!

  • Most controls are self-explanatory, and also include instructions and help links.
 
  • Experiment. You can always cancel or go Back whenever you like.
  • Get in-depth info from the complete documentation, including the User's Guide and Reference Manual.

How to rename, move or delete a page

Changed:
<
<
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.
>
>
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, depending on your site set-up and personal permissions. In any case, all three are similar and extremely easy to use.
 
Changed:
<
<
  1. On the topic you want to change, click More > Rename/move
  2. To move or delete: select the target web (Trash for delete)from the pull-down menu; otherwise, leave on the current web
  3. To rename: fill in a new WikiName (otherwise, leave the current topic name)
  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;
  5. Click Rename/move: the topic will be renamed and links to the topic updated.
    • Any problems are listed ; you can change them later.
    • 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.
>
>
  1. Go to the page you want to change, click [More] > [Rename/move]
  2. To move or delete: select the target web (Trash to delete)from the pull-down menu (otherwise, leave on the current web)
  3. To rename: fill in a new WikiName (otherwise, leave the current topic name)
  4. To update links: From the list of pages that show links to the topic you're changing, uncheck each entry you DON'T want to update - only checked links will be updated;
  5. Click [Rename/move]: the topic are renamed and/or moved, and the checked links to the topic are updated.
    • Any problems are listed - take note, and you can fix them later.
    • If a linked page can't be updated (it may be locked because someone's editing it), an alert will appear. You can update missed pages later by again pressing [Rename/move].
  HELP Deleting means moving the topic to the Trash web. Since all webs share the one Trash, name conflicts may come up.
Deleted:
<
<
ALERT! NOTE: Keep in mind that moving a topic from a view-restricted web to a public web or the Trash web will compromise security.
 See: ManagingTopics for more details.
Changed:
<
<
Last updated: MikeMannix - 30 Oct 2001
>
>
Last updated: MikeMannix - 29 Dec 2001
 
META TOPICMOVED by="MikeMannix" date="1000261400" from="TWiki.HandlingTopics" to="TWiki.TWikiPages"
 
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 1999-2019 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding URCS? Send feedback
Note: Please contribute updates to this topic on TWiki.org at TWiki:TWiki.TWikiTopics.