Main

  • Welcome
  • Features
  • Installation
  • Documentation
  • Community

Getting started

There are several ways to install Common Lisp and Weblocks.

Using clbuild

clbuild is the easiest way to get started with Weblocks.

Perform the following steps:

  1. Prepare your clbuild installation as described on the clbuild homepage.
  2. Get SBCL.

    • Darwin users: build SBCL from source with thread support.
    • GNU/Linux users: install your distribution's SBCL or let clbuild build the latest version from CVS:
      $ ./clbuild compile-implementation sbcl
  3. Use clbuild to install Weblocks and cl-prevalence:
    $ ./clbuild install weblocks cl-prevalence
    (note: cl-prevalence is required by the demo)
  4. Run SBCL with clbuild:
    $ ./clbuild lisp
  5. Load the demo:
    * (asdf:oos 'asdf:load-op 'weblocks-demo)
  6. Start the demo:
    * (weblocks-demo:start-weblocks-demo :port 3455)
    (replace 3455 with some port that is currently not in use on your system)
  7. Check out the demo by pointing your browser at
    http://localhost:3455/weblocks-demo
  8. Use the demo as a starting point for your own application or generate a new base application named NAME in an existing directory DIR by issuing
    * (wop:make-app 'NAME "DIR")

Installer script

Aaron Feng wrote a shell script that lets you start a new Weblocks project from scratch; all you need is an installed SBCL.

Get it here: http://github.com/aaronfeng/weblocks-install/

Manual setup

We have several Mercurial repositories at Bitbucket.

The two official ones are

weblocks-stable
weblocks-stable, a tree that is synced at stable release points and receives only important bug fixes in between.
weblocks-dev
weblocks-dev, the tree where all the latest action is.

Saikat Chakrabarti has written a step-by-step tutorial on setting up SBCL and Weblocks from scratch on Darwin.