Difference: TWikiTutorial (1 vs. 21)

Revision 212012-03-29 - TWikiContributor

Line: 1 to 1
 

20-Minute TWiki Tutorial

Line: 41 to 41
 
  • Print version - goes to a stripped down version of the page, good for printing
  • History - topics are under revision control - History shows you the complete change history of the topic, for example, who changed what and when
  • r3 > r2 > r1 - view a previous version of the topic or the difference between two versions
Changed:
<
<
  • More topic actions - additional controls, such as rename/move, version control and setting the topic's parent.
>
>
  • More topic actions - additional controls, such as rename/move, version control, and setting the topic's parent.
 

6. Create a topic, modify a topic, and link to a topic...

Line: 52 to 52
 
    1. In edit mode, enter a new text with a WikiWord, for example:
      This is TWikiGuestSandbox topic.
    2. Save the topic. The name appears highlighted with a red-link. This means that the topic doesn't exist yet.
Changed:
<
<
    1. Click on the red-link. Now you're in edit mode of the new topic.
    2. Type some text. You can add headings, bullets, tables and more, use the controls of the WYSIWYG editor.
>
>
    1. Click on the red-link. Now you're in edit mode for the new topic.
    2. Type some text. You can add headings, bullets, tables and more using the controls of the WYSIWYG editor.
 
    1. A signature with your name is already entered by default. Keep it at the bottom.
      Note: The Main. in front of your name is a web prefix. It means that you have a link from the current web to your personal topic located in the Main web.
    2. Save the topic...
Line: 65 to 65
 
    1. You can also create a nice looking link without a BumpyWord. Enter for example:
      [[WebSearch][This is a link to search]].
  • Learn about Raw Edit (for advanced/technical users)
Changed:
<
<
    1. Topics can be modified in WYSIWYG mode (default) and in Raw Edit mode. The raw mode shows text in TWikiShorthand, a very simple markup language. Follow the TWikiShorthand link to see how, then:
>
>
    1. Topics can be modified in WYSIWYG mode (default) and in Raw Edit mode. Raw mode shows text in TWikiShorthand, a very simple markup language. Follow the TWikiShorthand link to see how, then:
 
    1. Go back to your own sandbox topic and Raw Edit it.
    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 Edit help link located above the text edit box.
Line: 79 to 79
 
    1. Go back to your sandbox topic and click on Attach.
    2. Click [Browse] to find a file on your machine that you'd like to attach; enter an optional comment; leave everything else unchecked.
    3. Click [Upload file], then scroll to the end of the page to see the new attachment listing.
Changed:
<
<
  • Do this again - this time, upload a .gif, .png or .jpg image file.
>
>
  • Do this again - this time, upload a .gif, .png, or .jpg image file.
 
    • Check the Link 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.
    • Edit the topic to move/resize the image.
  • If you have an image of yourself, your cat, your sprawling family estate...why not upload it now to personalize your TWiki profile page TWikiGuest?

Revision 202011-07-29 - TWikiContributor

Line: 1 to 1
 

20-Minute TWiki Tutorial

Line: 27 to 27
 

4. Check out TWiki users & groups...

Changed:
<
<
  • Go to the TWikiUsers topic; it has a list of all users of TWiki. Your WikiName will be in this list after you register.
>
>
  • Go to the UserList topic; it has a list of all users of TWiki. Your name will be in this list after you register.
 

5. Learn the page controls...

Line: 82 to 82
 
  • Do this again - this time, upload a .gif, .png or .jpg image file.
    • Check the Link 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.
    • Edit the topic to move/resize the image.
Changed:
<
<
  • If you have an image of yourself, your cat, your sprawling family estate...why not upload it now to personalize your TWiki homepage TWikiGuest?
>
>
  • If you have an image of yourself, your cat, your sprawling family estate...why not upload it now to personalize your TWiki profile page TWikiGuest?
 

8. Get alerted whenever topics are changed...

Revision 192011-03-02 - TWikiContributor

Line: 1 to 1
 

20-Minute TWiki Tutorial

Line: 90 to 90
 
  • 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.
  • Alerts are e-mailed as links to individual topics that have been changed in a set period: Each day, every hour, whatever is configured for your system.
  • 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.
Changed:
<
<
  • If you prefer, you can subscrive to RSS and ATOM feeds. Every web has a WebRss feed and a WebAtom feed, respectively.
>
>
  • If you prefer, you can subscribe to RSS and ATOM feeds. Every web has a WebRss feed and a WebAtom feed, respectively.
  That's it! You're now equipped with all the TWiki essentials. You are ready to roll.

Revision 182010-05-19 - TWikiContributor

Line: 1 to 1
 

20-Minute TWiki Tutorial

Line: 7 to 7
 

1. Get set...

Added:
>
>
 Open two browser windows, so that you can follow these steps in one window, while trying things out in the other.

2. Take a quick tour...

Changed:
<
<
A TWikiSite 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.
>
>
A TWikiSite is divided into webs; each one usually represents one workspace for collaboration. You can navigate the webs from the Home menu of each web page.
 
  • Each web has hyperlinked topics, displayed as pages in your browser.
  • The home page in each web is the WebHome topic.
  • 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.
  • Follow the WikiWord link and learn what it is.
