-This is a short, step-by-step tutorial to get you up to speed on %WIKITOOLNAME%.
-
-- Preparation:
- - Open up a new browser window. While you are working in one window, you can look at the step-by-step tutorial instructions in the other window.
-
-- Navigation and search:
- - %WIKITOOLNAME% is divided up into webs; each one represents one area of collaboration. The webs are accessible at the upper right corner of each web page.
- - Each web has hyper-linked topics. A topic is one web page in your browser.
- - The home page in each web is the [[WebHome]] topic.
- - To browse a %WIKITOOLNAME% web, just click on any highlighted link. These links are called [[WikiWords]] and comprise two or more words with initial capitals, run together.
- - Follow the [[WikiWord]] link and learn what it is.
- - If you know the name of a topic, you can jump directly to it by typing its name into the **Go** field on the top of the page. Type `WebSearch` to jump to the search page. **_Hint:_** Do not confuse the **Go** field with search.
- - You can search each %WIKITOOLNAME% web. Enter a search string in the [[WebHome]] topic or the [[WebSearch]] topic accessible from the `Search` link on each topic. %WIKITOOLNAME% searches for an exact match; optionally, you can also use [[RegularExpressions]].
-
-- Create your account:
- - To edit topics, you need to have a %WIKITOOLNAME% account.
- - Go to the [[TWikiRegistration]] page to create your %WIKITOOLNAME% account.
-
-- %WIKITOOLNAME% Users and offices:
- - Go to the [[TWikiUsers]] topic in the %WIKITOOLNAME%.Main web; it has a list of all users of %WIKITOOLNAME%. Your [[WikiName]] will be in this list after you register.
- - Go to the [[OfficeLocations]] topic in the %WIKITOOLNAME%.Main web; it has a list of corporate offices already entered into %WIKITOOLNAME%.
-
-- Operations on topics:
- - Go to the [[WebHome]] topic to learn what we can do with a topic.
- - The bottom of the page has some links:
- - `Edit` : Allows you to edit the topic (discussed later)
- - `Ref-By` : Find out what other topics link to this topic (reverse link)
- - `Attach` : Attach files to a topic (discussed later)
- - `Diffs` : Topics are under revision control. Diffs shows you the complete change history of the topic, e.g. who changed what and when.
- - `r1.3 | > | r1.2 | > | r1.1` : Allows you to see a previous topic revision or the difference between revisions.
-
-- Editing a topic and creating hyperlinked pages:
- - Go to the [[Test|Test/WebHome]] topic of the %WIKITOOLNAME%.Test web. This web is the sandbox where you can make changes at will.
- - Press the `Edit` link. You are now in edit mode and you can see the source of the page. (Go to a different topic like [[TestTopic3]] in case you see a "Topic is locked by an other user" warning.)
- - Look at the text in edit mode and compare it with the rendered page (move back and forth in your browser.)
- - Notice how [[WikiWords]] are linked automatically; there is no link if you look at the text in edit mode.
- - Now let's create a new topic, your own sandbox topic:
- - In edit mode, enter a new text with a [[WikiWord]], i.e. <br />`This is PaulsSandBox topic.`
- - Preview and save the topic.
- - You can see a linked question mark after the topic name. This means that the topic does not exist yet.
- - Click on the question mark. Now you are in edit mode of the new topic.
- - Type some text, basically like you write an email.
- - A signature with your name is already entered by default. **_Note:_** Please note the `Main.` in front of your name. This means that you have a link from the current web to your personal topic located in the Main web.
- - Preview and save the topic.
- - Learn about text formatting:
- - You write text in [[WikiSyntax]], a very simple markup language. Follow the [[WikiSyntax]] link and learn how to write text.
- - Go back to your sandbox topic end edit it.
- - Enter some text in [[WikiSyntax]]: **bold** text, _italic_ text, **_bold italic_** text, a bullet list, tables, paragraphs, etc. **_Hint:_** If you need to look up the [[WikiSyntax]], click on the [[TextFormattingRules]] link located below the edit field.
- - Preview and save the topic.
-
-- Attaching files to a topic:
- - You can attach any file to a topic, not unlike attachments to an email.
- - Go back to your sandbox topic and click on the `Attach` link at the bottom.
- - Browse for any file you would like to attach; enter an optional comment.
- - Upload and attach the file.
- - Do this again with a JPG or GIF image file.
- - Checkmark the box "Create a link to the attached file at the end of the topic."
- - Upload and attach the image file.
- - The image will show up at the bottom of the topic. To move the image, you can edit the topic and move the last line (starting with `<a href="%ATTACHURLPATH%/...`) to anywhere you like.
- - If you have a GIF or JPG image of yourself, why not upload it now to your personal topic?
-
-- Getting notified of topic changes:
- - It is very important that team members are kept in sync of changes.
- - [[WebNotify]] (one per %WIKITOOLNAME% web) is a subscription service to be automatically notified by email when topics change in a %WIKITOOLNAME% web. This is a convenient service, so you do not have to come back and check all the time to see if something has changed.
- - It is strongly recommended that you subscribe to the %WIKITOOLNAME% web(s) relevant to your work.
-
-This concludes the tutorial. Now you are ready to roll.
-
-**_A side note:_** Initially it can be daunting to modify text someone else wrote. Please do not worry, nothing gets lost, because previous versions are always accessible (and also recoverable by the %WIKITOOLNAME% administrator if needed.)
-
--- [[PeterThoeny]] - 28 Dec 2000 <br />
+<div>
+ <ul>
+ <li><a href="#20 Minute TWiki"> 20 Minute TWiki</a><ul>
+ <li><a href="#1. Get set:"> 1. Get set:</a></li>
+ <li><a href="#2. Take a tour around:"> 2. Take a tour around:</a></li>
+ <li><a href="#3. Open a private account page:"> 3. Open a private account page:</a></li>
+ <li><a href="#4. Check out %WIKITOOLNAME% User"> 4. Check out %WIKITOOLNAME% Users and offices:</a></li>
+ <li><a href="#5. Test the Topic controls:"> 5. Test the Topic controls:</a></li>
+ <li><a href="#6. Change a page and create a ne"> 6. Change a page and create a new one:</a></li>
+ <li><a href="#7. Upload files as page Attachme"> 7. Upload files as page Attachments:</a></li>
+ <li><a href="#8. Get email alerts when topics"> 8. Get email alerts when topics change:</a></li>
+ </ul>
+ </li>
+ </ul>
+</div>
+
+## <a name="20 Minute TWiki"></a> 20 Minute TWiki
+
+This step-by-step, hands-on tutorial gets you up to speed with all the %WIKITOOLNAME% basics in mere minutes...
+
+### <a name="1. Get set:"></a> 1. Get set:
+
+- Open two browser windows; arrange them so that you can follow these steps in one window, while trying things out in the other.
+
+### <a name="2. Take a tour around:"></a> 2. Take a tour around:
+
+- %WIKITOOLNAME% is divided up into webs; each one represents one area of collaboration. The webs are accessible at the upper right corner of each web page.
+- Each web has hyper-linked topics. A topic is one web page in your browser.
+- The home page in each web is the [[WebHome]] topic.
+- To browse a %WIKITOOLNAME% web, just click on any highlighted link. These links are called [[WikiWords]] and comprise two or more words with initial capitals, run together.
+- Follow the [[WikiWord]] link and learn what it is.
+- If you know the name of a topic, you can jump directly to it by typing its name into the **Go** field on the top of the page. Type `WebSearch` to jump to the search page. **_Hint:_** Do not confuse the **Go** field with search.
+- You can search each %WIKITOOLNAME% web. Enter a search string in the [[WebHome]] topic or the [[WebSearch]] topic accessible from the `Search` link on each topic. %WIKITOOLNAME% searches for an exact match; optionally, you can also use [[RegularExpressions]].
+
+### <a name="3. Open a private account page:"></a> 3. Open a private account page:
+
+- To edit topics, you need to have a %WIKITOOLNAME% account.
+- Go to the [[TWikiRegistration]] page to create your %WIKITOOLNAME% account.
+
+### <a name="4. Check out %WIKITOOLNAME% User"></a> 4. Check out %WIKITOOLNAME% Users and offices:
+
+- Go to the [[TWikiUsers]] topic in the %WIKITOOLNAME%.Main web; it has a list of all users of %WIKITOOLNAME%. Your [[WikiName]] will be in this list after you register.
+- Go to the [[OfficeLocations]] topic in the %WIKITOOLNAME%.Main web; it has a list of corporate offices already entered into %WIKITOOLNAME%.
+
+### <a name="5. Test the Topic controls:"></a> 5. Test the Topic controls:
+
+- Go to the [[WebHome]] topic to learn what we can do with a topic.
+- The bottom of the page has some links:
+- `Edit` : Allows you to edit the topic (discussed later)
+- `Ref-By` : Find out what other topics link to this topic (reverse link)
+- `Attach` : Attach files to a topic (discussed later)
+- `Diffs` : Topics are under revision control. Diffs shows you the complete change history of the topic, e.g. who changed what and when.
+- `r1.3 | > | r1.2 | > | r1.1` : Allows you to see a previous topic revision or the difference between revisions.
+
+### <a name="6. Change a page and create a ne"></a> 6. Change a page and create a new one:
+
+- Go to the [[Test|Test/WebHome]] topic of the %WIKITOOLNAME%.Test web. This web is the sandbox where you can make changes at will.
+- Press the `Edit` link. You are now in edit mode and you can see the source of the page. (Go to a different topic like [[TestTopic3]] in case you see a "Topic is locked by an other user" warning.)
+- Look at the text in edit mode and compare it with the rendered page (move back and forth in your browser.)
+- Notice how [[WikiWords]] are linked automatically; there is no link if you look at the text in edit mode.
+- Now let's create a new topic, your own sandbox topic:
+ - In edit mode, enter a new text with a [[WikiWord]], i.e. <br />
+ - `This is PaulsSandBox topic.`
+ - Preview and save the topic.
+ - You can see a linked question mark after the topic name. This means that the topic does not exist yet.
+ - Click on the question mark. Now you are in edit mode of the new topic.
+ - Type some text, basically like you write an email.
+ - A signature with your name is already entered by default. **_Note:_** Please note the `Main.` in front of your name. This means that you have a link from the current web to your personal topic located in the Main web.
+ - Preview and save the topic.
+- Learn about text formatting:
+ - You write text in [[WikiSyntax]], a very simple markup language. Follow the [[WikiSyntax]] link and learn how to write text.
+ - Go back to your sandbox topic end edit it.
+ - Enter some text in [[WikiSyntax]]: **bold** text, _italic_ text, **_bold italic_** text, a bullet list, tables, paragraphs, etc. **_Hint:_** If you need to look up the [[WikiSyntax]], click on the [[TextFormattingRules]] link located below the edit field.
+ - Preview and save the topic.
+
+### <a name="7. Upload files as page Attachme"></a> 7. Upload files as page Attachments:
+
+- You can attach any file to a topic, not unlike attachments to an email.
+- Go back to your sandbox topic and click on the `Attach` link at the bottom.
+- Browse for any file you would like to attach; enter an optional comment.
+- Upload and attach the file.
+- Do this again with a JPG or GIF image file.
+- Checkmark the box "Create a link to the attached file at the end of the topic."
+- Upload and attach the image file.
+- The image will show up at the bottom of the topic. To move the image, you can edit the topic and move the last line (starting with `<a href="%ATTACHURLPATH%/...`) to anywhere you like.
+- If you have a GIF or JPG image of yourself, why not upload it now to your personal topic?
+
+### <a name="8. Get email alerts when topics"></a><a name="8. Get email alerts when topics "></a> 8. Get email alerts when topics change:
+
+- It is very important that team members are kept in sync of changes.
+- [[WebNotify]] (one per %WIKITOOLNAME% web) is a subscription service to be automatically notified by email when topics change in a %WIKITOOLNAME% web. This is a convenient service, so you do not have to come back and check all the time to see if something has changed.
+- It is strongly recommended that you subscribe to the %WIKITOOLNAME% web(s) relevant to your work.
+
+That's it! You're now equipped with all the TWiki essentials. You are ready to roll.
+
+**_A side note:_** Initially, it can be daunting to modify text someone else wrote. Please do not worry, nothing gets lost, because previous versions are always accessible (and also recoverable by the %WIKITOOLNAME% administrator if needed.)
+
+-- [[PeterThoeny]] - 28 Dec 2000 <br /> -- [[MikeMannix]] - 29 Aug 2001
git://git.openafs.org / openafs-wiki.git / commitdiff