|Generated: Monday, June 4, 2007, 13:04:58||Copyright © 2007 , Kurt Nørmark|
This installation guide applies to LAML (full and slim) and for the SchemeDoc distribution.
If you are on Windows 2000 or XP you should consider the easy LAML installation on Windows. (I have not tried LAML on Windows Vista yet). In order to use it you must obey certain rules regarding directory organization of both PLT Scheme and LAML. If you prefer, or if you need to, you can also use the general installation guide, as described below.The LAML software can be used with an arbitrary R4RS or R5RS Scheme interpreter. However, be aware that we use a few non-standard functions, which are described in the top level documentation file.
In order to enjoy the LAML software we recommend that you integrate it with the Emacs text editor. (If you are not an Emacs user, you can use LAML from a command prompt via the laml command, or from a Scheme interpreter via the laml procedure). Using this integration you can process a file f.laml via a single editor command (or a single key stroke), giving you the translated file f.html. In addition we provide a number of very helpful Emacs Lisp commands and templates.
Please notice that when you unzip the LAML zip file a laml directory is created for you. Thus, you do probably not want to make a laml directory yourself.
It is easy to setup the LAML system on Unix or a PC. After you have downloaded and unziped the LAML distribution zip file just follow these simple steps:
(load "laml-config.scm")By loading this file the procedure laml-config will be executed. This program checks your configuration, and it rewrites a number of files in the root of the laml directory, and in the LAML bin directory. It also provides a possibility to modify your Emacs init file ( .emacs ). If there are warnings, change the configuration file, and load laml-config.scm again. Be aware that the LAML configuration procedures uses the non-R4Rs functions file-exists?, directory-exists? and delete-file. MzScheme supports all of these. In Guile and SCM try (define directory-exists? file-exists?).
The configuration process inserts stuff in your Emacs init file in case the emacs-init-file property in configuration is a path to your .emacs file. The insertions are done at the end of the file. You will probably get a message from the installation process in case you need to make manual changes (for instance, if you need to delete an earlier version of the LAML stuff from you .emacs file).
If you use the time library stuff (lib/time.scm) - directly or indirectly - you should change the value of the variable time-zone-info to the appropriate value. Edit the file lib/time.scm.
After installation, restart Emacs in order to take advantage of the LAML emacs support. Perhaps you should check the .emacs file before, to make sure that everything is OK.
In the full distribution you can process all LAML examples by executing the LAML script in examples/process-all.laml.
Generated: Monday, June 4, 2007, 13:04:58