Changed:
<
<
  • 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 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.
>
>
  • If you know the name of a topic, you can jump directly to it by typing its name into the JumpBox on the top of the page. Type WebNotify to jump to the WebNotify topic. Hint: Do not confuse the Jump box with search.
  • You can search each TWiki web. Enter a search string in the WebHome topic or the WebSearch topic accessible from the Search link in the Web menu. TWiki searches for an exact match; optionally, you can also use RegularExpressions.

3. Create an account...

 
Changed:
<
<

3. Open a private account...

To edit topics, you need to have a TWiki account.
>
>
To edit topics or participate in restricted webs, you need to have a TWiki account.
 
  • Go to the TWikiRegistration page to create your TWiki account. Fill in a couple of lines and you're set!
Changed:
<
<

4. Check out TWiki users, groups.

>
>

4. Check out TWiki users & groups...

 
  • Go to the TWikiUsers topic; it has a list of all users of TWiki. Your WikiName will be in this list after you register.
  • 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.
Changed:
<
<

5. Test the page controls...

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::
>
>

5. Learn the page controls...

The buttons at the top and the color-coded control strip at the bottom of the page have a collection of action links. Different skins show different links, but most will have some or all of:

 
  • Edit - add to or edit the topic (discussed later)
Added:
>
>
  • Raw Edit - edit the topic using WikiSyntax (discussed later)
 
  • Raw View - show the source text without editing the topic
  • Attach - attach files to a topic (discussed later)
  • Backlinks - find out what other topics link to this topic (reverse link)
Changed:
<
<
  • Printable - goes to a stripped down version of the page, good for printing
>
>
  • Print version - goes to a stripped down version of the page, good for printing
 
  • History - topics are under revision control - History shows you the complete change history of the topic, for example, who changed what and when
  • r3 > r2 > r1 - view a previous version of the topic or the difference between two versions
Changed:
<
<
  • More - additional controls, such as rename/move, version control and setting the topic's parent.
>
>
  • More topic actions - additional controls, such as rename/move, version control and setting the topic's parent.
 
Changed:
<
<

6. Change a page, and create a new one...

