Author and Admin Training - PhUSE Wiki · Author and Admin Training Complete Training ... – only...

28
PhUSE Wiki A place to Share, Contribute and Advance Author and Admin Training Complete Training Version 1.0 13 th February 2012

Transcript of Author and Admin Training - PhUSE Wiki · Author and Admin Training Complete Training ... – only...

Page 1: Author and Admin Training - PhUSE Wiki · Author and Admin Training Complete Training ... – only high contributer, WG leads or (Co-) ... PhUSE Wiki Training-13FEB2012.ppt

PhUSE WikiA place to Share, Contribute and Advance

Author and Admin Training

Complete TrainingVersion 1.0

13th February 2012

Page 2: Author and Admin Training - PhUSE Wiki · Author and Admin Training Complete Training ... – only high contributer, WG leads or (Co-) ... PhUSE Wiki Training-13FEB2012.ppt

Overview

• Introduction• Setup an account and access• Structure and Pages• General Wiki Features• Creating and editing a Wiki• File Upload

Page 3: Author and Admin Training - PhUSE Wiki · Author and Admin Training Complete Training ... – only high contributer, WG leads or (Co-) ... PhUSE Wiki Training-13FEB2012.ppt

Introduction

• PhUSE Wiki is medium to share information• Main Goals

– Support FDA CSS Working Groups– Support PhUSE annual conference– Share statistical and informatics software code– Share information related to programming and processes

• Relaunch: www.phusewiki.org• Built on stable MediaWiki as a backbone• Available not only to PhUSE Members

Page 4: Author and Admin Training - PhUSE Wiki · Author and Admin Training Complete Training ... – only high contributer, WG leads or (Co-) ... PhUSE Wiki Training-13FEB2012.ppt

FDA Working Groups

• Special area for FDA Working Groups on PhUSE Wiki• Online collaboration environment

– Documents progress of the FDA/PhUSE Computational Science Symposium working groups

– Quick, easy and transparent• Each working group has a main page as starting page for all activity

– Add pages for:• Sharing of minutes of TCs or discussions• Topics

• Reduces amount of e-mails going back and forth

Page 5: Author and Admin Training - PhUSE Wiki · Author and Admin Training Complete Training ... – only high contributer, WG leads or (Co-) ... PhUSE Wiki Training-13FEB2012.ppt

PhUSE annual Conference

• 2012 conference papers can bepublished by authors as Wiki– In addition to a PDF or instead of a PDF

• PhUSE Wiki provides authors platform to share– Allows other people to contribute– Global Collaboration on various topics

• Allows (Co-) Chairs as subject matter experts to review and comment on content

Page 6: Author and Admin Training - PhUSE Wiki · Author and Admin Training Complete Training ... – only high contributer, WG leads or (Co-) ... PhUSE Wiki Training-13FEB2012.ppt

Setup Account and Access

• Everyone can access the PhUSE Wiki and read everything• (Free) account need to be created to edit Wiki• Requires confirmation via e-mail

Account Creation

1. Go to www.phusewiki.org

2. Click on in the upperright corner

3. Click on „Create an Account“ on theLogin Page

Page 7: Author and Admin Training - PhUSE Wiki · Author and Admin Training Complete Training ... – only high contributer, WG leads or (Co-) ... PhUSE Wiki Training-13FEB2012.ppt

Setup Account and Access(cntd)

4. Fill in your details on the„Create account“ page and confirmby pressing the „Create Account“button

5. Note: For reasons of transperancy please use your fullname as your username

Page 8: Author and Admin Training - PhUSE Wiki · Author and Admin Training Complete Training ... – only high contributer, WG leads or (Co-) ... PhUSE Wiki Training-13FEB2012.ppt

Setup Account and Access (cntd)

5. The next page shows that your login was successful

6. You will receive an e-mail which you need to confirm by clicking on thelink provided before you can start to contribute to the Wiki

7. Now you login and enjoy the Wiki

8. To log in just follow the link and fill in your username and password

9. You can start to create new Wikis and editexisting ones

Page 9: Author and Admin Training - PhUSE Wiki · Author and Admin Training Complete Training ... – only high contributer, WG leads or (Co-) ... PhUSE Wiki Training-13FEB2012.ppt

Structure and Pages

Main Page

Sidebar

Searchbox

Searchbox

Create new Wiki Box

Page 10: Author and Admin Training - PhUSE Wiki · Author and Admin Training Complete Training ... – only high contributer, WG leads or (Co-) ... PhUSE Wiki Training-13FEB2012.ppt

Structure and Pages(cntd)

• Most Wiki features can be found on Main Page • Search Boxes allow to search for available Wikis

– E.g. „Wiki Training“ will lead you to a Wiki with the topic Wikitraining

• Create Wiki Box allows you to create your own Wikiquickly and easily

• The Sidebar helps to navigate to important pages– „Categories“: overview of Wiki Categories– „FDA Working Groups“: special Wiki area for FDA CSC WGs– „Conference Papers“: lead to annual conference papers

• Several links on Main Page allow easy access to otherareas or provide useful information

