summaryrefslogtreecommitdiff
path: root/TWiki/WelcomeGuest.mdwn
blob: 8dd4d120a7d86baee5b387248e61e5bb4fe783f8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
Welcome %WIKIUSERNAME%,

You have reached a [[TWikiSite]] (pronounced twee-kee site). TWiki is a meeting place where people collaborate on common interests. Anyone can contribute using a regular Web browser. TWiki looks like a normal Web site, but it allows (and ecourages) everyone to **edit the web pages** and contribute their questions and input. It really is very simple to learn and use, and provides possibly the most powerful way to exchange and develop ideas online, in an open, uncomplicated environment.

**How TWiki Works**

1. **Read:** You can treat this site like any other. Browse, and follow interesting links. A couple of hints:
  * **web:** A [[TWikiSite]] is divided into webs; each one represents one subject, one area of collaboration. You can reach any web from the links in the upper right corner of every page.
  * **topic:** Each web is made up of hyperlinked topics - [[TWikiPages]] that appear in your browser.
  * **What's new:** Visit [[WebChanges]] in any TWiki web to see what other people are discussing and what's been added most recently.
2. **Create an Account:** To be able to write new content on this site, you'll need to create an account for yourself. It's simple, and only takes a minute: just visit [[TWikiRegistration]] and fill out the form. This will also create your personal home page.
3. **Write:** If you have something to say, speak your mind! Anyone can change or add to anything they see written in a TWiki topic. You can edit a topic from within your browser, using [[TWikiShorthand]], a very simple markup language (you can also use HTML if you like, but you'll usually find you can get the same results more easily with [[TWikiShorthand]]). To contribute,
  * click the `Edit` link at the bottom of the page, edit the text, and then
  * click the `[ Preview Changes ]` button at the bottom of the page to see what your topic will look like (use the BACK button on your browser to go back and fix something.), and finally
  * click the `[ Save Changes ]` to save what you did.
4. **But this is scary!** Anybody can do anything! The concept at first may seem...strange. Uncontrollable. And yet, collaborating the Wiki way works! See [[WikiCulture]]. (You can define fine-grained [[TWikiAccessControl]] based on users groups if really necessary, and there's full revision control that retains all changes!)
5. **Experiment:** To get your virtual hands dirty, visit Test.%HOMETOPIC% in the %WIKITOOLNAME%.Test web.
6. **Create a link:** To link to another topic, start by editing an existing topic.
  * To create a link to a topic that already exists, type its `JoinCapitalizedWords` name (topics are automatically linked if they are [[WikiWords]], names composed of two or more words with initial capitals, run together).
  * To create a link to a page that does not yet exist, make up and enter a `NeverBeforeUsedPhrase`. You are encouraged to include [[WikiWords]] in your content, for others to fill out later.
  * When you've saved the topic, and redisplayed it, the references to existing topics will be linked and the references to topics that don't exist will be followed by a linked "<u>?</u>" (question mark).
7. **Create a topic:**
  * To write something up for a new topic, click on the "<u>?</u>" (question mark) that follows a [[WikiWord]].
  * To create a free-floating topic - a topic that is not linked from anywhere - type its [[WikiWord]] in the entry field at the top of any page. If the topic already exists you'll then be taken to it. If it doesn't exist, you'll then have the option to create it.
8. **See the history of a topic:** Click the <code>**Diffs**</code> link on the control strip at the bottom of every page to see a complete history of edits for that topic.
9. **Attach files:** Use your browser to upload and attach any type of file to a topic using the <code>**Attach**</code> link at the bottom of the page.
10. **Organize:** Use [[TWikiForms]] to include specific information wiht individual topics - for example, classify pages by subject, status, or date.
11. **Learn more**: [[TWikiTutorial]] takes you on a 20-minute tour of the TWiki essentials. [[WikiReferences]] has links to articles and books about online collaboration and Wiki technology in particular.

**Main Features of TWiki**

* Edit existing pages or create new pages by using any Web browser.
* Web pages are automatically linked. You do not need to learn HTML commands to link pages.
* Very simple text formatting. Basically, you write a page the same way you would write an email.
* Fast, full-text search with or without regular expressions.
* All changes to pages and attachments are under revision control. Find out who changed what and when.
* Fine-grained access control based on users and groups.
* Automatic email notification when pages change.
* File attachments: Upload and download any file as an attachment to a page, using your browser. This is similar to email file attachments, but it happens on web pages.
* Topic locking: Users are warned if a page is being edited by another person, to avoid simultaneous page editing.
* Templates and skins: Customize every possible aspect of the look and feel of each TWiki installation, down to the individual page level.
* Plugins: A growing collection of plugins allows you to easily add optional extended functions, or to create your own.
* Support: An active, helpful development community keeps TWiki support and development constantly moving forward.
* **_Read more_** about the TWiki at <http://TWiki.org/> .

**Starting Points in the %WIKITOOLNAME%.%WEB% web**

* **[[TWikiTutorial]]**: Familiarize yourself with TWiki before you start editing content.
* %HOMETOPIC%: Entry point of this %WIKITOOLNAME% web.
* [[TWikiSite]]: Explains what a TWiki site is.
* [[GoodStyle]]: Things to consider when changing text.
* [[WikiSyntax]]: Easy to learn rules when editing text.
* [[WebChanges]]: Recent changes to the %WIKITOOLNAME%.%WEB% web.
* [[TWikiRegistration]]: **Before you leave**, add your name here.

%INCLUDE\{"TWikiWebsTable"\}%