Help:Hosting courses: Difference between revisions

From OpenWetWare
Jump to navigationJump to search
No edit summary
No edit summary
Line 30: Line 30:


===Set up your course template===
===Set up your course template===
Once you've registered for an OWW account, start by making your course banner.  Your course banner will be used on every course page to help identify it as belonging to your course and to enable students to navigate through the course.
Once you've registered for an OWW account, start by making your course banner.  Your course banner will be used on every course page to help identify it as belonging to your course and to enable students to navigate through the course wiki pages.
#First, go to [[Template:OWW.101|the OWW.101 template page]] (open this in a new browser window if you want to keep reading this text).
#First, go to [[Template:OWW.101|the OWW.101 template page]] (open this in a new browser window if you want to keep reading this text).
#Click [[Image:EditButton.jpg]] and copy all the wiki markup on that page.
#Click [[Image:EditButton.jpg]] and copy all the wiki markup on that page.
Line 37: Line 37:
#Click on the create this page link.
#Click on the create this page link.
#Paste the code from the OWW.101 template onto this page.
#Paste the code from the OWW.101 template onto this page.
#Replace every instance of OWW.101 with your course name and number.
#Replace every instance of <code>OWW.101</code> with your course number.
#Finally, check your work by clicking the [[Image:ShowPreviewButton.jpg]] button.
#Finally, check your work by clicking the [[Image:ShowPreviewButton.jpg]] button.
#Save the changes by clicking [[Image:SavePageButton.jpg]] ... and you're off.  
#Save the changes by clicking [[Image:SavePageButton.jpg]] ... and you're off.  
Next you'll probably want to replace the default course image with your own.
[[Image:Uploadfilelink.png|right]]
#Click on upload file link on the left side of the screen (under toolbox).
#Follow the directions from there to upload the file.  In general it is best if your course image is wider than it is tall and if it is in PNG format.
#After the picture has been uploaded, you will be taken to the Image page for your course image. 
#Copy the page title (i.e. '''Image:<What you named your picture>.png''').
#Return to your course template.  You can do this quickly by typing <code>Template:<Your course number></code> in the search box on the left.
#Click [[Image:EditButton.jpg]] and replace <code>Image:OWW101logo.png</code> with <code>Image:<What you named your picture>.png</code>
#Check your work by clicking the [[Image:ShowPreviewButton.jpg]] button.
#Save the changes by clicking [[Image:SavePageButton.jpg]].


===Set up your course homepage===
===Set up your course homepage===


Coming soon!
#First, go to [[OWW.101|the OWW.101 course homepage]] (again, open this in a new browser window if you want to keep reading this text).
#Click [[Image:EditButton.jpg]] and copy all the wiki markup on that page.
#[[Image:Searchbox.png|thumb|150px]] In the search box on the lefthand side navigation bar, type <code><Your course number></code> (be sure and replace <code><Your course number></code> with your course's number like <code>20.109</code> or <code>MCB100</code>. 
#You should see a page come up with a message saying '''"There is no page titled "<Your course number>".''' You can create this page." If you don't see this message then that means a page with that name already exists.  You'll need to choose a different course name (and [[Help:Renaming pages|rename your course template]]).
#Click on the create this page link.
#Paste the code from the OWW.101 course homepage onto this page.
#Replace every instance of <code><nowiki>{{Template:OWW.101}}</nowiki></code> with <code><nowiki>{{Template:<Your course number>}}</nowiki></code>.  This line is responsible for including the course banner on the page.
#Check your work by clicking the [[Image:ShowPreviewButton.jpg]] button.
#Save the changes by clicking [[Image:SavePageButton.jpg]].
 
Next you can customize the rest of the content on your course's homepage.
 
#Click [[Image:EditButton.jpg]] on your course's homepage.
#Between the line that starts <code><nowiki><div ...></nowiki></code> and the line <code><nowiki></div></nowiki></code>, feel free to put any information you want ... like a course description, an announcements section or anything else that might be helpful there.


===Set up your people page===
===Set up your people page===

Revision as of 14:33, 29 August 2006

This is a placeholder page for instructions and suggestions for hosting a course on OpenWetWare.

FAQ

Why should I host a course on OpenWetWare?

There are several motivations for hosting a course on OpenWetWare ...

  1. Enhance student participation in the course. Students have the ability to edit any page on OpenWetWare. So by placing course materials here, you are giving them the ability to revise (and improve) course content.
  2. Promote reuse of course materials. All content on OpenWetWare is dual-licensed under the Creative Commons Atrribution ShareAlike and GFDL copyright licenses. Thus, you are making your course materials freely available for others to reuse. Moreover, the wiki format allows people to more easily copy and modify your materials (as compared to static websites and PDF files) so you are also making it easier for others to build upon your work.
  3. Facilitate collaborative course development. Many courses are developed jointly among multiple faculty and teaching assistants. Placing the materials on OpenWetWare makes it easy to work together on developing course materials (as compared to emailing word documents back and forth).