Page 11: Author and Admin Training - PhUSE Wiki · Author and Admin Training Complete Training ... – only high contributer, WG leads or (Co-) ... PhUSE Wiki Training-13FEB2012.ppt

Structure and Pages(cntd)

• There are some important special areas on thePhUSE Wiki– FDA CSS Working Group pages– Annual Conference Pages

Page 12: Author and Admin Training - PhUSE Wiki · Author and Admin Training Complete Training ... – only high contributer, WG leads or (Co-) ... PhUSE Wiki Training-13FEB2012.ppt

Structure and PagesFDA CSS Working Group Pages

• Click on Sidebar for FDA Working Groupsarea

• The instructions give helpful information• Click on the working group name to

access each working group

e.g. access WG1

Page 13: Author and Admin Training - PhUSE Wiki · Author and Admin Training Complete Training ... – only high contributer, WG leads or (Co-) ... PhUSE Wiki Training-13FEB2012.ppt

Structure and PagesFDA CSS Working Group Pages (cntd)

Define the mission of your WG

Name the leader of your WG

Room for minutes and TCs

Easily create minutesusing a template. Just replace theDDMONYYYY withthe date of TC and link to it later here.0

Give „Approach“, „Charter“ and „Scope“ of your WG

Page 14: Author and Admin Training - PhUSE Wiki · Author and Admin Training Complete Training ... – only high contributer, WG leads or (Co-) ... PhUSE Wiki Training-13FEB2012.ppt

Structure and PagesFDA CSS Working Group Pages (cntd)

• Currently pages are able to be edited byAdministrators.

• All registered users can add to the discussion foreach page

• Each WG should define at least 2 Administrators• Administrators need to Protect the pages to

restrict ordinary users to edit– Manual process– Possible to rollback to previous versions

Page 15: Author and Admin Training - PhUSE Wiki · Author and Admin Training Complete Training ... – only high contributer, WG leads or (Co-) ... PhUSE Wiki Training-13FEB2012.ppt

Structure and PagesAnnual Conference Pages

• Click on Sidebar for Annual Conferencearea

• At the bottom there is a list of all thestreams

• Click on a stream name to seeall Wikis for that stream

e.g. click here forCDISC stream

Note: Right now the single streams are storedas Categories and therefore could containnon-conference Wikis as well. Double check with the C4P tool!

Page 16: Author and Admin Training - PhUSE Wiki · Author and Admin Training Complete Training ... – only high contributer, WG leads or (Co-) ... PhUSE Wiki Training-13FEB2012.ppt

Structure and PagesAnnual Conference Pages (cntd)

Stream description

Create a new Wiki

List of Wikisavailable in thatcategory

Page 17: Author and Admin Training - PhUSE Wiki · Author and Admin Training Complete Training ... – only high contributer, WG leads or (Co-) ... PhUSE Wiki Training-13FEB2012.ppt

Structure and PagesAnnual Conference Pages (cntd)

• Currently all pages are able to be edited byeveryone

• Each stream should define at least 1 Administrators to watch content or move pages

• Administrators need to Protect the pages if theywant to restrict ordinary users to edit– Consider: for a conference paper it might be a wish that other

people contribute– Check with your author if they want early contribution– Possible to rollback to previous versions for administrator

Page 18: Author and Admin Training - PhUSE Wiki · Author and Admin Training Complete Training ... – only high contributer, WG leads or (Co-) ... PhUSE Wiki Training-13FEB2012.ppt

Create a Wiki - Basics

• Before you create a new Wiki ensure that the topic doesnot exist– Use Search with different keywords– If Wiki already exists feel free to edit it

• Several ways to create a new Wiki– Use the Create Wiki Box on Main Page– or follow a red link leading to a blank page– Or type a new name in the browser after „…title=„

• http://www.phusewiki.org/wiki/index.php?title=test will create a new Wiki called test

• BE CAUTIOUS HOW YOU CHOOSE A NAMEIT IS NOT EASY TO CHANGE LATER

Page 19: Author and Admin Training - PhUSE Wiki · Author and Admin Training Complete Training ... – only high contributer, WG leads or (Co-) ... PhUSE Wiki Training-13FEB2012.ppt

Create a Wiki - Editor

Title of Wiki you create

Editor to edit your text for your Wiki

Preview of your Wiki(without saving!)

Save and publishyour Wiki

Edit tools for Wiki language(click Advanced to see all tools)

Page 20: Author and Admin Training - PhUSE Wiki · Author and Admin Training Complete Training ... – only high contributer, WG leads or (Co-) ... PhUSE Wiki Training-13FEB2012.ppt

Create a Wiki – Wiki language

• „Wiki Author Training“ in „Create Wiki Box“ creates a new Wiki called „Wiki Author Training“ and opens theWiki editor

• Special Wiki language for edit– Edit tool provides help– =Section 1= creates a Level 1 header titled Section 1– ==Section 1.1== creates a Level 2 header titled Section 1.1– Guess what ===Section 1.1.1=== will do– # numbered list– * bullet point list– ‘‘xyz‘‘creates xyz, ‘‘‘xyz‘‘‘ creates xyz– ~~~~ creates a timestamp with your username

