A notebook-style in-browser editor for Common Lisp.
Tools, of course, can be the subtlest of traps. One day I know I must smash the
with apologies to Neil Gaiman
This is now a pre-beta
Use it at your own risk, and expect occasional, minor explosions
- Install a Common Lisp (I suggest
- Hop into a Lisp and do
(ql:quickload :cl-notebook), followed by
Download this, run it (if you downloaded the tarball instead of the naked binary, unpack it first, obviously)
At the moment, we've only got binaries for 64-bit Linux. Submissions for other architectures welcome.
These help you manage Common Lisp distributions. They are usefull not only for running cl-notebook, but for any other CL project, so consider them regardless of whether you want this project.
cl-notebook directory you cloned to, do:
qlot install qlot exec roswell/cl-notebook.ros --port 4242
cl-notebook is Running
Hop into a browser and go to
localhost:4242/ (or whatever port you chose)
A quick-ish, and now slightly out-of-date video demo is available here to get you sort-of-started.
Building the Binary
qlot exec ros build roswell/cl-notebook.rosin the
That will create a binary with the appropriate name that you can directly run on any machine of your OS and processor architecture. - Grab your binary at
This should work under the Linux, OSX and Windows.
In order to build the
cl-notebook binary, you need to
- Install a Common Lisp (I suggest, and have only tried this with,
- Install and build
- Create an appropriate
build.manifestfile for loading
build.manifestfile, along with
- a bunch of
--load-systemcalls that include everything
cl-notebook::read-staticsto include all the associated static files along with the binary
--outputof your choice of binary name (I suggest "
- a bunch of
That will create a binary with the appropriate name that you can directly run on any machine of your OS and processor architecture.
If you're on a Debian-based linux distro, there is a
build.sh included in the
build/ subdirectory of this repo that do most of the above for you. All you need to do is make sure to install
sbcl, then call
sh build.sh in the
build directory. This will result in a
buildapp binary and a
cl-notebook binary being generated for you. The
cl-notebook binary can then be run on any linux machine (of the same CPU architecture) without worrying about installing a Lisp.
TODO - patches welcome, since I'm not an OS X user
TODO - patches welcome, since I'm not a Windows user
AGPL3 (also found in the included copying.txt)
Do whatever you like, BUT afford the same freedoms to anyone you give this software or derivative works (yes, this includes the new stuff you do) to, and anyone you expose it to as a service.
- Inaimathi <firstname.lastname@example.org>