Why shouldn't I host a course on OpenWetWare?

A common concern among many OpenWetWare users is that someone may accidentally or intentionally modify a page. However, all changes and updates are tracked and can be easily reverted. Nevertheless, course instructors do need to monitor their course site to ensure that errors are not introduced and propagated around the class.

Am I surrendering copyright to my course materials?

No, you retain copyright to all materials you upload or write on OpenWetWare. You can later republish and relicense them in any way you like. However, you can never retract the Creative Commons Atrribution ShareAlike and GFDL licenses for the versions you placed here.

How do I start?

Get an account

You'll need a user account on OWW to edit pages. Register for an account here.

Learn the basics of wiki editing

If you've never used a wiki before, it is helpful to learn some basics of wiki editing via the OpenWetWare introductory tutorial.

Once you're comfortable with the basics, continue with these directions.

Set up your course template

Once you've registered for an OWW account, start by making your course banner. Your course banner will be used on every course page to help identify it as belonging to your course and to enable students to navigate through the course wiki pages.

  1. First, go to the OWW.101 template page (open this in a new browser window if you want to keep reading this text).
  2. Click and copy all the wiki markup on that page.
  3. In the search box on the lefthand side navigation bar, type Template:<Your course number> (be sure and replace <Your course number> with your course's number like 20.109 or MCB100.
  4. You should see a page come up with a message saying "There is no page titled "Template:<Your course number>". You can create this page." If you don't see this message then that means a page with that name already exists. You'll need to choose a different course name.

  5. Click on the create this page link.
  6. Paste the code from the OWW.101 template onto this page.
  7. Replace every instance of OWW.101 with your course number.
  8. Finally, check your work by clicking the button.
  9. Save the changes by clicking ... and you're off.

Next you'll probably want to replace the default course image with your own.

  1. Click on upload file link on the left side of the screen (under toolbox).
  2. Follow the directions from there to upload the file. In general it is best if your course image is wider than it is tall and if it is in PNG format.
  3. After the picture has been uploaded, you will be taken to the Image page for your course image.
  4. Copy the page title (i.e. Image:<What you named your picture>.png).
  5. Return to your course template. You can do this quickly by typing Template:<Your course number> in the search box on the left.
  6. Click and replace Image:OWW101logo.png with Image:<What you named your picture>.png
  7. Check your work by clicking the button.
  8. Save the changes by clicking .

Set up your course homepage

  1. First, go to the OWW.101 course homepage (again, open this in a new browser window if you want to keep reading this text).
  2. Click and copy all the wiki markup on that page.
  3. In the search box on the lefthand side navigation bar, type <Your course number> (be sure and replace <Your course number> with your course's number like 20.109 or MCB100.
  4. You should see a page come up with a message saying "There is no page titled "<Your course number>". You can create this page." If you don't see this message then that means a page with that name already exists. You'll need to choose a different course name (and rename your course template).
  5. Click on the create this page link.
  6. Paste the code from the OWW.101 course homepage onto this page.
  7. Replace every instance of {{Template:OWW.101}} with {{Template:<Your course number>}}. This line is responsible for including the course banner on the page.
  8. Check your work by clicking the button.
  9. Save the changes by clicking .

Next you can customize the rest of the content on your course's homepage.

  1. Click on your course's homepage.
  2. Between the line that starts <div ...> and the line </div>, feel free to put any information you want ... like a course description, an announcements section or anything else that might be helpful there.

Set up your people page

Coming soon!

Set up your course schedule

Coming soon!

Other common tasks

How do I upload my lecture slides?

PDFs, word docs, powerpoint files or keynote files can all be uploaded to OpenWetWare.

  1. Click on upload file link on the left side of the screen (under toolbox).
  2. Follow the directions from there to upload the file.
  3. OpenWetWare doesn't explicitly support PDF, powerpoint or keynote filetypes. Therefore these files are treated as images and an image page is generated upon upload. To include a link directly to the PDF from your course page, you'll have to click on the filename from the image page and copy the corresponding URL from your browser.

For instance, here is a link to the image page of a PDF that has been uploaded to OpenWetWare: File:Msb4100025.pdf

Here is a link to the corresponding PDF file itself: http://openwetware.org/images/e/ef/Msb4100025.pdf