Go to the Sandbox. This is the sandbox web, where you can make changes and try it all out at will.
  • Click the Edit link. You are now in edit mode and you can see the source of the page. (Go to a different topic like TWikiGuestSandbox if you see a "Topic is being edited 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.)
  • TIP Tip: When you only want to see the source code of a topic click the Raw View link.
  • Notice how WikiWords are linked automatically; there is no link if you look at the text in edit mode.
  • Now, create a new topic - your own test page:
    1. In edit mode, enter a new text with a WikiWord, for example:
>
>

6. Create a topic, modify a topic, and link to a topic...

Go to the Sandbox. This is the sandbox web, where you can create topics and add content to try it all out at will.

  • To create your own test topic, click on Create TestTopic###, or invent a WikiWord and click on Create by Name. You are now in edit mode where you can add content to the new topic. Save the topic and voilà, you just created your first TWiki page!
  • Click on Edit to modify your own test topic again (or any other topic for that matter).
  • Now, let's create a new topic starting from your own test topic:
    1. In edit mode, enter a new text with a WikiWord, for example:
  This is TWikiGuestSandbox topic.
Changed:
<
<
    1. 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.
    2. Click on the question mark. Now you're in edit mode of the new topic.
    3. Type some text, basically, like you write an e-mail.
    4. 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.
    5. Preview and save the topic...
  • Learn about text formatting. You can enter text in TWikiShorthand, a very simple markup language. Follow the TWikiShorthand link to see how, then:
    1. Go back to your sandbox topic end edit it.
    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.
    3. Preview and save the topic.
>
>
    1. Save the topic. The name appears highlighted with a red-link. This means that the topic doesn't exist yet.
    2. Click on the red-link. Now you're in edit mode of the new topic.
    3. Type some text. You can add headings, bullets, tables and more, use the controls of the WYSIWYG editor.
    4. A signature with your name is already entered by default. Keep it at the bottom.
      Note: The Main. in front of your name is a web prefix. It means that you have a link from the current web to your personal topic located in the Main web.
    5. Save the topic...
  • Link to another topic:
    1. In edit mode, enter the WikiWord of a topic that already exists in the Sandbox web, for example:
      This links to WebSearch.
    2. Save the topic. WebSearch is now a link you can click.
      Note: WikiWords are linked automatically; there is no link if you look at the text in edit mode.
    3. You can also create a nice looking link without a BumpyWord. Enter for example:
      [[WebSearch][This is a link to search]].
  • Learn about Raw Edit (for advanced/technical users)
    1. Topics can be modified in WYSIWYG mode (default) and in Raw Edit mode. The raw mode shows text in TWikiShorthand, a very simple markup language. Follow the TWikiShorthand link to see how, then:
    2. Go back to your own sandbox topic and Raw Edit it.
    3. 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 Edit help link located above the text edit box.
    4. Save the topic.
  • TIP Tip: When you only want to see the source code of a topic click the Raw View link.
 

7. Use your browser to upload files as page attachments...

Added:
>
>
 You can attach any type of file to a topic - documents, images, programs, whatever - where they can be opened, viewed, or downloaded.
  • Attaching files is just like including a file with an e-mail.
Changed:
<
<
    1. Go back to your sandbox topic and click on the [Attach] link at the bottom.
    2. Click [Browse] to find a file on your PC that you'd like to attach; enter an optional comment; leave everything else unchecked.
>
>
    1. Go back to your sandbox topic and click on Attach.
    2. Click [Browse] to find a file on your machine that you'd like to attach; enter an optional comment; leave everything else unchecked.
 
    1. Click [Upload file], then scroll to the end of the page to see the new attachment listing.
Changed:
<
<
  • Do this again - this time, upload a GIF, JPG or PNG image file.
    • Check the [Link:] 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.
    • To move the image, edit the topic and place the last line (containing %ATTACHURL%) anywhere on the page.
  • 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 TWikiGuest?
>
>
  • Do this again - this time, upload a .gif, .png or .jpg image file.
    • Check the Link 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.
    • Edit the topic to move/resize the image.
  • If you have an image of yourself, your cat, your sprawling family estate...why not upload it now to personalize your TWiki homepage TWikiGuest?

8. Get alerted whenever topics are changed...

 
Deleted:
<
<

8. Get e-mail alerts whenever pages are changed...

 WebNotify 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.
  • 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.
Changed:
<
<
  • 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.
>
>
  • Alerts are e-mailed as links to individual topics that have been changed in a set period: Each day, every hour, whatever is configured for your system.
 
  • 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.
Added:
>
>
  • If you prefer, you can subscrive to RSS and ATOM feeds. Every web has a WebRss feed and a WebAtom feed, respectively.
  That's it! You're now equipped with all the TWiki essentials. You are ready to roll.
Changed:
<
<
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!
>
>
TIP 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!
 
Changed:
<
<
Related Topics: UserDocumentationCategory
>
>
Related Topics: UserDocumentationCategory, WelcomeGuest, ATasteOfTWiki, TWikiVariables, WikiSyntax, TWikiDocGraphics
 
Added:
>
>
-- Contributors: TWiki:Main/ArthurClemens, TWiki:Main/AurelioAHeckert, TWiki:Main/ChrisGarrod, TWiki:Main/MikeMannix, TWiki:Main/SebastianKlus, TWiki:Main/PeterThoeny

Revision 172005-03-27 - TWikiContributor

Line: 1 to 1
Deleted:
<
<
 
Changed:
<
<

20-Minute TWiki Tutorial

>
>

20-Minute TWiki Tutorial

  This step-by-step, hands-on tutorial gets you up to speed with all the TWikiSite basics, in mere minutes...
Added:
>
>
 

1. Get set...

Open two browser windows, so that you can follow these steps in one window, while trying things out in the other.
Line: 22 to 23
 
  • Go to the TWikiRegistration page to create your TWiki account. Fill in a couple of lines and you're set!

4. Check out TWiki users, groups.

Changed:
<
<
  • 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.
  • 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.
>
>
  • Go to the TWikiUsers topic; it has a list of all users of TWiki. Your WikiName will be in this list after you register.
  • 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.
 

5. Test the page controls...

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::
Line: 48 to 49
 
    1. 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.
    2. Click on the question mark. Now you're in edit mode of the new topic.
    3. Type some text, basically, like you write an e-mail.
Changed:
<
<
    1. 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.
>
>
    1. 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.
 
    1. Preview and save the topic...
  • Learn about text formatting. You can enter text in TWikiShorthand, a very simple markup language. Follow the TWikiShorthand link to see how, then:
    1. Go back to your sandbox topic end edit it.

Revision 162005-03-27 - TWikiContributor

Line: 1 to 1
 

20-Minute TWiki Tutorial

This step-by-step, hands-on tutorial gets you up to speed with all the TWikiSite basics, in mere minutes...

Changed:
<
<
>
>
 

1. Get set...

Open two browser windows, so that you can follow these steps in one window, while trying things out in the other.
Line: 71 to 71
 
  • 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.
  • 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.
  • 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.
Changed:
<
<
>
>
 That's it! You're now equipped with all the TWiki essentials. You are ready to roll.

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!

Revision 142005-03-27 - TWikiContributor

Line: 1 to 1
 

20-Minute TWiki Tutorial

Line: 21 to 21
 To edit topics, you need to have a TWiki account.
  • Go to the TWikiRegistration page to create your TWiki account. Fill in a couple of lines and you're set!
Changed:
<
<

4. Check out TWiki users, groups, offices...

>
>

4. Check out TWiki users, groups.

 
  • 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.
Changed:
<
<
  • Go to the TWikiGroups topic in the TWiki.Main web; it has a list of groups which can be used to define fine grained TWikiAccessControl in TWiki.
  • Go to the OfficeLocations topic in the TWiki.Main web; it has a sample list of corporate offices. This type of set-up can be used for departments, client companies, or any other type of organizational divisions.
>
>
 

5. Test the page controls...

Changed:
<
<
Go to the bottom of the page to see what you can do. The color-coded control strip has a collection of action links:
  • [Edit] - add to or edit the topic (discussed later)
  • [Attach] - attach files to a topic (discussed later)
  • [Ref-By] - find out what other topics link to this topic (reverse link)
  • [Printable] - goes to a stripped down version of the page, good for printing
  • [Diffs] - topics are under revision control - [Diffs] shows you the complete change history of the topic, ex: who changed what and when.
  • [r1.3 | > | r1.2 | > | r1.1] - view a previous version of the topic or the difference between two versions.
  • [More] - additional controls, like [Rename/move], version control and setting the topic's parent.
>
>
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::
  • Edit - add to or edit the topic (discussed later)
  • Raw View - show the source text without editing the topic
  • Attach - attach files to a topic (discussed later)
  • Backlinks - find out what other topics link to this topic (reverse link)
  • Printable - goes to a stripped down version of the page, good for printing
  • History - topics are under revision control - History shows you the complete change history of the topic, for example, who changed what and when
  • r3 > r2 > r1 - view a previous version of the topic or the difference between two versions
  • More - additional controls, such as rename/move, version control and setting the topic's parent.
 

6. Change a page, and create a new one...

Go to the Sandbox. This is the sandbox web, where you can make changes and try it all out at will.
Changed:
<
<
  • Click 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.)
