Publishing a Document Set

Steven Zeil

ODU Dept of Computer Science

August 3, 2010


Table of Contents

1. CS Dept Webservers
2. BlackBoard

Once the document set has been built, you will have a zip file, e.g., cs250Docs.zip. The next step is to publish that on a student-accessible website.

1. CS Dept Webservers

To publish on the http://www.cs.odu.edu server, copy that .zip file to an appropriate subdirectory within your ~/public_html directory and unzip.

Be aware that this, by default, gives you a site that anyone can access and that will (evenutally) be indexed by Google and other search engines. You can restrict access by adding a login/password requirement, and it's not hard to set up the site to use your students' Unix login names and passwords. Keep in mind that students can also read these files via Unix commands - anything served by the http:// server must be readable by all on the file system.

Faculty can publish on https://secweb.cs.odu.edu by copying that zip file to an appropriate subdirectory within their ~/secure_html directory and unzipping. Files in this directory can be protected against Unix-command access by students. The https:// server requires only that the files be readable by group faculty, not by the world. Web access is still wide open by default, however, unless you set up login/password protection. Another advantage of the https:// server is that login names and passwords are encrypted - on the http:// server they are passed as clear text.

2. BlackBoard

Upload the .zip file to your Content Collection area in Blackboard. (Note - the Content Collection area provides stable URLs for uploaded materials. Other technqiues for importing content to Blackboard may result in broken liks if you later upload another copy of the .zip file because you have changed some documents.)

Within your various BlackBoard content areas, you can create links to that uploaded .zip file, selecting the Special Action of "Unpackage this file". You will then be asked which document within the zip archive you actually want to show.

For a large document set, you might want to consider a single BlackBoard link to the document set's index.html or to the Topics document.