From Keywords for American Cultural Studies
Jump to: navigation, search

Editing Help

There's definitely a learning curve with editing and formating a wiki -- and an even greater learning curve with devising effective pedagogical strategies for integrating the technology into the classroom. Below are some tips for formating your collaboratory pages and managing your collaboratory. You should also reference Wikimedia for valuable editing tips.

Basic Formatting

The guidelines in the dotted sections below show you how the content should be entered in the 'edit' window (which you reach by clicking the "edit" tab at the top of any page). Once you're within that 'edit' window, you'll see a row of small boxes above the text, starting with one that contains a 'B.' These are the 'widgets' referred to below.


You can ''italicize text'' by using the italics widget or by typing 2 apostrophes on each side. 


 Similarly, you can '''bold text''' by using the bold widget or by manually typing 3 apostrophes. 

Bold and Italicized

 Five apostrophes will embolden and italicize '''''the text'''''.
  • Bulleted or Unordered Lists
To create a bulleted list, use an asterisk (*) to organize your points.
* Bulleted lists are easy to do:
** Start every line with a star.
*** More stars indicate a deeper level.
  1. Numbered Lists - and -
  2. Outlines
To create a numbered list, use the number sign (#) to prioritize your points. 
Multiple ## will create subpoints.
Numbered lists are:
## Very organized
## Easy to follow

Paragraph Breaks - and -

You can get a paragraph break by simply hitting 'enter' and starting on a new line.

Another way of creating paragraph breaks is to use the tag: <br> 
To create a tab or indentation, use a colon. 
: We use 1 colon to indent once.
:: We use 2 colons to indent twice, and so on.


Creating headers in your articles not only facilitate online readers who are more accustomed to scanning text; they also automatically generate a 'contents' box for your page if it has three or more headers.

== Section headings ==
To create headings, use equal signs around the text. 

=== Subsection ===
Using more equals signs creates a subsection.

Start with 2 equals signs not 1 because 1 creates H1 tags which should be reserved for the page title.


Links are essential for participants and site visitors to navigate your collaboratory.

External Links

To create a link to another website address, use the 'external link' widget.
<br> You can also create an internal link by entering one set of brackets around the text []. 

Internal Links

To create a link to a page within your collaboratory, use the 'internal link' widget.
<br> You can also create an internal link by entering two brackets around the text [[like this]]. 

Links also suggest to your students or other collaboratory participants that more content needs to be created to complete the topic or keyword. A incomplete link basically invites participants to contribute to making the article, topic, or keyword more complete. This is what the red link should signal to your students as they become more familiar with the wiki. When links are connected to another page or article, they appear dark blue.

Note the difference:
FAQs is a page that already exists.
Raymond Williams is a page that doesn't exist yet. You could create it by clicking on the link.

NOTE: If you’re creating an external or internal link and you’d like the link name to be different than the actual external page that you’re linking to, use a bar to divide the URL from the link name that will appear in the wiki.

This [| amazing website]

Creating New Pages

Creating new pages in a wiki is incredibly easy -- and very different than html. All you need to do is to create a link on an existing page, then click on the link and begin to edit the page that it opens.

Uploading Files

Occasionally, you may want to upload a file to accompany the work within your collaboratory. Students, collaboratory participants, and collaboratory leads can all upload image files. Once you're logged in, select 'Upload file' from the bottom left hand navigation and then follow the prompts. If you'd like to include another file type, such as a .doc or .pdf, please email the Keywords Project Coordinator to have it uploaded and made available to you.

To insert an image, use the 'image' widget that looks like a picture frame. You can also directly enter the image as an internal link: [[Image:image.jpg]]. To make the image a thumbnail, delimit the size and alignment of the image, as well as a caption: [[Image:image.jpg|thumb|right|150 px| Type the caption here]]

Managing Your Collaboratory

If you are the 'lead' of a collaboratory -- either as the instructor of a course or the main contact for a working group -- you will be in charge of managing and administering your collaboratory. Ultimately, using the Keywords Collaboratory in your classroom means that will you need to familiarize yourself with the wiki platform and envision how to leverage the technology for your pedagogy. The tips and guidelines listed below should help you with the technical side of managing and administering your collaboratory. Deborah Kimmey, the Keywords Project Coordinator, is available to help you troubleshoot and brainstorm how to best implement this new technology in your classroom or with your working group.

Create an entry page

  1. After you set up a collaboratory with Deborah Kimmey, the Keywords Project Administrator, you will be given a landing page that links from the left-hand navigation for your course.
  2. You will be asked to create a user name and password, and then send your user name along to the Deborah so she can give you 'lead' access to the collaboratory -- basically full editing privileges and user rights management.
  3. After you have been given lead access, you should complete the collaboratory description on your entry page. Keep in mind that this entry page is for both your students and the wider public of online users who will be visiting the site. It should also be clear from the description what sort of deliverable or product your collaboratory will be working toward.
  4. Next, think about how you want to scaffold the work within your collaboratory and then use this landing page to create links to new pages that you want your students to develop. This is easy to do: type what you want the article/page to be called and then use the widget in the editing screen to create an internal link. The page doesn't need to be developed or filled in yet; it will just be highlighted as a future work area that you'll be asking students to complete.

Setting up your group

  1. At the start of your course, walk your students through the website to give them a quick tutorial on how to access the collaboratory and how to create an account or profile.
  2. Ask your students to set up a profile complete with user ID, password, and email address. If your institution has an email address that students decide on when initially registering for courses, you may want to suggest that they use the same user name and email.
  3. Circulate a sign-in sheet where students let you know what user name they registered with on the site.
  4. After you receive everyone's user name, you will need to grant them 'participant' privileges to edit pages within the collaboratory. To do this you will need to do the following steps:
a. Log in under your own user name, which has been given special management rights and privileges.
b. Select 'Special pages' at the bottom of the left hand navigation, below the search box.
c. Select 'User rights management' under 'restricted special pages'
d. Then enter *each* student's user name and grant them 'participant' privileges by typing their user name and clicking the 'edit user group' button. A small window will appear below, where you will highlight or select 'participant' from the available groups and the 'save user group' to give them the right level of access to functions within the collaboratory.

Reviewing your work

As your students submit content for your collaboratory, the wiki will keep track of every saved revision. It will detail changes as they were submitted by particular users. You can access this history by simply clicking on the 'history' tab for any page.

There are some additional editing functions that you will have as a collaboratory lead.

  • You can 'rollback' changes within the 'history' tab, if you decide to revert to a previously saved version of the page.
  • You can also 'move' the page to a different section of your collaboratory by renaming the page to match its new link.
  • If you have difficulty locating a page after its link has been changed, select 'Special pages' and then click 'All pages.' You will then see a list of every page within the site and can select the page you need and rename it to match its link.

Other features

There are a number of other features and functions that you will have rights to as a lead of a collaboratory. Some of these are addressed in the FAQs. If you have other questions about the functionality of the wiki, please do not hesitate to contact us.