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

Please note that this page is currently under construction.

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 the instructor of a course, 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. We are 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. [mailto: E-mail us] to ask us to set up a Collaboratory. We will send you some instructions, and are always available to provide additional help.

Preliminary planning for your Collaboratory

Before the class begins 1. By the time you are reading this document, you should have already emailed your course title and number to, so a collaboratory can be created for you on the wiki. 2. Create an account at the Collaboratory and email your user ID to Elizabeth Cornell, the Keywords project coordinator. You will receive editing privileges for the wiki and for authorizing your students to edit the wiki, as well. 3. Your collaboratory’s home page has been set up using a template that we know works well, but you are free to revise it.

Naming a new wiki page 1. When you create a new page for your collaboratory, you must identify it as belonging to your class with these three elements: Keyword (or page) title, your name, and the semester. 2. Therefore, if your name is Dr. Smith, and you want a page called “Abolition” in the spring of 2015, the page should be called Abolition (Smith S15).

Creating and editing pages On the landing page of your collaboratory, there is a link to instructions for wiki mark up. There are many other resources on the web for editing wikis, too.

Introduce your class to the wiki and creating accounts 1. Walk students through the Collaboratory to show them what it is and how to create an account. This is best done in a setting where everyone can view the Collaboratory together. 2. Ask students to create their account and profile, and then share their user ID with you. A user IDs should be a first name with a last initial: John Smith should be “JohnS.” This helps protect identities.

Give students access to the wiki You are authorized to grant each student editing privileges within the Collaboratory. To do this, follow these steps: a. Log in to the wiki. b. Select Special pages, at the bottom of the left-hand navigation. c. Select User rights management. d. Enter a student’s user name (case sensitive) and click Edit user groups. Select that name from the list. e. Under Groups you can change, select Student and click Save user group. The student can now edit the Collaboratory. Do this for each student.

Training students to edit the wiki 1. It is recommended that your students each make a small contribution to a test area that has been set up for you. See the instructions for that on your collaboratory landing page. 2. Plan an in-class editing excercise. This will only work after you’ve granted them access to your space.

Consent to publication Every institution has its own protocol regarding publication of student work—an informed consent typically managed by a human subjects review board. Your syllabus should stress that the medium of this work effectively makes student writing available to a wide, online public.

Emphasize that students’ participation in the collaboratory signals their consent to this public forum. This implicit, informed consent should meet the standards in place at most colleges and universities, though it is advised that you check your institution’s requirements.

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.