Instructions for building a course page

Table of Contents

Back to the NSCI 001 Course Page

The minimal course page

When you decide to build a course page, there are several choices, and therefore several decisions that have to be made. We will discuss the issues involved in a logical order. We will describe fully what must be done to build a course page in a course account on Owlnet, however much of what is here applies even if other choices are made.

Where to put the course page

The course page can be a file on any computer which has a World Wide Web (WWW) server, and which is readily available to the students at Rice. The second requirement means that you should not put it on a computer which is turned off at night.

There is also a security issue here. Some of the best systems administrators on campus are of the opinion that putting a WWW server on a computer may make it accessible to unauthorized breakin. Frankly, others disagree. Clearly this is an issue that must be addressed by every user. The alternative to putting course pages on personal or departmental machines is to put them on Owlnet. The security questions still exist on Owlnet, but at least the course pages are all in one place, and the Owlnet staff is aware of the problem.

Putting the course page on Owlnet makes it more accessible to the students, both to those enrolled in the course and to those who want to browse. On the other hand, putting the course page on a computer which is more accessible to you facilitates the many changes you will be making in a course page. However, in my mind the security issue is serious enough to weigh the balance heavily in favor of using Owlnet.

If you wish to consider running your own server, see the W3 Server Software list of WWW servers. If you decide to put the course page on a departmental or personal machine, then you are on your own. Here we will describe what is necessary to get a course account on Owlnet, and to install the course page in that account.

Getting a course account on Owlnet

To get a course account on Owlnet, you must first have a personal account. The procedure for getting either a personal account or a course account is the same, and it is computerized. You can initiate the procedure in any of three ways. In all three cases, from this point on it is only necessary to follow instructions. You will need to know your social security number or your Rice ID number. When applying for a course account you should have in mind this same information for other people, such as course assistants, who will need access to the account. However, this and other information can be changed or provided at a later date.

It will take a day or two to process your application, but you can check the progress using any one of the three procedures described earlier. Again log in as apply. When the account is approved, you will have to take a hike to Mudd to pick up the account information, and then you are ready to go.

A course page is only one of the many advantages that is provided by an Owlnet course account. For a complete description see the Faculty Guide to Owlnet.

Installing the course page

From here on the procedure is basically simple, although the details may be troublesome. In the course account create a directory with the name public_html. Put your course page into this directory with the name index.html. You need to put any ancillary files you create into the same directory.

To accomplish these tasks, it is necessary to work in the course account, using UNIX. The most straightforward way to access the course account is from an Owlnet workstation. Log in with the course name as the user name. It is possible to access the account remotely from almost any computer on the network, probably including the one in your office. The details of doing this depend on local conditions, so it is best to consult a departmental systems administrator or the divisional support team from Information Services.

When connected to the course account, enter the following commands.

   cd
   mkdir public_html
   cd public_html
The first command, cd, makes sure that you are in the course account's main directory. The second, mkdir public_html, creates a subdirectory with the name public_html. The third command changes your location to that subdirectory. This is the place to put the index.html file.

These few commands are almost all of UNIX that it is necessary to know. To be on the safe side there are a few more basic UNIX commands that you should understand.

Your new course page will be accessible at the URL http://www.owlnet.rice.edu/~youraccountname.

Working on the course page

Now you have to make a decision. How do you want to work with the course page? How do you get the file index.html to the public_html directory, and how do you edit it? There are two possibilities.

The most direct way is to work on Owlnet, either at one of the Owlnet workstations, or remotely. Use Mosaic to access the NSCI 001 Course page, and save the source file with the name index.html in the subdirectory public_html (see the next section). Then use an editor to edit the file. Of course this method requires learning something about UNIX and how to use an editor. However, almost everything you need to know about UNIX is on this page, and an editor is just a dumb word processor, so this is not nearly as difficult as it might sound.

The second method is to work on your own computer, downloading the source file as before, editing the file as needed, and examining the result using a local browser. When everything works to your satisfaction, transfer the file to the public_html directory in the course account with the name index.html. The file transfer is easily accomplished using ftp. From a networked Mac you can use Fetch, and from a PC, PC FTP. (For more details, see Creating HTML Documents on Macs and PCs. In this document, substitute Owlnet wherever you see RUF.)

The first method is more difficult to set up, and it requires some basic knowledge of UNIX and how to use an editor. However, once it is set up, the connection can be easily repeated, and used to make changes as necessary. The second method requires knowing how to ftp a file, which is much easier than learning UNIX and the use of an editor. However, the second method makes it more difficult to make small changes to the course page. There is no clear choice here. It is up to you.

Getting a copy of the course page template

Since you got this far, you are using a WWW browser of some sort. It should be possible to retrieve a copy of the template using your browser.

For example, if you are using Netscape, move back to the NSCI 001 Course Page. Then select source... from the View menu. You will be presented with a copy of the source document for the template. By clicking on the Save ... button, and following instructions, you will be able to put a copy of the template where you want it.

If you are using Mosaic, move back to the NSCI 001 Course Page. Then choose Save as... from the File menu. You will be presented with a Save Document window. In the middle there will be pop-up menu labeled Format for saved document:. Select HTML from this menu, and then choose where you want the template.

If you are using a different navigator, there is undoubtedly a similar procedure that will achieve your purpose.

Instructions for modifying the template

When you view the source document of the template for the first time, you will notice many instructions enclosed between left angles < and right angles >. These indicate that the template is in HyperText Markup Language (HTML) . The letters between the angles are code that tell the navigator how to format the document. However the template is designed so that the user can make changes easily, and without coming to grips with the intricacies of HTML. It should be a matter of simply replacing existing text, lists, and tables with your own.

