Generated: March 26, 2002, 13:59:27 Copyright © 2002 , Kurt Nørmark The local LAML software home page

LAML Installation Guide

This installation guide applies for version 15, and later versions, of LAML.

The LAML software can be used with an arbitrary R4RS 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 a 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.

I currently use the LAML software in the following configurations:

  1. On Unix (Sun) running Solaris 2.7 with GNU Emacs and MzScheme as Scheme system.
  2. On a PC with NT4.0/Win2000 and mzScheme and GNU Emacs
Until recently I used LAML with SCM on UNIX. Also I used it on Windows 98 with MzScheme.

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:

  1. Edit the file laml-config/configuration (relative to your new LAML directory) using your favorite text editor. Just follow the directions in the file.

  2. Start your scheme system in the laml-config directory via the command prompt (or a Unix Shell).

  3. Load the Scheme file laml-config.scm :
      (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. 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?).

  4. If you want to activate laml from a command prompt (shell), ensure that the bin/laml file (and bin/absolute-laml if you depend on it) is executable on Unix: chmod 755 laml . In addition, add the laml bin directory to your path, such that the laml command can be executed directly. (On unix edit .cshrc, on a PC with win95/98 edit autoexec.bat, or on NT/Win2000 go into the environment part using the control panel).

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).

In order to try out your LAML installation I will recommend that you take a look at the examples in the examples dictionary. Try, e.g., the simple pages from examples/simple-html4.0-loose/ first. Recall that when you process a file, say f.laml, LAML creates f.html , at least in the simple examples. Try processing the various files with laml extension in the example directories, and watch the results in your browser and on the corresponding html files. Use either the LAML Emacs interface (C-o or C-i), the laml command from the command prompt or shell (not on NT4.0), or the laml function from your Scheme interpreter to process the LAML files (see details in the main index file ). You can visit the example pages (both in HTML and LAML) from the examples column of the table in the index page of the distribution. Using the examples as patterns, and of course the manuals provided with the distribution, it will be easy for you to create your own LAML pages. Enjoy!  

By the way, did you remember to carry out the informal registration of LAML ?  

 

Kurt Nørmark
normark@cs.auc.dk
http://www.cs.auc.dk/~normark/

Program Oriented Web Engineering - using LAML  

 

Generated: March 26, 2002, 13:59:27