Page History

{include:ContentHeader}
{note}This is a deliverable from Building with Nature project DM 1.1{note}

*This wiki tutorial is intended for aspiring wiki users in any project that has embraced [the OpenEarth philosphy|OpenEarth] to handle data, models, tools and knowledge. While it was developed as course material for the Building with Nature Introductory Wiki Training Course this tutorial provides sufficient information for selfstudy (become a wiki user in under 30 minutes!).* 

The Introductory Wiki Training Course was developed in the framework of the [Building with Nature|http://www.ecoshape.nl] project and involves *one day* in which the participants are taken through a wide range of excercises. Although the schedule can be adapted to better suit the participants' specific needs and background knowledge the schedule of this course generally is as follows: 

{roundrect:title=*Programme:*}
* *9:00-9:25 Open Earth initiative* - [download presentation|Data tutorials^Data_standards_course_Intro4BwN.pps]\\ 
** General introduction of the OpenEarth initiative\\
* *9:25-9:30 Effective cooperation and information exchange*\\
** Opening and outline of the course\\
** *{_}Excercise:_* get your username and password\\
* *9:30-10:30 Basic introduction using the Confluence wiki system*\\
** *{_}Excercise:_* create and edit your own page\\
** *{_}Excercise:_* how to add attachments\\
** *{_}Excercise:_* using options provided by Confluence\\
* *10:30-12:00 Advanced wiki topics*\\
** *{_}Excercise:_* add prepared content to wiki\\
** *{_}Excercise:_* basic layout of pages\\
** *{_}Excercise:_* embed your page in exisiting wiki space\\
** *{_}Excercise:_* work with advanced macros\\
\\
* *12:00-13:00 Lunch*\\
\\
* *13:00-15:30 Apply freshly gained skills to BwN wiki*\\
** *{_}Excercise:_* create project specific wiki page\\
** *{_}Excercise:_* work together on various parts of the BwN wiki\\
* *15:30-16:30 Show examples of other parts of OpenEarth*\\
** Highlights of other session{roundrect}

h4. 1. Why use wikis?
h5. 1.0 Presentation
{tip:title=Download}Click download in the bottom left corner of the [presentation|^wiki_course.pdf] if you want to see it in it's original quality{tip}
{viewfile:wiki_course.pdf}

h5. 1.1 What is a wiki?
Pioneered by Ward Cunningham, and named after the Hawaiian word for 'quick', a wiki is a website that makes it easy for anyone to contribute pages, and link them together. Wikis are a type of social software that make it easy to communicate online. As simple to edit as it is to read, the wiki makes for the perfect online collaboration tool. 

In recent years, wikis have become more and more popular: as repositories of programming wisdom, as social experiments, as massive online encyclopaedias, and increasingly as tools of savvy businesses, looking for a simple but effective way to share content and information both inside their organisation and out. 

h5. 1.2 Advantages to Using a Wiki?
Why might you want to use a wiki for your project? The wiki is:
* Good for writing down quick ideas or longer ones, giving you more time for formal writing and editing. 
* Instantly collaborative without emailing documents, keeping the group in sync. 
* Accessible from anywhere with a web connection (if you don't mind writing in web-browser text forms). 
* Your archive, because every page revision is kept. 
* Exciting, immediate, and empowering - everyone has a say. 

h5. 1.3 Disadvantages to Using a Wiki
But why might you not want to use one?
* Dirty laundry isn't a good public face. If a wiki's a shared memory, it's not going to be terribly tidy, and you may not want people to see your half-formed, unsure, and speculative ideas (though actually, we advise against having your wiki be public). 
* Its tendency to get messier. A wiki isn't an administrative panacea, and there's certain maintenance you need to perform, otherwise it'll turn into unusable idea soup. 

To embrace the advantages of wiki's OpenEarth embraces the Deltares-provided [Confluence wiki system|http://www.atlassian.com/software/confluence/]. To mitigate problems occurring by the above-mentioned disadvantages, the OpenEarth developers team helps users to manage and maintain their wiki space. 

h4. 2. Sign in to get a username and password
!signup_snapshot.jpg|width=409px, align=right! To be able to edit a wikipage you need to [log in|https://publicwiki.deltares.nl/login.action]. To log in you need a username and password. You can choose your own username password combination by signing in. To prevent too much creativity in the usernames, however, OpenEarth prescribes the following convention:
* you must enter your real "full name" details and current work email adress
* you must select your username to be the same as you email adress (use tick box)
* you can select your password arbitrarily (it can be sent to you automatically should you have forgotten it)

Filling in your real personal details facilitates the identification of contributions by various wiki users. For top wiki contributors the visibility of their username functions as a 'Hall of fame', providing recognition for their effort and skill. For saboteurs username visibility functions as a 'Hall of shame', enabeling intervention by the OpenEarth developers team (e.g. rolling back poor changes and eventually disabeling the saboteur's account). Working with usernames and passwords is a crucial element in the OpenEarth quality control procedures.

h4. 3. A quickstart guide to the Confluence wiki system
For this Introductory Wiki Training Course we shall look at the following video tutorials to quickstart you as a wiki user:
* [Step 1: Creating wiki pages|https://www.umms.med.umich.edu/confluence/display/demo/Creating+Pages] ([fullscreen|^AddingPages.swf])
* [Step 2: Editing wiki pages|https://www.umms.med.umich.edu/confluence/display/demo/Editing+Pages] ([fullscreen|^EditingPages.swf])
* [Step 3: Adding attachments to wik pages|https://www.umms.med.umich.edu/confluence/display/demo/Attachments] ([fullscreen|^Attach.swf])
* [Step 4: Working with drafts|https://www.umms.med.umich.edu/confluence/display/demo/Drafts] ([fullscreen|^Drafts.swf])
* [Step 5: Versions and history|https://www.umms.med.umich.edu/confluence/display/demo/Versions+and+History] ([fullscreen|^VersionsAndHistory.swf])
* [Step 6: Browse through a wiki space|https://www.umms.med.umich.edu/confluence/display/demo/Browsing] ([fullscreen|^Browsing.swf])

{attachments:patterns=.*swf}
If you want to learn more a complete list of of video tutorials is available from the following link:
* [University of Michigan Medical School - Video Tutorial Index|https://www.umms.med.umich.edu/confluence/display/demo/Video+Tutorial+Index]

h4. 4. The basics of formatting your wiki page
Now that we know the basics of the Confluence wiki system, we are ready to learn some basic wiki formatting skills.
{style}
.panel { border-style: none}
{style}
|| Notation || Result ||
| {noformat}h1. heading level 1 
h2. heading level 2 
etc. {noformat} | h1. heading level 1 \\ 
h2. heading level 2 |
|{noformat}*strong*{noformat} | Makes text *strong*. |
|{noformat}_emphasis_{noformat} | Makes text _emphasis_. | 
|{noformat}-strikethrough-{noformat} | Makes text as -strikethrough-. | 
|{noformat}+underlined+{noformat} | Makes text as +underlined+. |
|{noformat}^superscript^{noformat} | Makes text in ^superscript^. |
|{noformat}~subscript~{noformat} | Makes text in ~subscript~. |
| {noformat}* this is how you make a bullet
** and an indented bullet
*** and an indented-indented one{noformat} | * this is how you make a bullet \\
** and an indented bullet\\
*** and an indented-indented one |
| {noformat}# this is how you make a numbered list
# list item number 2
*# a numbered subitem
**# and a numbered sub-subitem{noformat} | # this is how you make a numbered list \\
# list item number 2 \\
*# a numbered subitem \\
**# and a numbered sub-subitem |
| {noformat}
||head1 ||head2|| 
| colA1 | colA2 |
| colB1 | colB2 |{noformat} | this is how you make a table {div}||head1 ||head2|| 
| colA1 | colA2 |
| colB1 | colB2 | {div} |
| {noformat}[OpenEarth]{noformat} | this is how you make a link to the [OpenEarth] page |
| {noformat}[This goes to the OpenEarth homepage|OpenEarth]{noformat} | this is how you add a link to a page to arbitrary text such as [This goes to the OpenEarth homepage|OpenEarth]  |
| {noformat}[http://www.wolframalpha.com/]{noformat} | this is how you make a link to an external site such as [http://www.wolframalpha.com/]  |
| {noformat}[DoesNotExist]{noformat} | You can create links to pages which don't exist yet. When you click on the link you can [create the page|DoesNotExist]. |
| {noformat}[this is how you create a link to an attachment|^signup_snapshot.jpg]{noformat} | When you want to point a wiki user towards an attachment, [this is how you create a link to an attachment|^signup_snapshot.jpg] |
| {noformat}!signup_snapshot.jpg|width=409px, align=right!{noformat} | !signup_snapshot.jpg|width=409px, align=right! This is how you include a picture of specific width, aligned right. |



{info}This is just a subset of what you can do. For a more extensive list see the [Full notation guide|http://publicwiki.deltares.nl/renderer/notationhelp.action] {info}
{tip}If you want to see how a page is created, click on the top right on tools and select *view wiki markup*{tip}

h4. 5. Some advanced wiki formatting techniques
A number of often used more advanced formatting techniques are discussed here.
{style}
.panel { border-style: none}
{style}
|| Notation || Result ||
|{noformat}{warning:title=Warning}
Insert warning message here!
{warning}{noformat} | {warning:title=Warning}Insert warning message here!{warning} |
|{noformat}{info:title=Useful Information}
This macro is useful for including helpful information in your confluence pages!
{info}{noformat} | {info:title=Useful information}This macro is useful for including helpful information in your confluence pages!
{info} |
|{noformat}{tip:title=Handy tip}
Join OpenEarth!
{tip}{noformat} | {tip:title=Handy tip}Join OpenEarth\!{tip} |
|{noformat}{note:title=Nota bene}Enter here some text you think is note worthy{note}{noformat} | {note:title=Nota bene}Enter here some text you think is note worthy{note} |
| {noformat}{gallery}{noformat} | {gallery} | 
| {noformat}{recently-updated:max=5}{noformat} | {recently-updated:max=5} | 
| {noformat}{chart:type=pie|dataDisplay=true|legend=true|width=300|height=200}
|| Satisfaction level || Very satisfied   || Satisfied ||  Disatistfied || Very disatisfied ||
| n | 7 | 4 | 2 | 1 |  
{chart}{noformat} | {chart:type=pie|dataDisplay=true|legend=true|width=300|height=200}
|| Satisfaction level || Very satisfied   || Satisfied ||  Disatistfied || Very disatisfied ||
| n | 7 | 4 | 2 | 1 | 
{chart} |
|{noformat}{rate}{noformat} | {rate} |
| {noformat}{calendar:id=myCalendar|title=My Calendar|defaultView=week}{noformat} | {calendar:id=myCalendar|title=My Calendar|defaultView=week} | 
| {noformat}{panel:title=My Title}Some text with a title{panel}{noformat} | {panel:title=My Title}Some text with a title{panel}  |

|| Other macros you might want to try ||
| {noformat}{gmap:width=300|height=200}Delft{gmap}{noformat} | 
|{noformat}{rss:url=http://www.nature.com/news/rss/index.rdf}{noformat} (requires authorization from administrator) | 
| {noformat}{change-history}{noformat} |

h4. 6. Tips on how to use wikis in projects
There are a number of handy tips and tricks to consider using the wiki. Did you know that:
* You can edit a wikipage in a visual mode by selecting the 'Rich text' tab while editing?
* You can easily copy cool layouts from other pages? If you see on a wikipage some formatting you like, just click the edit button, copy the relevant wiki section you like to your own page and modify the wiki markup to your satisfaction.
* You can preview the result of your wiki markup before saving by selecting the 'Preview' tab while editing? 
* You can *_add news items_* about BwN in general or your part of the programme. Just select 'News' under 'Add' in the _upper right_ of your screen. 
* You can interactively work on documents within Confluence. Once you are happy about the page content use the 'Export to Word' option under 'Tools' to export a number of pages. With a bit of additional layout work you can quickly transform your wiki pages to a Word document.
* You can use the wiki as a place to store and develop workshop announcements and minutes. Check for examples the [BwN Workshops|BWN:BwN Workshops] page.

h4. 7. References
* *Complete video tutorial index* - [https://www.umms.med.umich.edu/confluence/display/demo/Video+Tutorial+Index]
* *Complete Confluence notation guide* - [http://confluence.atlassian.com/renderer/notationhelp.action?section=all]
* *Overview of pros and cons of wikis in general* - [http://www.oreillynet.com/pub/a/network/2006/07/07/what-is-a-wiki.html?page=2#advantages]
* *Overview of pros and cons using Confluence* - [http://www.atlassian.com/software/confluence/wiki.jsp#whyuseawiki]