==============
 Installation
==============

Setup your Common Lisp environment
==================================

You can skip this section if you already have a comfortable Common Lisp environment.


Common Lisp implementation
--------------------------

First you must choose a Common Lisp implementation.

Weblocks is designed and implemented to be portable and should run on the most popular
Common Lisp implementations. It is currently tested best on SBCL and Clozure CL, though.


Development environment setup
-----------------------------

There are at least two fundamentally different development approaches for using
Common Lisp:

* Editor-centric development: you access all Lisp functions from within your editor.

  Example: Emacs/Slime, Vim/Slimv, Lispworks/IDE.
    
  Incremental development happens mainly on the S-Expression level. This means that you
  edit a SEXP and send it with the help of editor directly to your Lisp image, which
  evaluates it, thus affecting the current Lisp environment.
  
* UNIX-style development: one tool for each job. The editor is not all that important
  here (as long as you're comfortable with it and it supports at least a basic level
  of paren highlighting.
    
  Example: Vim and your favorite terminal emulator. You start Vim in one window and
  your Lisp in another. Interaction happens by reloading your applications ASDF system
  and simple copy/paste of snippets.

We will try to be largely agnostic of the development approach in this manual which actually
means that we tend towards the second approach: Lisp calls are referred to by what you'd
type in your REPL, not by Emacs shortcut as it is often the case.

For a basic comfortable SBCL setup, see :ref:`Basic SBCL setup`.
 

Installation
============

.. note:: The official quicklisp distribution contains an old Weblocks
          version.

          This documentation is about newer Weblocks, built from
          ``reblocks`` branch. It is only available on the
          Ultralisp.org.

The easiest way to install Weblocks and additional libraries is to use
https://ultralisp.org distribution. It is Quicklisp compatible. To
install Weblocks from Ultralisp, do eval these commands in your REPL:

.. code:: common-lisp-repl

   CL-USER> (ql-dist:install-dist "http://dist.ultralisp.org/"
                                  :prompt nil)
   CL-USER> (ql:quickload :weblocks)

If you are using `Qlot`_ to pin versions, you can add such lines into your
``qlfile``::

  dist ultralisp http://dist.ultralisp.org/
  ql :all :latest
  ultralisp :all :latest

Run ``qlot update`` after these changes, and new Weblocks will be
available to install.


.. _Qlot: https://github.com/fukamachi/qlot