-Welcome,
+# <a name="Welcome, Main.admin!"></a><a name=" Welcome, Main.admin!"></a> Welcome, Main.admin!
-you have reached the TWiki web (pronounced twee-kee web). %WIKITOOLNAME% is a meeting place to collaborate on common interests. Everybody can contribute by just using a web browser. It looks like a normal web site, but then... **_everybody can edit web pages_**.
+Welcome to %WIKITOOLNAME%! This is a [[TWikiSite]] (pronounced _twee-kee site_), a meeting place to work on common interests. Anyone can contribute using any web browser. %WIKITOOLNAME% looks like a normal web site... except that it encourages contribution and **editing** of pages, questions, answers, comments and updates.
-**Main Features of %WIKITOOLNAME%**
+"Wiki" systems are fundamentally editable web pages. It's a fun and useful way of communicating asynchronously over the web for many existing intranet and public Internet sites. TWiki is simple to learn and use. It aims to provide a transparent way for you to publish and exchange your ideas with others over the web.
-- 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 web page like you would write an email.
-- Full text search with/without regular expressions.
-- All changes to pages are under revision control. Find out who changed what and when.
-- Automatic email notification when web pages change.
-- File attachments: Upload and download any file as an attachment to a page by 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 an other person. This is to prevent contention, e.g. simultaneous page editing.
+<div>
+ <ul>
+ <li><a href="#What's in a TWiki?"> What's in a TWiki?</a></li>
+ <li><a href="#Some things to do"> Some things to do</a></li>
+ <li><a href="#Some basics"> Some basics</a><ul>
+ <li><a href="#Editing a page:"> Editing a page:</a></li>
+ <li><a href="#Creating a page"> Creating a page</a></li>
+ <li><a href="#Viewing the history of a topic"> Viewing the history of a topic</a></li>
+ <li><a href="#Attaching files"> Attaching files</a></li>
+ </ul>
+ </li>
+ </ul>
+</div>
-**How %WIKITOOLNAME% Works**
+## <a name="What's in a TWiki?"></a> What's in a TWiki?
-%WIKITOOLNAME% is divided up into **webs** , each one represents one area of collaboration.
+- **Webs:** A [[TWikiSite]] is divided into webs, each one represents an area for collaboration. This site has the following webs:
+- **Topics:** Each web is made up of hyperlinked [[topics|Main/TWikiTopics]] that appear in your browser.
-Each web has hyper-linked topics. A **topic** is one web page in your browser.
+## <a name="Some things to do"></a> Some things to do
-To browse this %WIKITOOLNAME% site, just click on any highlighted link. These links are called [[WikiWords]], and comprise two or more words with initial capitals, run together.
+- **Browse.** This is a site like other sites. Read and follow interesting links.
+- **Write.** Speak your mind! From your browser you can change or add to anything you see in a TWiki topic. Use regular text or [[TWikiShorthand]].
+- **Experiment.** Edit your personal page or visit the [[Sandbox|Sandbox/WebHome]] web.
+- **Organize.** You can learn to use [[TWikiForms]] and [[FormattedSearch]]es to include topic information - for example, classify pages by subject, status, or date.
+- **Learn more.** Some good places to start:
+ - [[TWikiTutorial]] is a 20-minute tour of TWiki essentials.
+ - [[ATasteOfTWiki]] is a short introduction training course for beginners.
+ - [[WikiReferences]] links to selected articles and books about wiki technology and online collaboration.
+ - [[WikiSyntax]] - simple syntax for edits
+ - [[GoodStyle]] - recommendations for edits
-To edit any topic, click on "Edit" at the bottom of the topic. You can edit the topic from within your browser, using [[WikiSyntax]], a very simple markup language. You could also use HTML if you wish, but this is optional. (Before you can edit pages you need to register in [[TWikiRegistration]].)
+## <a name="Some basics"></a> Some basics
-A highlighted "?" following a [[WikiTopic]] means that no content has yet been entered for that topic. You are invited to add some content by clicking on the "?". You are encouraged to include [[WikiWords]] in your content, for others to fill out later.
+### <a name="Editing a page:"></a> Editing a page:
-Please follow the [[TWikiTutorial]] to get you up to speed on TWiki. You can use the [%WIKITOOLNAME%.Test](../Test/WebHome) web for testing.
+- click <code>**Edit**</code> at the bottom of any topic and make your changes
+- click <code>**[ Preview Changes ]**</code> at the bottom to verify the topic (use your brower's <code>**Back**</code> button if necessary)
+- click <code>**[ Save Changes ]**</code> You've now edited the topic!
-**Starting points in the %WIKITOOLNAME%.%WEB% web**
+### <a name="Creating a page"></a> Creating a page
-- ** [[TWikiTutorial]] **: Familiarize yourself with %WIKITOOLNAME% before you start editing content.
-- [[WebHome]]: Entry point of this %WIKITOOLNAME% web.
-- [[TWikiWeb]]: Explains what a %WIKITOOLNAME% web 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.
+See a question mark link "<u>?</u>" behind a WikiWord? That means that there's no topic yet for that [[TWikiWord]]. If you want to create a topic for that WikiWord, just click on the question mark. The topic will be created and you will be in the editor window.
+
+### <a name="Viewing the history of a topic"></a> Viewing the history of a topic
+
+Click <code>**History**</code> at the bottom of a topic
+
+### <a name="Attaching files"></a> Attaching files
+
+Click <code>**Attach**</code> to upload and attach any type of file.
git://git.openafs.org / openafs-wiki.git / blobdiff