Mklesson is simply a program which takes as input a file called a ``lesson file'' (with the file extension .les). Mklesson produces a large set of WWW files in HTML format (with the file extension .html). You can create or modify the .les file using whatever text editor you prefer, and then run mklesson. The resulting HTML format files can then be used by tutorial users.
First, some terminology. Mklesson considers a tutorial to be a set of two or more lessons, numbered 1, 2, 3, etc. Each lesson consists of two or more sections, again numbered 1, 2, 3, etc. A section may optionally end with a question. Each section with a question has two or more responses to that question, each of them numbered 1, 2, 3, etc. Mklesson requires that exactly one response is correct; the rest are incorrect.
To invoke mklesson once it's installed, type:
mklesson lesson1.lesreplacing '1' with whatever the number of your lesson is.
Mklesson will create the following files in the current directory:
For each section: sLESSON-SECTION.html For each response: sLESSON-SECTIONrRESPONSE.html For each lesson outline: lessonLESSON.html For each processed file: lessonLESSON.tim (as a timestamp)where LESSON is the lesson number, SECTION is the section number, and RESPONSE is the response number for a given question.
Mklesson requires that the current directory contain the file "template", which provides mklesson with formatting information (how to generate the lesson sections, responses, and outline). You can edit this "template" file to give your tutorial a different look-and-feel, and/or to generate tutorial formatting for languages other than English (see the French template, for example).
Mklesson also uses the file "default" if it exists to set certain default values. If you are creating lessons for an existing tutorial, use the "default" and "template" files used by the tutorial creator. If you're creating lessons for an existing tutorial you will also need to set the PREVIOUS_LESSON and NEXT_LESSON location so that users can go backward and forwards to connected lessons.
Mklesson only changes files that ACTUALLY changed; thus, it's possible to run mklesson and not change any files. If no files are changed, that means that the lesson file, template file, and default file did not change enough to cause a change in the generated files.
Mklesson does _NOT_ generate the "master outline" or the home page of the tutorial, nor any auxillary files; you'll need to create those files in other ways.
Another somewhat similar program is available that generates tutorials for WWW browsing. However, it's an HTTP server, and thus it requires you to change your HTTP server. This is difficult for many people to do (for example, for security reasons). Also, it doesn't support distributed tutorials like mklesson does. Mklesson's input format is intentionally similar to this other tutorial's to ease transition of lessons and people.
If you're creating tutorial files for Lovelace (an Ada tutorial), talk to me first before starting, and read the guidelines for helping to expand Lovelace.
To install mklesson on your machine, create a new directory, download the collection of mklesson-related files into that directory, then gunzip and untar it. On many machines, the command to gunzip a file is "gunzip mklesson.tar", and the command to untar a file is "tar xvf mklesson.tar.gz", You will then find a big set of files, including mklesson (the program). Next, install the program perl if it's not already installed. Copy the file `blank.les' into a new lesson filename, and you're ready to go.
As noted above, mklesson requires a specific input format called the lesson file (.les) format. More information on the lesson file (.les) format is available.
You can also:
This page last modified on 10-May-1995.
David A. Wheeler (firstname.lastname@example.org)