>
>
  • Click the Edit link. You are now in edit mode and you can see the source of the page. (Go to a different topic like TWikiGuestSandbox if you see a "Topic is being edited 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.)
Added:
>
>
  • TIP Tip: When you only want to see the source code of a topic click the Raw View link.
 
  • Notice how WikiWords are linked automatically; there is no link if you look at the text in edit mode.
  • Now, create a new topic - your own test page:
Changed:
<
<
    1. In edit mode, enter a new text with a WikiWord, ex:
      This is YourOwnSandBox topic.
>
>
    1. In edit mode, enter a new text with a WikiWord, for example:
      This is TWikiGuestSandbox topic.
 
    1. 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.
    2. Click on the question mark. Now you're in edit mode of the new topic.
Changed:
<
<
    1. Type some text, basically, like you write an email.
>
>
    1. Type some text, basically, like you write an e-mail.
 
    1. 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.
    2. Preview and save the topic...
Changed:
<
<
  • Learn about text formatting. You can enter text in TWikiShorthand, a very simple markup language. Follow the TWikiShorthand link to see how, then:
>
>
  • Learn about text formatting. You can enter text in TWikiShorthand, a very simple markup language. Follow the TWikiShorthand link to see how, then:
 
    1. Go back to your sandbox topic end edit it.
    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.
    3. Preview and save the topic.

7. Use your browser to upload files as page attachments...

You can attach any type of file to a topic - documents, images, programs, whatever - where they can be opened, viewed, or downloaded.
Changed:
<
<
  • Attaching files is just like including a file with an email.
>
>
  • Attaching files is just like including a file with an e-mail.
 
    1. Go back to your sandbox topic and click on the [Attach] link at the bottom.
    2. Click [Browse] to find a file on your PC that you'd like to attach; enter an optional comment; leave everything else unchecked.
    3. Click [Upload file], then scroll to the end of the page to see the new attachment listing.
  • Do this again - this time, upload a GIF, JPG or PNG image file.
    • Check the [Link:] 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.
    • To move the image, edit the topic and place the last line (containing %ATTACHURL%) anywhere on the page.
Changed:
<
<
  • 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.guest?
>
>
  • 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 TWikiGuest?
 
Changed:
<
<

8. Get email alerts whenever pages are changed...

WebNotify is a subscription service that automatically notifies you by email when topics change in a TWiki web. This is a convenience service - for many people, checking email is easier than checking the Web.
>
>

8. Get e-mail alerts whenever pages are changed...

WebNotify 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.
 
  • 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.
Changed:
<
<
  • Alerts are emailed as links to individual topics that've been changed in a set period: each day, every hour, whatever is configured for your system.
>
>
  • 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.
 
  • 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.
That's it! You're now equipped with all the TWiki essentials. You are ready to roll.
Changed:
<
<
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 email, 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!
>
>
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!
 
Changed:
<
<
-- MikeMannix - 01 Dec 2001
>
>
Related Topics: UserDocumentationCategory
 

Revision 122002-10-22 - PeterThoeny

Line: 1 to 1
 

20-Minute TWiki

Line: 28 to 28
 

5. Test the page controls...

Go to the bottom of the page to see what you can do. The color-coded control strip has a collection of action links:
Changed:
<
<
  • [[Edit] - add to or edit the topic (discussed later)
>
>
  • [Edit] - add to or edit the topic (discussed later)
 
  • [Attach] - attach files to a topic (discussed later)
  • [Ref-By] - find out what other topics link to this topic (reverse link)
  • [Printable] - goes to a stripped down version of the page, good for printing

Revision 112002-04-21 - PeterThoeny

Line: 1 to 1
 

20-Minute TWiki

Line: 37 to 37
 
  • [More] - additional controls, like [Rename/move], version control and setting the topic's parent.

6. Change a page, and create a new one...

Changed:
<
<
Go to the Test. This is the sandbox web, where you can make changes and try it all out at will.
  • Click 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.)
>
>
Go to the Sandbox. This is the sandbox web, where you can make changes and try it all out at will.
  • Click 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, create a new topic - your own test page:

Revision 102001-12-02 - MikeMannix

Line: 1 to 1
 

20-Minute TWiki

Changed:
<
<
This step-by-step, hands-on tutorial gets you up to speed with all the TWiki basics, in mere minutes...
>
>
This step-by-step, hands-on tutorial gets you up to speed with all the TWikiSite basics, in mere minutes...
 

1. Get set...

Open two browser windows, so that you can follow these steps in one window, while trying things out in the other.

Revision 92001-12-02 - MikeMannix

Line: 1 to 1
 
Changed:
<
<

20-Minute TWiki

>
>

20-Minute TWiki

 
Changed:
<
<
This step-by-step, hands-on tutorial gets you up to speed with all the TWiki basics, in mere minutes...
>
>
This step-by-step, hands-on tutorial gets you up to speed with all the TWiki basics, in mere minutes...
 
Changed:
<
<

1. Get set:

Open two browser windows, side-by-side, so that you can follow these steps in one window, while trying things out in the other.
>
>

1. Get set...

Open two browser windows, so that you can follow these steps in one window, while trying things out in the other.
 
Changed:
<
<

2. Take a whirlwind tour:

A TWiki site 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.
>
>

2. Take a quick tour...

A TWikiSite 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.
 
  • Each web has hyperlinked topics, displayed as pages in your browser.
  • The home page in each web is the WebHome topic.
Changed:
<
<
  • 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.
>
>
  • 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.
 
  • 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.
Changed:
<
<
  • 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.
>
>
  • 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.
 
Changed:
<
<

3. Open a private account page:

To edit topics, you need to have a TWiki account.

4. Check out TWiki Users, offices and groups:

  • 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.
  • Go to the OfficeLocations topic in the TWiki.Main web; it has a list of corporate offices already entered into TWiki.
  • Go to the TWikiGroups topic in the TWiki.Main web; it has a list of groups which can be used to define fine grained TWikiAccessControl in TWiki.

5. Test the page controls:

Go to the WebHome page to find out what you can do. The bottom of the page has action links:
  • Edit - add to or 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 - view a previous version of the topic or the difference between two revisions
  • More - additional controls, like Rename/move, version control and setting the topic parent.

6. Change a page and create a new one:

Go to the Test topic of the TWiki.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.)
>
>

