TWiki/TWikiTutorial.mdwn

   1 <div>
   2   <ul>
   3     <li><a href="#20-Minute TWiki Tutorial"> 20-Minute TWiki Tutorial</a><ul>
   4         <li><a href="#1. Get set..."> 1. Get set...</a></li>
   5         <li><a href="#2. Take a quick tour..."> 2. Take a quick tour...</a></li>
   6         <li><a href="#3. Open a private account..."> 3. Open a private account...</a></li>
   7         <li><a href="#4. Check out TWiki users, groups"> 4. Check out TWiki users, groups.</a></li>
   8         <li><a href="#5. Test the page controls..."> 5. Test the page controls...</a></li>
   9         <li><a href="#6. Change a page, and create a n"> 6. Change a page, and create a new one...</a></li>
  10         <li><a href="#7. Use your browser to upload fi"> 7. Use your browser to upload files as page attachments...</a></li>
  11         <li><a href="#8. Get e-mail alerts whenever pa"> 8. Get e-mail alerts whenever pages are changed...</a></li>
  12       </ul>
  13     </li>
  14   </ul>
  15 </div>
  16
  17 # <a name="20-Minute TWiki Tutorial"></a> 20-Minute TWiki Tutorial
  18
  19 This step-by-step, hands-on tutorial gets you up to speed with all the [[TWikiSite]] basics, in _mere minutes_...
  20
  21 > ## <a name="1. Get set..."></a> 1. Get set...
  22 >
  23 > Open two browser windows, so that you can follow these steps in one window, while trying things out in the other.
  24 >
  25 > ## <a name="2. Take a quick tour..."></a> 2. Take a quick tour...
  26 >
  27 > A
  28 >
  29 > [[TWikiSite]]
  30 >
  31 > is divided into webs; each one usually represents one area of collaboration. You can navigate the webs from the upper right corner of each web page.
  32 >
  33 > - Each web has hyperlinked topics, displayed as pages in your browser.
  34 > - The home page in each web is the [[WebHome]] topic.
  35 > - To browse a TWiki web, just click on any highlighted link. These links are called [[WikiWords]] and comprise two or more words with initial capitals, run together.
  36 > - Follow the [[WikiWord]] link and learn what it is.
  37 > - 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.
  38 > - You can search each TWiki web. Enter a search string in the [[WebHome]] topic or the [[WebSearch]] topic accessible from the `Search` link on each topic. TWiki searches for an exact match; optionally, you can also use [[RegularExpressions]].
  39 >
  40 > ## <a name="3. Open a private account..."></a> 3. Open a private account...
  41 >
  42 > To edit topics, you need to have a TWiki account.
  43 >
  44 > - Go to the [[TWikiRegistration]] page to create your TWiki account. Fill in a couple of lines and you're set!
  45 >
  46 > ## <a name="4. Check out TWiki users, groups"></a> 4. Check out TWiki users, groups.
  47 >
  48 > - Go to the [[TWikiUsers]] topic in the TWiki.Main web; it has a list of all users of TWiki. Your [[WikiName]] will be in this list after you register.
  49 > - Go to the [[TWikiGroups]] topic in the Main web; it has a list of groups which can be used to define fine grained [[TWikiAccessControl]] in TWiki.
  50 >
  51 > ## <a name="5. Test the page controls..."></a> 5. Test the page controls...
  52 >
  53 > The color-coded control strips at the top and/or bottom of the page has a collection of action links. Different skins show different links, but most will have some or all of::
  54 >
  55 > - <code>**Edit**</code> - add to or edit the topic (discussed later)
  56 > - <code>**Raw View**</code> - show the source text without editing the topic
  57 > - <code>**Attach**</code> - attach files to a topic (discussed later)
  58 > - <code>**Backlinks**</code> - find out what other topics link to this topic (reverse link)
  59 > - <code>**Printable**</code> - goes to a stripped down version of the page, good for printing
  60 > - <code>**History**</code> - topics are under revision control - `History` shows you the complete change history of the topic, for example, who changed what and when
  61 > - <code>**r3 &gt; r2 &gt; r1**</code> - view a previous version of the topic or the difference between two versions
  62 > - <code>**More**</code> - additional controls, such as rename/move, version control and setting the topic's parent.
  63 >
  64 > ## <a name="6. Change a page, and create a n"></a> 6. Change a page, and create a new one...
  65 >
  66 > Go to the
  67 >
  68 > [[Sandbox|Sandbox/WebHome]]
  69 >
  70 > . This is the sandbox web, where you can make changes and try it all out at will.
  71 >
  72 > - Click the <code>**Edit**</code> link. You are now in edit mode and you can see the source of the page. (Go to a different topic like Sandbox.adminSandbox if you see a "Topic is being edited by an other user" warning.)
  73 > - Look at the text in edit mode and compare it with the rendered page (move back and forth in your browser.)
  74 > - **_%T% Tip:_** When you only want to see the source code of a topic click the <code>**Raw View**</code> link.
  75 > - Notice how [[WikiWords]] are linked automatically; there is no link if you look at the text in edit mode.
  76 > - Now, create a new topic - your own test page:
  77 >   1. In edit mode, enter a new text with a [[WikiWord]], for example: <br />`This is adminSandbox topic.`
  78 >   2. Preview and save the topic. The name appears, highlighted, with a linked question mark at the end. This means that the topic doesn't exist yet.
  79 >   3. Click on the question mark. Now you're in edit mode of the new topic.
  80 >   4. Type some text, basically, like you write an e-mail.
  81 >   5. A signature with your name is already entered by default. **_NOTE:_** The `Main.` in front of your name means that you have a link from the current web to your personal topic located in the Main web.
  82 >   6. Preview and save the topic...
  83 > - Learn about text formatting. You can enter text in TWikiShorthand, a very simple markup language. Follow the [[TWikiShorthand]] link to see how, then:
  84 >   1. Go back to your sandbox topic end edit it.
  85 >   2. Enter some text in [[TWikiShorthand]]: **bold** text, _italic_ text, **_bold italic_** text, a bullet list, tables, paragraphs, etc. **_Hint:_** If you need help, click on the [[TextFormattingRules]] link located below the text box in edit mode.
  86 >   3. Preview and save the topic.
  87 >
  88 > ## <a name="7. Use your browser to upload fi"></a> 7. Use your browser to upload files as page attachments...
  89 >
  90 > You can attach
  91 >
  92 > _any_
  93 >
  94 > type of file to a topic - documents, images, programs, whatever - where they can be opened, viewed, or downloaded.
  95 >
  96 > - Attaching files is just like including a file with an e-mail.
  97 >   1. Go back to your sandbox topic and click on the <code>**[Attach]**</code> link at the bottom.
  98 >   2. Click <code>**[Browse]**</code> to find a file on your PC that you'd like to attach; enter an optional comment; leave everything else unchecked.
  99 >   3. Click <code>**[Upload file]**</code>, then scroll to the end of the page to see the new attachment listing.
 100 > - Do this again - this time, upload a GIF, JPG or PNG image file.
 101 >   - Check the <code>**[Link:]**</code> box to _Create a link to the attached file at the end of the topic_. The image will show up at the bottom of the topic.
 102 >   - To move the image, edit the topic and place the last line (containing `%ATTACHURL%`) anywhere on the page.
 103 > - If you have a GIF, JPG or PNG image of yourself, your cat, your sprawling family estate...why not upload it now to personalize your account page Main.admin?
 104 >
 105 > ## <a name="8. Get e-mail alerts whenever pa"></a> 8. Get e-mail alerts whenever pages are changed...
 106 >
 107 > [[WebNotify]]
 108 >
 109 > is a subscription service that automatically notifies you by e-mail when topics change in a TWiki web. This is a convenience service - for many people, checking e-mail is easier than checking the Web.
 110 >
 111 > - If you're using TWiki to collaborate on a project, it's important to know when anyone on your team posts an update. If you're following a specific discussion, it's convenient to know when there's new input.
 112 > - Alerts are e-mailed as links to individual topics that've been changed in a set period: each day, every hour, whatever is configured for your system.
 113 > - It's strongly recommended that you try out the service by subscribing to each TWiki web that's relevant to you. You can subscribe and unsubscribe instantly, on a per web basis using [[WebNotify]].
 114
 115 That's it! You're now equipped with all the TWiki essentials. You are ready to roll.
 116
 117 **_NOTE:_** When first using TWiki, it will probably seem strange to be able to change other people's postings - we're used to _separating_ individual messages, with e-mail, message boards, non-Wiki collaboration platforms. **_Don't worry about it._** You can't accidentally delete important stuff - you can always check previous versions, and copy-and-paste from them if you want to undo any changes. After a short while, TWiki-style free-form communication becomes second-nature. You'll expect it everywhere!
 118
 119 **_Related Topics:_** [[UserDocumentationCategory]]