How to prepare the online course units

You may supply arbitrary html-documents with embedded images and other features. For the lecture units the system will use only the code between the <body> and </body> tags. The default font and background color is defined in variables valid for the whole course.

Definition of the main text html-files

For an ordering structure of the content part, the html-texts may contain the following macros, which replaces in the final display by corresponding items:

[LASTREF=linkprevious NEXT=linknext]

sample : [LASTREF=U-1-2-000.html NEXT=U-1-4-000.html]

This command is obligatory (if you want an ordered sequence of course frames) and should be the first command in the visible html-text (i.e. between the <body> and >/body> tags). In the display this produces links to the preceding and following units as defined by the lecturer. The file names refer to files in the folder MyCourse/contents.

[EXLINK=external_link_URL  TEXT=some_text]

sample: [EXLINK=http://www.someone.com/grandpage.html TEXT=Check that wonderful page]

In the displayed text there will be a link to the external html-page with the given text. On activation the link is opened in a separate non-course window. All external links should be done in this way in order not to violate copyrights.

[INLINK=localfile.html TEXT=some_text]

example: [INLINK=U-3-5-001.html TEXT=Sect. 3.5, further material]

In the displayed text there will be a link to the local course-material-html-page with the given text.

Internal links to html-pages via INLINK will be interpreted as URLs relative to that directory MyCourse/contents.

Other explicit links not using INLINK (like the EXLINK-tag, the "A HREF"-command or the "IMG"-tag referring to images or movies) should be given as absolute URLs like

Coursehome/contents/imglocal/sample.gif
(e.g. /~xyz/MyCourse/contents/imglocal/sample.gif)

or in the form

../contents/imglocal/sample.gif

i.e. with a preceding "../contents/" and then the path relative to the folder contents.

example:

<IMG SRC="../contents/imglocal/mypic.gif">

or

<IMG SRC="/~xyz/MyCourse/contents/imglocal/mypic.gif">

[EXERCISE=localexercise.html TEXT=some_text]

example: [EXERCISE=U-3-5-003-A-3.html TEXT=Exercise 3.5.3.A.3]

In the displayed text there will be a link to the exercise-page with the given text. The html-file should be in the folder contents or its address should be given relative to that folder. On activation a separate exercise-window opens, giving questions and answers as specified in the page localexercise.html (definitions see below).

Definition of the exercise text html-files

The exercise should be ready as an html-file with the format:

Exercise x.x.x.

General text of the exercise.

[Question] Question or suggested answer

[Answer] Answer or explanation to that question

This sequence [Question]...[Answer]... may be repeated several times.

In the answers you may embed further Exercises (as usual: [EXERCISE=... TEXT=...]); you may not use the features [INLINK...] and [EXLINK...].

Whenever this exercise-file is ready (and access is allowed from the active server by suitably adding the read-flags to the file) you should insert the exercise in the course's data base via the link in the main lecturer's menu.

A complete update of the exercise is implied if you insert it again (with identical file name) .

The exercise is displayed in the left-hand part of a separate window. The multiple choice type solutions ([Answer]-fields) are randomly listed. When the student chooses one of these answers, there is a delay (default duration of 3 seconds, but the lecturer may change this parameter) before the answer file is displayed. There is no inbuilt grading of the answers, but the lecturer may introduce grading based on the protocol in the courses data base, which lists all entries and page accesses.

Secondary (e.g. images) files

Put the file in some folder of your choice (e.g. in $MYCOURSE/contents/imglocal; if you put it into $MYCOURSE/img, your images will be mixed with the standard course images, which is not advisable).

Dedicated files

Depending on the menu-entries, that the lecturer has defined, there may be need for further html-files like FrequentlyAskedQuestions.html, TableOfContents.html etc.

At the time of first installation there are a few obligatory files, which should be kept there, but can be adjusted (name, location and content) to the lecturer's needs. These files are:


contents/motd.html

contains a brief "message of the day" by the lecturer, which is displayed throughout the student session (in a separate frame). This is a standard html-file, processed like the other units, however without any of the special commands discussed above. It should not have any links but may, however, contain images. Since it is displayed in a small area, it should be short. The "message of the day" may e.g. indicate information of new items, extra mail by the lecturer, date and schedule of exams (or your favorite photo of the day). If this file does not exist the corresponding field in the left-hand frame remains empty.

contents/newlogin.html
Optional additional information (added to the login page) for new users who want to apply for a login id

modules/filedepot/template-index-in-userfolder.html
A template file for the file index.html in the user homefolders. Via this file the users may make files available to other course users.