3. Open a private account...

To edit topics, you need to have a TWiki account.
  • Go to the TWikiRegistration page to create your TWiki account. Fill in a couple of lines and you're set!

4. Check out TWiki users, groups, offices...

  • 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.
  • Go to the TWikiGroups topic in the TWiki.Main web; it has a list of groups which can be used to define fine grained TWikiAccessControl in TWiki.
  • Go to the OfficeLocations topic in the TWiki.Main web; it has a sample list of corporate offices. This type of set-up can be used for departments, client companies, or any other type of organizational divisions.

5. Test the page controls...

Go to the bottom of the page to see what you can do. The color-coded control strip has a collection of action links:
  • [[Edit] - add to or edit the topic (discussed later)
  • [Attach] - attach files to a topic (discussed later)
  • [Ref-By] - find out what other topics link to this topic (reverse link)
  • [Printable] - goes to a stripped down version of the page, good for printing
  • [Diffs] - topics are under revision control - [Diffs] shows you the complete change history of the topic, ex: who changed what and when.
  • [r1.3 | > | r1.2 | > | r1.1] - view a previous version of the topic or the difference between two versions.
  • [More] - additional controls, like [Rename/move], version control and setting the topic's parent.

6. Change a page, and create a new one...

Go to the Test. This is the sandbox web, where you can make changes and try it all out at will.
  • Click 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.
Changed:
<
<
  • Now, create a new topic, your own test page:
    1. In edit mode, enter a new text with a WikiWord, i.e.
      This is PaulsSandBox topic.
    2. 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.
    3. Click on the question mark. Now you are in edit mode of the new topic.
>
>
  • Now, create a new topic - your own test page:
    1. In edit mode, enter a new text with a WikiWord, ex:
      This is YourOwnSandBox topic.
    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.
    3. Click on the question mark. Now you're in edit mode of the new topic.
 
    1. Type some text, basically, like you write an email.
    2. 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.
Changed:
<
<
    1. Preview and save the topic.
  • Learn about text formatting. You can enter text in WikiSyntax, a very simple markup language. Follow the WikiSyntax link to see how, then:
>
>
    1. Preview and save the topic...
  • Learn about text formatting. You can enter text in TWikiShorthand, a very simple markup language. Follow the TWikiShorthand link to see how, then:
 
    1. Go back to your sandbox topic end edit it.
Changed:
<
<
    1. 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.
>
>
    1. 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.
 
    1. Preview and save the topic.
Changed:
<
<

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 (bullet containing %ATTACHURL%) to anywhere you like.
  • If you have a GIF or JPG image of yourself, why not upload it now to your personal topic?

8. Get email alerts when topics change:

It is very important that team members are kept in sync of changes.
  • WebNotify (one per TWiki web) is a subscription service to be automatically notified by email when topics change in a TWiki 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 TWiki web(s) relevant to your work.
>
>

7. Use your browser to upload files as page attachments...

You can attach any type of file to a topic - documents, images, programs, whatever - where they can be opened, viewed, or downloaded.
  • Attaching files is just like including a file with an email.
    1. Go back to your sandbox topic and click on the [Attach] link at the bottom.
    2. Click [Browse] to find a file on your PC that you'd like to attach; enter an optional comment; leave everything else unchecked.
    3. Click [Upload file], then scroll to the end of the page to see the new attachment listing.
  • Do this again - this time, upload a GIF, JPG or PNG image file.
    • Check the [Link:] 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.
    • To move the image, edit the topic and place the last line (containing %ATTACHURL%) anywhere on the page.
  • 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.guest?

8. Get email alerts whenever pages are changed...

WebNotify is a subscription service that automatically notifies you by email when topics change in a TWiki web. This is a convenience service - for many people, checking email is easier than checking the Web.
  • 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.
  • Alerts are emailed as links to individual topics that've been changed in a set period: each day, every hour, whatever is configured for your system.
  • 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.
  That's it! You're now equipped with all the TWiki essentials. You are ready to roll.
Changed:
<
<
NOTE: When first using TWiki, it will probably seem strange to be able to change other people's postings - separated messages is the online rule, with email, message boards, non-Wiki collaboration platforms. Don't worry about it. Nothing gets lost, you can always check previous versions, and copy-and-paste from them if you want to revert after saving a change. Use TWiki for a short while, and you'll want this sort of natural communications freedom...everywhere!
>
>
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 email, 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!
 
Changed:
<
<
-- PeterThoeny - 13 Sep 2001
-- MikeMannix - 14 Sep 2001
>
>
-- MikeMannix - 01 Dec 2001

Revision 82001-09-14 - MikeMannix

Line: 1 to 1
 
Changed:
<
<

20 Minute TWiki

This step-by-step, hands-on tutorial gets you up to speed with all the TWiki basics in mere minutes...

>
>

20-Minute TWiki

 
Added:
>
>
This step-by-step, hands-on tutorial gets you up to speed with all the TWiki basics, in mere minutes...
 

1. Get set:

Changed:
<
<
  • Open two browser windows; arrange them so that you can follow these steps in one window, while trying things out in the other.
>
>
Open two browser windows, side-by-side, so that you can follow these steps in one window, while trying things out in the other.
 
Changed:
<
<

2. Take a tour around:

  • TWiki 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.
>
>

2. Take a whirlwind tour:

A TWiki site 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.
  • Each web has hyperlinked topics, displayed as pages in your browser.
 
  • The home page in each web is the WebHome topic.
  • 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.
  • Follow the WikiWord link and learn what it is.
Line: 18 to 18
 
  • 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.

3. Open a private account page:

Changed:
<
<
  • To edit topics, you need to have a TWiki account.
>
>
To edit topics, you need to have a TWiki account.
 

4. Check out TWiki Users, offices and groups:

Line: 26 to 26
 
  • Go to the OfficeLocations topic in the TWiki.Main web; it has a list of corporate offices already entered into TWiki.
  • Go to the TWikiGroups topic in the TWiki.Main web; it has a list of groups which can be used to define fine grained TWikiAccessControl in TWiki.
Changed:
<
<

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.
  • More : More actions on the topic, like rename/move, version control and setting the topic parent.
>
>

5. Test the page controls:

Go to the WebHome page to find out what you can do. The bottom of the page has action links:
  • Edit - add to or 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 - view a previous version of the topic or the difference between two revisions
  • More - additional controls, like Rename/move, version control and setting the topic parent.
 

6. Change a page and create a new one:

Changed:
<
<
  • Go to the Test topic of the TWiki.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.)