The source document for the template is an ASCII or a text document. It can be edited in any text editor or word processor. If you do use a word processor, be sure to save the document as text after you are through. It is best to use a monospaced font.

Text

Textual material is really easy. Simple enter what you want. The most important thing to know is that it is necessary to put a paragraph tag, <p>, between paragraphs. HTML will format the text to fit the space available in the window. You do not have to be careful about spacing of words and lines.

If you want to break a line without inserting the extra space for a new paragraph, insert <br>. This is called a line break.

If you want some text to appear in bold face it is necessary to put it between <b> and </b>, e.g. <b> some text </b>. Italics or slanted text must be inserted between <em> and </em>.

You will notice that the template has these code segments in upper case type, while the examples here are in lower case. The fact is that HTML is insensitive to case.

Lists

There are three examples of lists in the template. The list under Exams is an unordered list. Such lists are started with a <UL>, and ended with a </UL>. Notice that each list item must be prefixed with <LI>, and this results in a new list item preceded with a bullet. (If you do not want bullets at the start of list items, see the next two paragraphs.)

The list used in Homework is called a definition list. These are started with <DL>, and ended with </DL>. Each list item has two parts. The first is called a term, and is prefixed with <DT>. The second is called a definition, and is prefixed with a <DD>.

Definition lists are also used in the section staff. Here a separate list is used for each person on the staff, with the name of the person being the term, and the information list providing the definition. Notice that <br> is used to terminate each line. The result is a list without bullets.

Lists are a little complicated. In more complicated situations they can be nested to good effect. (See the Table of Contents for this page.)The lists in the template are separated so that they can be easily modified, duplicated, and deleted to suit your purpose.

Tables and other preformatted text

An example is the table under Grading:. Since there are no tabs in HTML, preformatted text is the easiest solution for entering tables. It is necessary to enter <pre> before you start a table, then enter the table formatted exactly as you want it, and finally enter </pre> when you are finished. You will find it very difficult to preformat text correctly if you are using a font which is not monospaced.

Signing your page

Every web page should include the name of the person responsibile for maintaining the page, together with an email address. Preferably there should also be a modification date.

Going beyond the minimum

The minimal course page described in the template may be all that your course requires. However, many courses have already gone beyond the minimum to good effect. This is an individual project with a wide variety of possiblities, so we cannot tell you how to proceed. We will content ourselves with providing examples, and references to tools and resources that will be useful in such a project.

Examples of course pages

One of the fastest ways to learn how to improve your course page is to emulate others. Most browsers have the capability of allowing you to see the source of the document your are reading. It is therefore very easy to copy the ideas of others. In doing so you should be aware of the copyright issues involved.

There are now a large number of courses that have course pages. Here is what the list looked like in May 1995.

Bios 321: Animal Behavior

Caam 210/211: Introduction to Engineering Computation

Chem 105: Introductory Lab in Quantitative Chemistry

Hart 205: The History of Art

Hart 331: Film and TV Authors: Kubrick, Scorsese, and Mekas

Hist 333: Galileo in Context

Math 211: Ordinary Differential Equations and Linear Algebra

Nsci 230: Computation in the Natural Sciences

Each of these pages is interesting. Each of them has something that is not present in the others. Your attention is especially directed to the Nsci 230 page. This course page brings together all of the information a student will need to participate in the course.

The most highly developed of these course pages is Hist 333, Galileo in Context, and its link to the Galileo Project. Visiting it is a must, especially if you have any interest in the history of science and Galileo's place in it. However, be warned. You will be fascinated. Do not enter here unless you are willing to spend some time.

Tools and resources

If you are going beyond the minimum the first thing to do is to learn more about the HyperText Markup Language (HTML). A good place to start is with A Beginner's Guide to HTML. This reference provides a lot of examples, and a clear explanation of all the HTML codes. A source that starts from the beginning and provide links to other sources is Introduction to HTML. A general discussion of the process can be found in The Sixty-second Web Builder.

There are many other resources available on the Web. A good list is in the AboutRiceInfo page put together by Information Systems. Another general source is Creating Net Sites, provided by the Netscape Communications Corporation.

Rice Information Systems has already made a lot of their information available on the Web. Some of what they have to offer is referred to in the course pages listed earlier. In fact Information Systems contributed significantly to the most of those pages. The following is a partial list of starting points through which to access their information.

There is a further list of Information Services documents in the Nsci 230 course page.

Information about UNIX and editors will also be useful.

Finally, one of the most attractive features of HTML documents is the ability to integrate in line graphics. Instructions for doing this are in the documents on HTML refered to earlier. However, you should realize that copyright restrictions apply to graphics as well as to other intellectual property. Before using a graphics object, be sure that it is in the public domain, or that you have the proper permission.

There are a large number of graphics available on the Web. To begin with, you can find a small collection of graphics on Owlnet in /home/nsci001/public_html/icons. If you are working on Owlnet, you can simply copy them to your course account. To find a larger collection you can use Yahoo. An even more extensive source is Images, Icons, and Flags. It is also possible to take your own graphics, i.e., photos, maps, etc., and scan them into the computer. Information on how to do this at Rice is available. It is necessary that the documents be saved in the GIF format.

Copyright issues

A minimal course page should not cause any problems with the copyright laws, and the issues of intellectual property. However, the mere existence of the WWW creates new problems in this area. These issues are discussed in An introduction to copyright issues for WWW publishers at Rice.

Getting help

Start with your departmental systems administrator, if there is one. For every division there is a divisional support team, which is part of Information Services. If your divisional team doesn't know the solution to your problem, they will undoubtedly know where to find the solution.

Back to the NSCI 001 Course Page

This page is maintained by John C. Polking, polking@rice.edu
Last edited 5/22/95.