Quick Reference
From Help With Kumu Wiki
Video Introduction
The basics of editing a wiki page
This article covers the basics of editing a Mediawiki-based wiki (the same technology that powers http://wikipedia.org ) with creating a wiki for course work in mind. The videos will talk about and show how common tasks are preformed, the article also describes common tasks and features of the wiki.
Creating a new page/article
Creating a new page may not be intuitive, but it is simple. A new page/afrticle can be created in one of three ways:
- Just type a title in the search box on the left, if the page you want to create doesn't exist simply click "Create article", and start writing.
- You can also add an article's title to the and of the "base" URL for your wiki to create an article See [Starting a page through the URL].
- New pages can also be started by following a link to a non-existent page, which likewise launches the edit page.
- Links to non-existent pages are created with [[New page name]] from the wiki editor. (In this case, the empty page "New page name" would be created).
Editing Basics
- Click "edit" at the top of the page.
- Write as you normally would write.
- You can link to anywhere on the web by adding the address with the http:// at the start/
- You can link/create another wiki article by inserting the title between two [[ and ]] ie. [[no article]]
- You can create sections by placing == on either side of the title. ie. ==New Section==. Sub sections would be surrounded by ===, then ==== and so on.
You may also want to look at Creating an article and the Editing cheatsheet.
You are always welcome to press edit and just type your contribution. One of the best things about a wiki is if you can get your input into the wiki then someone else can format it latter. Hopefully seeing what they've done with your content will help you learn how to edit a wiki.
Editing Toolbar
The editing tool bar can help when formatting articles.
Article Toolbar
The editing toolbar is found that the top of every articled. This is where you can begin an edit by selecting Edit, track edits via History or discuss the article and its edits via Discussion. You can also add the article to your Watch list to receive updates when an edit you have made has been changed.
Adding External Links
External link can be added by simply pasting the full link into the article, including the http://, for example
http://www.example.org
You can also insert specific text in-place of a link by placing the link at the start of a set of single square brackets, then following the link with the text you would like to appears as the linked tie,, for example
Example Link
Links to Articles from the Brock University Collection of Journal Articles
How to create a link
Links to articles from journals provided by the Brock University library often work on campus but not off campus. The simplest way to create a link to a journal article is to find the 'persistent link' or 'permalink' and simply paste that link into the wiki.
Best Case Scenario: Persistent link
To find persistent links in databases such as Academic Search Premier, click on the title of the article you wish to reference. You will find a link next to the text 'Persistent link to this record.' This is the link (with the proxy server reference included) you should use.
More information about how to find a persistent link can be found on the Brock University Library's web site.
Exceptions: Create your own persistent link
If there is no 'persistent link' you can create one using the Link Checker. Paste the URL to the journal article that you want to link to. You will immediately be given a URL and you will find out if the link is available from off campus. If it is not available from off campus click 'Have it Added' and you will be contacted when the link is available.
Persistent links will look like: http://proxy.library.brocku.ca/login?url=http://www.jstor.org
Note that before the original URL is some extra information (http://proxy.library.brocku.ca/login?url= ) that will prompt the user if they are off campus to log in. You can often confirm that the link is suitable for posting in Isaak/Sakai by looking for "brocku.ca" in the link.
Examples
Upload a files/images
- Prepare the file for upload. Make sure the file is exactly as you want it.
- In the sidebar, under “toolbox”, click “upload file.”
- Click “Browse” next to the “Source filename” to locate the file on your computer (the name of the “browse” button depends on your web browser).
- Change the “Destination filename” to something descriptive, if necessary.
- Fill in the “Summary,” if necessary.
- Click the “Upload file” button.
If it is a large file, you may need to wait several seconds for the upload to complete.
Adding Images
The full syntax for displaying an image is:
[[File:{file_name}|{options}]]
Where options can be zero or more of the following, separated by pipes:
- border, frame, thumb, or frameless: Controls how the image is formatted
- left, right, center, none: Controls the alignment of the image within a text
- baseline, sub, super, top, text-top, middle, bottom, text-bottom: Controls the vertical alignment of the image within a text
- {width} px: Resizes the image to the given width in pixels
- {width}x{height}px: Resizes the image to fit within the given width and height in pixels; it is possible to specify only the height by writing x{height}px
- Note that the image will always retain its aspect ratio.
- link={destination}: Allows to link to an arbitrary title, URL or just nowhere
- link= : Will display an image without link, e.g.
[[File:Example.jpg|20px|link=Help:Images]]
→ 20px|link=Help:Images. - Note that link cannot be used in conjunction with thumb as thumb is always meant to link to the larger version of the image. In addition, link cannot be used with frame.
- link= : Will display an image without link, e.g.
The options can be given in any order. If the given options conflict each other, the latter is applied.
Wikipedia has an extensive image tutorial at http://en.wikipedia.org/wiki/Wikipedia:Picture_tutorial
Adding YouTube Video
In the case of a YouTube video you need to extract the ID of the video from the URL. In the example of http://www.youtube.com/watch?v=Wukv_tzR3YI the video's ID would be Wukv_tzR3YI, this is what is placed between the <videoflash> </videoflash> tags.
<videoflash>U5Lm6sZFzAM</videoflash>
How to add a footnoted reference
There are two steps to adding footnote-style references to wiki articles. You can use the and buttons as shortcuts.
Step 1
Beside where you would like to cite add the reference link include the tags <ref> </ref>. Contained withing the <ref> </ref> should be the actual reference as you would like it to appear at the bottom of the page.
Step 2
At the bottom of the page (or elsewhere on the page) add the tag <references/>. Standard practise is to all add the heading "Notes and References" above it, ie:
==Notes and References== <references/>
More information, including reusing a reference, can be found in the help article located in References Help Article.
Editing Cheat Sheet
Wikipedia CheatsheetFor more details, see How to edit a page | ||
Description | You type | You get |
Applies anywhere | ||
Italicise text |
''italic'' |
italic |
Bold text |
'''bold''' |
bold |
Bold and italic |
'''''bold & italic''''' |
bold & italic |
Internal link (within Wikipedia) |
[[Name of page]] | |
External link (to other websites) |
[http://www.example.org] | |
Sign your posts |
~~~~ |
Your username 21:04, |
Applies only at the beginning of the line | ||
Headings A Table of Contents will automatically be generated when four headings are added to an article. |
== Level 1 == |
Level 1Level 2Level 3Level 4Level 5 |
Bulleted list |
* One |
|
Numbered list |
# One |
|
Image Syntax |
[[Image:No free portrait.svg|thumb|Caption text]] |
Still stuck?
If you need further assistance please contact Matt Clare or Mike Brousseau via http://www.brocku.ca/ctlet/about-ctlet/staff