>
>
Go to the Test topic of the TWiki.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.
Changed:
<
<
  • Now let's create a new topic, your own sandbox topic:
    • In edit mode, enter a new text with a WikiWord, i.e.
    • 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.
>
>
  • Now, create a new topic, your own test page:
    1. In edit mode, enter a new text with a WikiWord, i.e.
      This is PaulsSandBox topic.
    2. 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.
    3. Click on the question mark. Now you are in edit mode of the new topic.
    4. Type some text, basically, like you write an email.
    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.
    6. Preview and save the topic.
  • Learn about text formatting. You can enter text in WikiSyntax, a very simple markup language. Follow the WikiSyntax link to see how, then:
    1. Go back to your sandbox topic end edit it.
    2. 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.
    3. Preview and save the topic.
 

7. Upload files as page Attachments:

Changed:
<
<
  • You can attach any file to a topic, not unlike attachments to an email.
>
>
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.
Line: 68 to 65
 
  • If you have a GIF or JPG image of yourself, why not upload it now to your personal topic?

8. Get email alerts when topics change:

Changed:
<
<
  • It is very important that team members are kept in sync of changes.
>
>
It is very important that team members are kept in sync of changes.
 
  • WebNotify (one per TWiki web) is a subscription service to be automatically notified by email when topics change in a TWiki 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 TWiki web(s) relevant to your work.
Changed:
<
<
>
>
 That's it! You're now equipped with all the TWiki essentials. You are ready to roll.
