Difference between revisions of "Help:Contents"

From IS Project Experience
Jump to navigation Jump to search
 
(26 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<h2>User Guide</h2>
+
==Wikis at SMU==
  
 +
This information relates to [http://wiki.smu.edu.sg wikis at SMU]. 
  
=== Background ===
+
* [[Help:Policies|Wiki policies at SMU]]
+
* [[Help:Logging in |Logging in]]
MediaWiki is the most commonly used wiki in the world. It is open source and it is being used to power Wikipedia. After you have gone through this user guide, then you will be prepared to edit and create new topics in Wikipedia/MediaWiki.
+
* [[Help:Setting up a user page|Setting up a user page]]
 +
* [[Help:Basic editing |Basic editing]]
 +
* [[Help:Advanced editing |Advanced editing]]
 +
* [[Help:Finding uploadable images|Finding uploadable images]]
 +
* [[Help:Creating and editing tables|Creating and editing tables]]
 +
* [[Help:Citing your sources|Citing your sources]]
  
 +
==Wikipedia documentation==
  
=== Terms of Use and Wiki Policy ===
+
Some of this information is specific to Wikipedia, which uses several extensions to MediaWiki.  Most of it also applies here, although you may find some advanced functionality that works differently.  If in doubt, consult the MediaWiki documentation below.
  
As a user of wikis in SMU it is important show good behavior and to be respectful. You will find more information about SMU’s terms of use and wiki policy on the links below.  
+
* [http://en.wikipedia.org/wiki/Help:Contents Wikipedia Help Page]
 +
* [http://en.wikipedia.org/wiki/Wikipedia:Cheatsheet Wikipedia Cheat Sheet]
 +
* [http://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style Wikipedia Manual of Style]
  
 +
* [http://en.wikipedia.org/wiki/Wikipedia:Referencing Guidelines on citing sources]
 +
* [http://en.wikipedia.org/wiki/Wikipedia:Picture_tutorial Tutorial on adding images to pages]
 +
* [http://en.wikipedia.org/wiki/Wikipedia:Page_history Tutorial on using the page history]
  
https://wiki.smu.edu.sg/TermsofUse.pdf
+
==MediaWiki documentation==
  
https://wiki.smu.edu.sg/smuwikipolicy.pdf
+
These pages provide a simple introduction to MediaWiki.  For advanced functionality, you can refer to the [http://en.wikipedia.org/wiki/Wikipedia:Page_history full documentation] on the MediaWiki web site.
  
 +
===Reading===
 +
* [http://www.mediawiki.org/wiki/Help:Navigation Navigation]
 +
* [http://www.mediawiki.org/wiki/Help:Tracking_changes Tracking changes]
 +
* [http://www.mediawiki.org/wiki/Help:Watchlist Watchlist]
  
=== Intellectual Property ===
+
===Basic editing===
 +
* [http://www.mediawiki.org/wiki/Help:Editing_pages Editing an existing page]
 +
* [http://www.mediawiki.org/wiki/Help:Starting_a_new_page Starting a new page]
 +
* [http://www.mediawiki.org/wiki/Help:Formatting Formatting]
 +
* [http://www.mediawiki.org/wiki/Help:Links Links]
  
{| class="wikitable centered" width="90%"
+
===Intermediate editing===
!STEP
+
* [http://www.mediawiki.org/wiki/Help:Images Images]
!colspan="40%"|Description
+
* [http://www.mediawiki.org/wiki/Help:Tables Tables]
!colspan="40%"|Remarks
+
* [http://www.mediawiki.org/wiki/Help:Managing_files Uploading and managing files]
|-
+
* [http://www.mediawiki.org/wiki/Help:Moving_a_page Moving (renaming) a page]
|width="10%"|<!-- STEP --> 1
+
* [http://www.mediawiki.org/wiki/Help:Redirects Redirects]
|colspan="40%"|<!-- Description  --> Finding images to use on your project (for including in your presentations and reports), from '''Wikipedia Commons'''.
 
|colspan="40%"|<!-- Remarks  -->
 
|-
 
|width="10%"|<!-- STEP --> 2
 
|colspan="40%"|<!-- Description  --> Give credit to the owner of the image, by attributing authorship.
 
|colspan="40%"|<!-- Remarks  --> Simply add the full URL to the picture in your presentation.
 
|-
 
|width="10%"|<!-- STEP --> 3
 
|colspan="40%"|<!-- Description  --> Looking to other websites / sources for content
 
|colspan="40%"|<!-- Remarks  --> If you have used images only from '''Wikipedia Commons, please skip to STEP 4''', otherwise please approach your lecturer for assistance.
 
|-
 
|width="10%"|<!-- STEP --> 4
 
|colspan="40%"|<!-- Description  --> Final checks
 
|colspan="40%"|<!-- Remarks  -->
 
|-
 
|}
 
  
=== STEP 1 : Finding truly free images for your project ===
+
===User and talk pages===
+
* [http://www.mediawiki.org/wiki/Help:User_page User pages]
We would strongly encourage you to find pictures for use on your project at the links below :
+
* [http://www.mediawiki.org/wiki/Help:Talk_pages Talk pages]
 
+
* [http://www.mediawiki.org/wiki/Help:Signatures Signatures]
http://commons.wikimedia.org/wiki/Main_Page
 
 
 
When you use a picture from these websites, do '''ensure that at least one''' of the symbols below are found in the licensing details accompanying the image you intend to use.
 
 
 
{| class="wikitable centered" width="100%"
 
|width="30%"|<!-- STEP --> [[Image:Copyright_free.jpg|left]]
 
|colspan="60%"|<!-- Description  --> For more details on what each symbol indicates, you may wish to look at this link.<br><br> http://commons.wikimedia.org/wiki/Commons:Copyright_tags#Free_Creative_Commons_licenses.
 
|-
 
|}
 
 
 
'''BUT''' If you see '''any''' of these symbols, then you '''cannot use''' the image in your project.
 
 
 
{| class="wikitable centered" width="100%"
 
|width="30%"|<!-- STEP --> [[Image:Copyright_not_free.jpg|left]]
 
|colspan="60%"|<!-- Description  --> (These symbols generally mean that the copyright is unclear or that you will not be allowed to use the image / combine it with other materials).<br><br>For more details, you may wish to look at this link :<br><br> http://commons.wikimedia.org/wiki/Commons:Copyright_tags#Free_Creative_Commons_licenses
 
|-
 
|}
 
 
 
''Example of where the copyright symbols are located on a website (The picture below can be used for your project)''
 
 
 
[[Image:Copyright_image_symbols.jpg]]
 
 
 
'''STEP 2 : Attribute the owner of the image'''
 
 
 
''Example of how to reference the source of an image, when using it for your project''
 
 
 
[[Image:copyright_image_referencing.jpg]]
 
 
 
'''STEP 3 : Sourcing images from other websites'''
 
 
 
There are usually several complications with using images from websites (other than from '''Wikipedia Commons''') including:
 
 
 
# getting consent to use from the correct person;
 
# having to pay a fee to get the consent needed to use;
 
# a fine may be payable if content is used without consent and you wish to continue using it; '''and/or'''
 
# having to remove the content and amend the project, if consent is not given from the actual owner;
 
 
 
For these reasons, we would '''strongly''' encourage that you use media from the '''Wikipedia Commons''' website.
 
 
 
If you must use content from other websites, please approach your lecturer for assistance on this project.
 
 
 
'''STEP 4 : COMPLETE the CHECKLIST'''
 
 
 
Content clearance checklist
 
 
 
It is important to make sure that material used on your project (“content”) does not infringe intellectual property laws or is unsuitable for publishing on the internet.
 
 
 
If your answers are YES to all the questions in the checklist then content is safe to post on the internet.
 
 
 
If any of your answers is NO to any of the questions then you should contact your Professor to clarify before posting the content.
 
 
 
{| class="wikitable centered" width="90%"
 
!colspan="60%"|CHECKLIST
 
!colspan="30%"|RESPONSE
 
|-
 
|colspan="60%"|<!-- CHECKLIST  --> Is the content (picture, video, sound recording, text etc) licensed royalty free?
 
|colspan="30%"|<!-- RESPONSE  --> YES / NO
 
|-
 
|colspan="60%"|<!-- CHECKLIST  --> Give Has permission been given to you, by its relevant owner, to use the content? (Proceed to next question if your material is licensed royalty free from Wikimedia Commons)
 
|colspan="30%"|<!-- RESPONSE  --> YES / NO
 
|-
 
|colspan="60%"|<!-- CHECKLIST  --> Is the content free of privileged and/or confidential information on SMU administrative/communication/academic policy?
 
|colspan="30%"|<!-- RESPONSE  --> YES / NO
 
|-
 
|colspan="60%"|<!-- CHECKLIST  --> Is the content free of anything which may endorse hatred, strife or intolerance (ethnic, racial, political or religious) with the inclusion of any unsubstantiated, malicious, derogatory, libelous and/or defamatory comments?
 
|colspan="30%"|<!-- RESPONSE  --> YES / NO
 
|-
 
|colspan="60%"|<!-- CHECKLIST  --> Is the content free of anything which may promote outwardly or subliminally, glorify the gratuitous aspects of sex, nudity, violence, anti-social, discriminatory/anti-democratic behavior? 
 
|colspan="30%"|<!-- RESPONSE  --> YES / NO
 
|-
 
 
 
|}
 
 
 
== Using MediaWiki ==
 
 
 
 
 
=== Login ===
 
 
 
 
#Click on the '''Log in''' link at the top-right corner of your wiki.
 
#Type your SMU username and password into the grey authentication box, choose correct domain and click '''OK'''.
 
 
 
[[Image:Login.jpg]]
 
 
 
 
 
 
 
=== Setup your personal page ===
 
 
*A link (your username) to your personal page appears at the top of every wiki page once you have logged in. Clicking on this link will take you to your personal page.
 
 
 
*You can use this page to write about yourself.
 
 
 
[[Image:Personalpage.jpg]]
 
 
 
 
 
 
 
=== Add a page ===
 
 
 
#To add a new page on the wiki use double brackets.
 
 
 
 
 
<pre>
 
[[New page]]
 
</pre>
 
 
 
[[New page]]
 
 
 
== Editing ==
 
 
 
 
 
 
 
=== Editing a wiki page ===
 
 
 
 
 
 
 
You can edit either a whole page or just a section of a page.
 
 
 
To edit a whole page:
 
 
 
#Click on the '''edit''' tab at the top of the window. The content of the page will appear with an editing toolbar at the top.
 
#Make your additions or changes in the text area.
 
#Click the '''Save page''' button below the text area.
 
 
 
To edit a section of a page:
 
 
 
#Click the '''edit''' link that appears at the top of each page. The content of the section will appear with an editing toolbar at the top.
 
#Make your additions and changes in the text area.
 
#Click the '''Save page''' button below the text area.
 
 
 
 
 
=== Bulleted list ===
 
 
 
Type:
 
 
 
<pre>
 
* One
 
* Two
 
** Two point One
 
* Three
 
</pre>
 
 
 
 
 
* One
 
* Two
 
** Two point One
 
* Three
 
 
 
 
 
=== Numbered list ===
 
 
 
Type:
 
 
 
<pre>
 
# One
 
# Two
 
## Two point One
 
# Three
 
</pre>
 
 
 
# One
 
# Two
 
## Two point One
 
# Three
 
 
 
 
 
 
 
=== Bold text ===
 
 
 
Highlight the text you want to make bold and click on the '''bold text''' icon in the edit toolbar.
 
 
 
 
 
[[Image:bold.jpg]]
 
 
 
 
 
<pre>
 
'''Bold text'''
 
</pre>
 
 
 
'''Bold text'''
 
 
 
 
 
 
 
=== Italic text ===
 
 
 
Highlight the text you want to make italic and click on the '''italic text''' icon in the edit toolbar.
 
 
 
[[Image:italic.jpg]]
 
 
 
<pre>
 
''Italic text''
 
</pre>
 
 
 
''Italic text''
 
 
 
 
 
=== Internal links ===
 
 
 
#Go to a page on your wiki (e.g. https://wiki.smu.edu.sg/MGMT003/Special:Recentchanges).
 
#Copy the last part of the URL (e.g. Special:Recentchanges).
 
#Go to the page where you wish to add the link and click on the edit tab.
 
#Click on the Internal link button in the editing toolbar
 
 
 
[[Image:Internallink.jpg]]
 
 
 
5. Replace Link title with the last part of the URL (e.g. Special:Recentchanges).
 
 
 
 
 
 
 
<pre>
 
[[Link title]]
 
 
 
Change to
 
 
 
[[Special:Recentchanges]]
 
 
 
 
 
You can also add a display text
 
 
 
[[Special:Recentchanges|Special Pages]]
 
</pre>
 
 
 
 
 
[[Special:Recentchanges]]
 
 
 
[[Special:Recentchanges|Special Pages]]
 
 
 
 
 
=== External links ===
 
 
 
[[Image:Externallink.jpg]]
 
 
 
#Click on the '''External link''' icon in the edit toolbar.
 
#Replace the web address with your URL.
 
#Replace '''link title''' with a link description.
 
 
 
 
 
 
 
<pre>
 
[http://www.example.com link title]
 
 
 
Change to
 
 
 
[http://www.smu.edu.sg Singapore Management University]
 
 
 
 
 
To show the URL then simply type the full URL
 
 
 
http://www.smu.edu.sg
 
</pre>
 
 
 
 
 
[http://www.smu.edu.sg Singapore Management University]
 
 
 
 
 
http://www.smu.edu.sg
 
 
 
=== Table of content/headlines ===
 
 
 
#Highlight the text and click Level 2 headline icon in the edit toolbar.
 
 
 
[[Image:toc2.jpg]]
 
 
 
<pre>
 
==Section 1==
 
Text
 
 
 
===Section 1.2===
 
Text
 
 
 
====Section 1.3====
 
Text
 
 
 
==Section 2==
 
Text
 
 
 
</pre>
 
 
 
[[Image:Toc.jpg]]
 
 
 
=== Adding an image ===
 
 
 
This is a two-step process. First you need to upload your file, and then insert it into a page. As a rule of thumb, images should be no larger in file size than 100 Kb and no larger in physical size than 640x480 pixels.
 
 
 
#Click on '''Upload file''' in the toolbox menu on the left hand side.
 
#Click on the '''Browse button''' and select the image file you wish to upload from your computer.
 
#Click Upload file (note the exact name of the file).
 
#Go to the page or page section where you wish to insert the image.
 
#Click on the embedded file icon in the editing toolbar.
 
 
 
[[Image:Photo.jpg]]
 
 
 
6. Change “Example.jpg” to the name of the file that you uploaded.
 
 
 
<pre>
 
[[Image:Example.jpg]]          Uploaded picture full size
 
[[Image:Example.jpg|right]]    Picture aligned to the right
 
[[Image:Example.jpg|100px]]    Picture 100 pixels wide
 
</pre>
 
 
 
 
 
=== Upload and link to a document ===
 
 
 
It is a two-step process to upload and link to a file such as a '''PDF''', '''Word''' document or '''Excel''' spreadsheet.
 
 
 
#Click on '''Upload file''' in the toolbox menu on the left hand side.
 
#Click on the Browse button and select the file you wish to upload from your computer. Note the exact name of the file. 
 
#Click Upload file.
 
#Go to the page or page section where you wish to insert the image.
 
#Click on the File link icon in the editing toolbar.
 
 
 
[[Image:file.jpg]]
 
 
 
6. Change '''Example.ogg''' to the name of the file that you uploaded.
 
 
 
 
 
 
 
<pre>
 
[[Media:Example.ogg]]
 
 
 
change to
 
 
 
[[Media:Test.doc]]
 
 
 
You can also add a text to the link
 
 
 
[[Media:Test.doc|Test document]]
 
</pre>
 
 
 
[[Media:Test.doc]]
 
 
 
[[Media:Test.doc|Test document]]
 
 
 
 
 
 
 
=== Displaying a formula ===
 
 
 
 
#Click on the mathematical formula in the tool bar.
 
 
 
[[Image:formula.jpg]]
 
 
 
2. Add the formula in the tag.
 
 
 
=== Ignore wiki formatting  ===
 
 
 
#Highlight the word you do not want to be formatted.
 
#Click on Ignore wiki formatting in the tool bar.
 
 
 
[[Image:format.jpg]]
 
 
 
<pre>
 
[[micro-]]<nowiki>second</nowiki>
 
</pre>
 
 
 
[[micro-]]<nowiki>second</nowiki>
 
 
 
=== Add a signature ===
 
 
 
[[Image:sign.jpg]]
 
 
 
#Click on the signature tool icon in the editing toolbar. A combination of lines and squiggles will appear in the editing area.
 
 
 
<pre>
 
--~~~~
 
</pre>
 
 
 
--[[User:Magnuslb|Magnuslb]] 16:04, 22 June 2009 (SGT)
 
 
 
 
 
 
 
=== Add horizontal line ===
 
 
 
 
 
Click on the horizontal line icon in the editing toolbar.
 
 
 
[[Image:horizontal.jpg]]
 
 
 
 
 
<pre>
 
----
 
</pre>
 
 
 
 
 
----
 
 
 
=== Add e-mail address ===
 
 
 
Type:
 
 
 
<pre>
 
[mailto:YourID@smu.edu.sg Your Name]
 
</pre>
 
 
 
[mailto:YourID@smu.edu.sg Your Name]
 
 
 
 
 
=== Create a table ===
 
 
 
To create a table, you need to use code. The following example shows how to add a table of 4 columns and 2 rows.
 
 
 
 
 
#Go to the page or section you wish to edit.
 
#Click on the edit tab.
 
#Copy and edit the below code.
 
 
 
<pre>
 
 
 
{| class="wikitable centered" width="90%"
 
!Group
 
!Assigned Company
 
!Topic
 
!Students
 
|-
 
|width="2%"|<!-- Group--> Group 1
 
|width="10%"|<!-- Company--> [[Company 1]]
 
|width="10%"|<!-- Topic--> Your Topic
 
|width="30%"|<!-- Students--> Student 1, Student 2, Student 3, Student 4
 
|-
 
|width="2%"|<!-- Group--> Group 2
 
|width="10%"|<!-- Company--> [[Company 2]]
 
|width="10%"|<!-- Topic--> Your topic
 
|width="30%"|<!-- Students--> Student 1, Student 2, Student 3, Student 4
 
|-
 
|}
 
</pre>
 
 
 
{| class="wikitable centered" width="90%"
 
!Group
 
!Assigned Company
 
!Topic
 
!Students
 
|-
 
|width="2%"|<!-- Group--> Group 1
 
|width="10%"|<!-- Company--> [[Company 1]]
 
|width="10%"|<!-- Topic--> Your Topic
 
|width="30%"|<!-- Students--> Student 1, Student 2, Student 3, Student 4
 
|-
 
|width="2%"|<!-- Group--> Group 2
 
|width="10%"|<!-- Company--> [[Company 2]]
 
|width="10%"|<!-- Topic--> Your topic
 
|width="30%"|<!-- Students--> Student 1, Student 2, Student 3, Student 4
 
|-
 
|}
 
 
 
== Referencing  ==
 
 
 
#At the paragraph which you want to add the reference, type <nowiki><ref> reference text </ref></nowiki>.
 
#At the bottom of page in the edit box, type <nowiki>==References==</nowiki>.
 
 
 
Your references will be automatically generated. ''Check with your Professor to find out the preferred reference format for your class.''
 
 
 
 
 
Example:
 
 
 
Professor Howard Hunter is the president of Singapore Management University.<ref>http://www.smu.edu.sg/about_smu/president_message.asp</ref>
 
 
 
The sun is pretty big, but the moon is not so big.<ref>Brown, R (2005). "Size of the moon" ''Scientific press'', 77(4).</ref>
 
 
 
==References==
 
<References/>
 
 
 
 
 
 
 
<pre>
 
Professor Howard Hunter is the president of Singapore Management
 
University.<ref>http://www.smu.edu.sg/about_smu/president_message.asp</ref>
 
 
 
The sun is pretty big, but the moon is not so big.<ref>Brown, R (2005). "Size
 
of the moon" ''Scientific press'', 77(4).</ref>
 
 
 
 
 
==References==
 
<References/>
 
 
 
</pre>
 
 
 
== Administration ==
 
 
 
=== Restoring previous content ===
 
 
#Go to the page or section where you wish to restore previous content.
 
#Click the history tab at the top of the window. You will see a chronological list of all the changes that have been made to that page.
 
#Tick the version version you wish to restore and click '''compare previous version'''.
 
#If you are sure this is the version you wish to restore, click on the '''rollback tab'''.
 
 
 
=== Finding out who edited a page ===
 
 
 
To identify who made which contributions to a particular page:
 
#Go to the relevant page.
 
#Click the history tab at the top of the window. A chronological list of all the changes to the page will appear, with the editors' usernames next to their changes.
 
#Click on the circle next to a particular version and click Compare selected versions.
 
#You will see the changes made in that version in yellow on the left of the window, and later changes to those sections in green on the right.
 
 
 
=== How do I view all contributions by a user? ===
 
 
You can find all registered users for the wiki under
 
#Special pages (under tool box) -> User List.
 
#Copy the userid.
 
#Go to special pages ->  User Contributions.
 
#Paste the userid.
 
#Click search.
 
 
 
== Useful links ==
 
 
 
 
 
#[[Wikipedia:Wikipedia:Cheatsheet|Wikipedia Cheat Sheet]]
 
#[[Wikipedia:Wikipedia:Picture tutorial|How to insert images in Wikipedia]]
 
#[[Wikipedia:Wikipedia:Referencing|How to cite your sources in Wikipedia]]
 
#[http://www.mediawiki.org/wiki/Help:Links Syntax for linking in Wiki]
 
#[[wikipedia:Wikipedia:Manual of Style|Wikipedia Manual of Style]]
 
#[http://meta.wikimedia.org/wiki/Help:Contents MediaWiki User's Guide]
 
#[http://www.mediawiki.org/wiki/Manual:FAQ MediaWiki FAQ]
 
#[[Wikipedia:Singapore Management University|Wikipedia page about SMU]]
 
#[http://www.wikipedia.org Wikipedia]
 
#[https://wiki.smu.edu.sg Wikis in SMU]
 

Latest revision as of 19:38, 10 August 2010

Wikis at SMU

This information relates to wikis at SMU.

Wikipedia documentation

Some of this information is specific to Wikipedia, which uses several extensions to MediaWiki. Most of it also applies here, although you may find some advanced functionality that works differently. If in doubt, consult the MediaWiki documentation below.

MediaWiki documentation

These pages provide a simple introduction to MediaWiki. For advanced functionality, you can refer to the full documentation on the MediaWiki web site.

Reading

Basic editing

Intermediate editing

User and talk pages