Quick Reference

From Help With Kumu Wiki

Revision as of 15:30, 15 January 2015 by Mclare (Talk | contribs)
(diff) ←Older revision | Current revision (diff) | Newer revision→ (diff)
Jump to: navigation, search


Video Introduction

The basics of editing a wiki page



An introduction hosted by Matt Clare from the CPI.

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:

  1. 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.
  2. 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].
  3. 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

  1. Click "edit" at the top of the page.
  2. Write as you normally would write.
  3. You can link to anywhere on the web by adding the address with the http:// at the start/
  4. You can link/create another wiki article by inserting the title between two [[ and ]] ie. [[no article]]
  5. 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.

Image:EditToolBar.png

Article Toolbar

Editing toolbar
Editing 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

display text


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
Example of a persistent link: EBESCO hosted journal example: Academic Search Premier
Example of a persistent link: EBESCO hosted journal example: Academic Search Premier

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

An explanation of how to add images, hosted by Matt Clare from the CTLET.
  1. Prepare the file for upload. Make sure the file is exactly as you want it.
  2. In the sidebar, under “toolbox”, click “upload file.”
  3. 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).
  4. Change the “Destination filename” to something descriptive, if necessary.
  5. Fill in the “Summary,” if necessary.
  6. 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.

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


An explanation of how to add footnotes and references, hosted by Matt Clare from the CTLET.

There are two steps to adding footnote-style references to wiki articles. You can use the Image:Button reflink.png and Image:Button references alt.png 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 Cheatsheet

For 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]]
[[Name of page|display text]]

Name of page
display text

External link

(to other websites)

[http://www.example.org]
[http://www.example.org display text]
http://www.example.org

[1]
display text
http://www.example.org

Sign your posts
on talk pages

~~~~

Your username 21:04,
28 March 2024 (UTC)

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 2 ===
==== Level 3 ====
===== Level 4 =====
====== Level 5 ======

Level 1

Level 2

Level 3

Level 4
Level 5
Bulleted list

* One
* Two
** Two point one
* Three

  • One
  • Two
    • Two point one
  • Three
Numbered list

# One
# Two
## Two point one
# Three

  1. One
  2. Two
    1. Two point one
  3. Three
 
Image Syntax

[[Image:No free portrait.svg|thumb|Caption text]]

Caption text
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

Personal tools
Bookmark and Share