Changed:
<
<
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 TWiki administrator if needed.)
>
>
NOTE: When first using TWiki, it will probably seem strange to be able to change other people's postings - separated messages is the online rule, with email, message boards, non-Wiki collaboration platforms. Don't worry about it. Nothing gets lost, you can always check previous versions, and copy-and-paste from them if you want to revert after saving a change. Use TWiki for a short while, and you'll want this sort of natural communications freedom...everywhere!
 
Changed:
<
<
-- PeterThoeny - 13 Sep 2001
-- MikeMannix - 29 Aug 2001
>
>
-- PeterThoeny - 13 Sep 2001
-- MikeMannix - 14 Sep 2001

Revision 72001-09-13 - PeterThoeny

Line: 1 to 1
 

20 Minute TWiki

Line: 34 to 34
 
  • 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.
Added:
>
>
  • More : More actions on the topic, like rename/move, version control and setting the topic parent.
 

6. Change a page and create a new one:

  • Go to the Test topic of the TWiki.Test web. This web is the sandbox where you can make changes at will.
Line: 63 to 64
 
  • 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.
Changed:
<
<
  • 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.
>
>
  • 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 (bullet containing %ATTACHURL%) to anywhere you like.
 
  • If you have a GIF or JPG image of yourself, why not upload it now to your personal topic?

8. Get email alerts when topics change:

Line: 75 to 76
  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 TWiki administrator if needed.)
Changed:
<
<
-- PeterThoeny - 28 Dec 2000
>
>
-- PeterThoeny - 13 Sep 2001
 -- MikeMannix - 29 Aug 2001

Revision 62001-09-11 - PeterThoeny

Line: 1 to 1
 

20 Minute TWiki

Line: 21 to 21
 
  • To edit topics, you need to have a TWiki account.
  • Go to the TWikiRegistration page to create your TWiki account.
Changed:
<
<

4. Check out TWiki Users and offices:

>
>

4. Check out TWiki Users, offices and groups:

 
  • 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.
  • Go to the OfficeLocations topic in the TWiki.Main web; it has a list of corporate offices already entered into TWiki.
Added:
>
>
  • Go to the TWikiGroups topic in the TWiki.Main web; it has a list of groups which can be used to define fine grained TWikiAccessControl in TWiki.
 

5. Test the Topic controls:

  • Go to the WebHome topic to learn what we can do with a topic.

Revision 52001-08-29 - MikeMannix

Line: 1 to 1
Changed:
<
<
This is a short, step-by-step tutorial to get you up to speed on TWiki.
>
>

20 Minute TWiki

 
Changed:
<
<
  • 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.
>
>
This step-by-step, hands-on tutorial gets you up to speed with all the TWiki basics in mere minutes...
 
Changed:
<
<
  • Navigation and search:
>
>

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.

2. Take a tour around:

 
    • TWiki 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.
Line: 12 to 17
 
    • 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 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.
Changed:
<
<
  • Create your account:
>
>

3. Open a private account page:

 
    • To edit topics, you need to have a TWiki account.
    • Go to the TWikiRegistration page to create your TWiki account.
Changed:
<
<
  • TWiki Users and offices:
>
>

4. Check out TWiki Users and offices:

 
    • 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.
    • Go to the OfficeLocations topic in the TWiki.Main web; it has a list of corporate offices already entered into TWiki.
Changed:
<
<
  • Operations on topics:
>
>

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)
Line: 29 to 34
 
    • 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.
Changed:
<
<
  • Editing a topic and creating hyperlinked pages:
>
>

6. Change a page and create a new one:

 
    • Go to the Test topic of the TWiki.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.
Changed:
<
<
This is PaulsSandBox topic.
>
>
    • 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.
Line: 49 to 54
 
      • 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.
Changed:
<
<
  • Attaching files to a topic:
>
>

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.
Line: 60 to 65
 
    • 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?
Changed:
<
<
  • Getting notified of topic changes:
>
>

8. Get email alerts when topics change:

 
    • It is very important that team members are kept in sync of changes.
    • WebNotify (one per TWiki web) is a subscription service to be automatically notified by email when topics change in a TWiki 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 TWiki web(s) relevant to your work.
Changed:
<
<
This concludes the tutorial. Now you are ready to roll.
>
>
That's it! You're now equipped with all the TWiki essentials. You are ready to roll.
 
Changed:
<
<
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 TWiki administrator if needed.)
>
>
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 TWiki administrator if needed.)
  -- PeterThoeny - 28 Dec 2000
Added:
>
>
-- MikeMannix - 29 Aug 2001

Revision 42001-03-25 - PeterThoeny

Line: 21 to 21
 
    • Go to the OfficeLocations topic in the TWiki.Main web; it has a list of corporate offices already entered into TWiki.

  • Operations on topics:
Changed:
<
<
    • Go the the WebHome topic to learn what we can do with a topic.
>
>
    • 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)
Line: 30 to 30
 
    • 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:
Changed:
<
<
    • Go the the Test topic of the TWiki.Test web. This web is the sandbox where you can make changes at will.
>
>
    • Go to the Test topic of the TWiki.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.

Revision 32000-12-29 - PeterThoeny

