Category: 1. Wiki

Categories
1. Wiki

Using the UBC Wiki

What is the UBC Wiki?

The UBC Wiki is a shared space for use by students, staff, and faculty at the University of British Columbia. It serves as a course repository, a personal and collaborative work space, a documentation depository, and a growing guide to everything and anything UBC. The information, resources, and links that it contains are created, expanded, and annotated by its users. It is constantly evolving and changing because every member can add to it and edit any page. The UBC Wiki is administered by the Centre for Teaching, Learning and Technology.

This screencast provides a quick introduction and tour of the UBC Wiki:
YouTube Preview Image


Organization and Purpose

A wiki is a website that stores information which is collectively created and edited. The UBC Wiki is both an information repository and a collaborative writing space. It is organized into different collections to accommodate its different purposes:

  • The root of the wiki is open space for articles related to the University of British Columbia.
  • Course-based content or activities should go to Course space. Here is a sample.
  • Documentation space is provided for documentation, support and other similar content. Here it is in action.
  • The Sandbox is your place to test, play, and work with the UBC Wiki.




Integrating the UBC Wiki with the Learning Commons

The UBC Wiki acts as the content engine for the community’s online publishing framework. CTLT has developed a WordPress plugin, Wiki Embed, that allows you to publish content on the UBC Wiki to the Learning Commons site.

As a wiki intends to be a collaborative platform, multiple users (with permission) can edit a page on the UBC Wiki. When content is updated once on the wiki, that update is automatically rendered on the Learning Commons site and anywhere else it is published. This simplifies and consolidates the authoring process to the wiki.

If you use content across different sections on the Learning Commons, you no longer have to manually edit every single page!


Using the Wiki Embed Tool

  1. Go to the Page where you wish to embed wiki content to.
  2. In the text editor, click on “Visual” and click on the “Wiki Embed” icon.
  3. Copy the URL of the wiki page:
    e.g. “http://wiki.ubc.ca/Learning_Commons:Chapman_Learning_Commons/Technology”

  4. Paste the URL into ‘Wiki URL’ in the Wiki Embed box.
  5. Make sure the following are selected:
    • Update content every: day
    • Display a link to the source at the bottom
    • Top section converted into tabs
    • Remove edit links
    • Remove contents index


  6. Click ‘Insert’ and you should see code similar to this:
    [wiki-embed url=”http://learningcommons.ubc.ca/about/chapman-learning-commons/technology/” update=”1440″ source tabs no-edit no-contents ]

Note: We are experiencing problems when audio files are embedded into a wiki page using the Flash MP3 tag < flashmp3 >< / flashmp3 > and subsequently published on the Learning Commons. The audio file will not be published on the Learning Commons site and instead show up blank. Instead, please directly link to the audio file using the [URL] tag if you are using the wiki.

Categories
1. Wiki Creating a Page

Wiki Workflow

Do you have a learning or research commons project that you want to highlight on our resource site for students: UBC’s Learning Commons? If so, here are the steps to follow to get it done.

  1. Create your page in the Learning Commons namespace. See Learning Commons:Namespace Orientation. This will your index page for your content.
  2. Check that you have set up your page correctly once you have created it. If you see it on the index page for the Learning Commons, then you have created it correctly.
  3. Author your content on subpages within your wiki space. For example, your wiki space may look like this: Learning Commons: Land and Food Systems. An example of common subpages within a wiki spage will look like this:
    • Learning Commons: Land and Food Systems/Description
    • Learning Commons: Land and Food Systems/Services
    • Learning Commons: Land and Food Systems/HoursNote: Keep your subpage titles short.
  4. Review the Learning Commons:Writing Guidelines for tips on how to prepare your content and what you might want to include.
  5. Compile your subpage content into an information page for the Learning Commons site. You can do this easily using transclusion. With transclusion, you just add the reference code for each page that you want to include. It is best to call this aggregate page something generic like: About or Information.
  6. Request a page on the Learning Commons.
  7. Notify us when your page is ready to publish on the Learning Commons site.

If you need further support with any of this please contact Centre for Teaching, Learning and Technology.

Categories
1. Wiki Style Guide

Writing Style Guide (for Wiki)

What to Include

First, you’ll want to set up your page in the Learning Commons namespace. To do that, follow this workflow.

Once you have your page (index page) set up, you’ll want to create the following subpages. Do this by adding a slash after your index page and the following titles:

  1. /Description. A brief description of your program/department/unit/service and what it can do for the students and a link to your site.
  2. /Services. The services you offer and how they can be accessed.
  3. /Contacts. Any important front line contact information.
  4. /Hours. Any schedule information or hours of service (i.e. for tutoring).
  5. /About or /Information. This is where you can aggregate all or any of your subpages in preparation for publishing on the Learning Commons. See the workflow.

Of course you may have other subpages, that’s fine too–these tend to be the important pieces of content that students will be looking for.


Making Content Re-usable

  • Keep subpage titles short.
  • Create an About or Information page with basic information as above. Make this an easy process by using transclusion.
  • Consider page sections carefully. Page sections can be defined with page titles from transcluded content, OR as subheadings on a single page. Keep headings short and top level (==Level 2 headline==).
  • Subheadings within a section should not be actual ==headings== but instead just bolded and capitalized.

    Following these guidelines will ensure that tabs look reasonable of you plan to use these on your page. Here is an example of a page authored in the Wiki and published on the Learning Commons site: Resources for Distance Learning


    Style Guides for Wikis

    Writing Guidelines are basically the same in the wiki as they are for any other collaborative writing environment. It is helpful to set a few guidelines for your project when it involves collaborative writing: Here are a few sample Style Guides for Wiki projects:

    Tips specific to Wiki formatting: Hands On: 6 Things To Know

    Thanks for your contribution!

Spam prevention powered by Akismet