• More basic editing: type Help in Search box– Help page http://www.phusewiki.org/wiki/index.php?title=Help

Create and highlight SAS code<syntaxhighlight lang="sas">

your SAS code here; </syntaxhighlight>

Page 21: Author and Admin Training - PhUSE Wiki · Author and Admin Training Complete Training ... – only high contributer, WG leads or (Co-) ... PhUSE Wiki Training-13FEB2012.ppt

Create a Wiki - Save

• Once you hit the Save Page button your Wiki will bepublished

• You can edit this Wiki again by pushing various editbuttons

Edit complete Wiki

Edit subsection

Page 22: Author and Admin Training - PhUSE Wiki · Author and Admin Training Complete Training ... – only high contributer, WG leads or (Co-) ... PhUSE Wiki Training-13FEB2012.ppt

Create a Wiki - Templates

• Several templates make your life as a Wiki author easier- Template:Paper_Template is a template

which follows the usual template forPhUSE conference papers

Other templates: http://www.phusewiki.org/wiki/index.php?title=Special:TemplatesIf you want to use templates do the following– Type {{subst:templatename}} in the blank editor (e.g. {{subst:Paper_Template}})– Save the Wiki and see that a Wiki is created by using the template– Edit the Wiki and just adjust it to your needs– There are also Create Boxes in the single stream sections which use this template automatically

- Template:MeetingMinutes is a template to create Meeting Minutes which is used forFDA CSC WG meetings

Page 23: Author and Admin Training - PhUSE Wiki · Author and Admin Training Complete Training ... – only high contributer, WG leads or (Co-) ... PhUSE Wiki Training-13FEB2012.ppt

Create a Wiki - Categories

• Categorize your Wiki so that other can find it• Type „Category hierachy“ in Search box to find a list of proposals

which you could and should use• When you create a Wiki type [[Category:categoryname]] in your

editor– E.g. type „[[Category:Derivation Standards]]“

to categorize your Wiki for the Category„Derivation Standards“

• Wikis can have multiple Categories– E.g. Minutes for a „Data Warehouse“ Discussion Club in Budapest

should have the following categories• „PhUSE Budapest 2012“• „Data Warehouse“• „Discussion Club“• „Minutes“

– Ensures that readers find interesting articles under each category

Page 24: Author and Admin Training - PhUSE Wiki · Author and Admin Training Complete Training ... – only high contributer, WG leads or (Co-) ... PhUSE Wiki Training-13FEB2012.ppt

Create a Wiki - Considerations

• As with all open Wikis all Edits on Wikis are tracked and you canalways go back to your original Wiki

• You can easily watch every page to be informed about updates• For some Wikis (e.g. Minutes, Conference Paper) you may want to protect your page– prevents edits by all other Wiki members– you need Admin rights to protect a page– only high contributer, WG leads or (Co-)Chairs receive Admin

rights– a PhUSE Wiki Bureaucrat to apply for Admin rights

– current PhUSE Wiki Bureaucrats:http://www.phusewiki.org/wiki/index.php?title=Special:ListUsers&group=bureaucrat (and admin if applicable)

Page 25: Author and Admin Training - PhUSE Wiki · Author and Admin Training Complete Training ... – only high contributer, WG leads or (Co-) ... PhUSE Wiki Training-13FEB2012.ppt

File Upload

• Inclusion of pictures in Wikis requires file uploads• PhUSE Wiki allows limited upload of files

– Permitted file types: png, gif, jpg, jpeg, pdf– Maximum file size: 24MB

• Sidebar „Upload File“– „Browse“ lets you choose a file to upload

• Note the description how to include a file in your Wiki

Page 26: Author and Admin Training - PhUSE Wiki · Author and Admin Training Complete Training ... – only high contributer, WG leads or (Co-) ... PhUSE Wiki Training-13FEB2012.ppt

Other Tips & Tricks

• Rename Wikis by „Move“ and giveanother title

• „Watch“ interesting Wikis and beinformed about changes

• See how a Wiki evolved over time and seethe revisions by „View History“– List of all versions

Undo revisions

Page 27: Author and Admin Training - PhUSE Wiki · Author and Admin Training Complete Training ... – only high contributer, WG leads or (Co-) ... PhUSE Wiki Training-13FEB2012.ppt

Access Rights

• Users– Read everything– Create accounts

• Mail confirmed users– create and edit Wikis

• Administrators– Protect and unprotect pages– Edit protected pages– Block users

• Bureacrats– Edit all user rights– Promote people to Administrators

Page 28: Author and Admin Training - PhUSE Wiki · Author and Admin Training Complete Training ... – only high contributer, WG leads or (Co-) ... PhUSE Wiki Training-13FEB2012.ppt

Questions?

In case you have any questions don‘t hesitate to contact one of the PhUSE WikiAdmins

Special pages User Group Rights Administrators List of Members Sidebar „e-mail this user“Note: e-mail by other users can be enabled or disabled unter „My preferences“