Line: 10 to 10
 
    • 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.
    • 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.
Changed:
<
<
    • 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. Note: A search only looks in the current web unless you use the advanced search option.
>
>
    • 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.
 
  • Create your account:
    • To edit topics, you need to have a TWiki account.
Changed:
<
<
>
>
 
  • TWiki Users and offices:
Changed:
<
<
    • 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.
>
>
    • 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.
 
    • Go to the OfficeLocations topic in the TWiki.Main web; it has a list of corporate offices already entered into TWiki.

  • Operations on topics:
Line: 46 to 46
 
    • 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.
Changed:
<
<
      • Enter some text in WikiSyntax: bold text, italic text, bold italic text, a bullet list, tables, paragraphs, e.t.c. Hint: If you need to look up the WikiSyntax, click on the TextFormattingRules link located below the edit field.
>
>
      • 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:
Line: 61 to 61
 
    • If you have a GIF or JPG image of yourself, why not upload it now to your personal topic?

  • Getting notified of topic changes:
Changed:
<
<
    • It is very important that team members are kept in synch of changes.
>
>
    • It is very important that team members are kept in sync of changes.
 
    • WebNotify (one per TWiki web) is a subscription service to be automatically notified by email when topics change in a TWiki 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 TWiki web(s) relevant to your work.

This concludes the tutorial. Now you are ready to roll.

Changed:
<
<
A side note: Initially it can be intriguing to change text someone else wrote. Please do not worry, nothing gets lost, because previous versions are always accessible (and also recoverable by the TWiki administrator if needed.)
>
>
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 TWiki administrator if needed.)
 
Changed:
<
<
-- PeterThoeny - 13 Dec 2000
>
>
-- PeterThoeny - 28 Dec 2000

Revision 22000-12-14 - PeterThoeny

Line: 6 to 6
 
  • Navigation and search:
    • TWiki 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.
Changed:
<
<
    • The home page in each web is the WebHome topic.
>
>
    • The home page in each web is the WebHome topic.
 
    • 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.
    • 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.
Changed:
<
<
    • 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. Note: A search only looks in the current web unless you use the advanced search option.
>
>
    • 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. Note: A search only looks in the current web unless you use the advanced search option.
 
  • Create your account:
    • To edit topics, you need to have a TWiki account.
    • Go to the TWikiRegistration page to create your TWiki account.

  • TWiki Users and offices:
Changed:
<
<
    • 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.
    • Go to the OfficeLocations topic in the TWiki.Main web; it has a list of corporate offices already entered into TWiki.
>
>
    • 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.
    • Go to the OfficeLocations topic in the TWiki.Main web; it has a list of corporate offices already entered into TWiki.
 
  • Operations on topics:
Changed:
<
<
    • Go the the WebHome topic to learn what we can do with a topic.
>
>
    • Go the 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)
Line: 30 to 30
 
    • 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:
Changed:
<
<
    • Go the the Test topic of the TWiki.Test web. This web is the sandbox where you can make changes at will.
>
>
    • Go the the Test topic of the TWiki.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.
Line: 41 to 41
 
      • 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.
Changed:
<
<
      • 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.
>
>
      • 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.
Line: 62 to 62
 
  • Getting notified of topic changes:
    • It is very important that team members are kept in synch of changes.
Changed:
<
<
    • WebNotify (one per TWiki web) is a subscription service to be automatically notified by email when topics change in a TWiki 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.
>
>
    • WebNotify (one per TWiki web) is a subscription service to be automatically notified by email when topics change in a TWiki 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 TWiki web(s) relevant to your work.

This concludes the tutorial. Now you are ready to roll.

A side note: Initially it can be intriguing to change text someone else wrote. Please do not worry, nothing gets lost, because previous versions are always accessible (and also recoverable by the TWiki administrator if needed.)

Changed:
<
<
-- PeterThoeny - 18 Aug 2000
>
>
-- PeterThoeny - 13 Dec 2000

Revision 12000-08-18 - PeterThoeny

Line: 1 to 1
Added:
>
>
This is a short, step-by-step tutorial to get you up to speed on TWiki.

  • 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:
    • TWiki 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 TWiki 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 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. Note: A search only looks in the current web unless you use the advanced search option.

  • Create your account:
    • To edit topics, you need to have a TWiki account.
    • Go to the TWikiRegistration page to create your TWiki account.

  • TWiki Users and offices:
    • 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.
    • Go to the OfficeLocations topic in the TWiki.Main web; it has a list of corporate offices already entered into TWiki.

  • Operations on topics:
    • Go the 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 the the Test topic of the TWiki.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.
        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, e.t.c. 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 synch of changes.
    • WebNotify (one per TWiki web) is a subscription service to be automatically notified by email when topics change in a TWiki 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 TWiki web(s) relevant to your work.

This concludes the tutorial. Now you are ready to roll.

A side note: Initially it can be intriguing to change text someone else wrote. Please do not worry, nothing gets lost, because previous versions are always accessible (and also recoverable by the TWiki administrator if needed.)

-- PeterThoeny - 18 Aug 2000

 
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 1999-2024 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback
Note: Please contribute updates to this topic on TWiki.org at TWiki:TWiki.TWikiTutorial.