downloads.html 5.53 KB
Newer Older
Mariano Montone's avatar
Mariano Montone committed
1
2
<a class="btn btn-primary float-right" href="/documentation"><i class="fa fa-arrow-right"></i>&nbsp;&nbsp;Read the documentation</a>

Mariano Montone's avatar
Content    
Mariano Montone committed
3
<h1><i class="fa fa-walking"></i> Getting started</h1>
Mariano Montone's avatar
Mariano Montone committed
4
5

<h2>Download and Install</h2>
6

Mariano Montone's avatar
Mariano Montone committed
7
8
9
10
11
12
13
<p>If you are a newbie or you want to get started as fast as possible, then <a href="https://portacle.github.io/">Portacle</a> is probably your best option. Portacle is a multiplatform, complete IDE for Common Lisp. It includes Emacs, SBCL, Git, Quicklisp, all configured and ready to use.</p>

<p>
  <a href="https://portacle.github.io" class="btn btn-primary"><i class="fa fa-download"></i>&nbsp;&nbsp;Download Portacle - All-In-One Common Lisp</a>
</p>

<p>Otherwise, Common Lisp comes in many different <a href="/implementations">flavors, or implementations</a>. Two popular ones are Steel Bank Common Lisp (SBCL) and Clozure Common Lisp (CCL).</p>
14
15
16
17
<ul>
  <li><b>Steel Bank Common Lisp (SBCL)</b>
    <ul>
      <li><a href="http://www.sbcl.org/">Main website</a></li>
Mariano Montone's avatar
Mariano Montone committed
18
      <li><a href="http://www.sbcl.org/platform-table.html">Download&nbsp;&nbsp;<i class="fa fa-download"></i></a></li>
19
20
21
22
23
24
      <li><a href="http://www.sbcl.org/getting.html">Install</a></li>
    </ul>
  </li>
  <li><b>Clozure Common Lisp (CCL)</b>
    <ul>
      <li><a href="http://ccl.clozure.com/">Main website</a></li>
Mariano Montone's avatar
Mariano Montone committed
25
      <li><a href="http://ccl.clozure.com/download.html">Download/Install&nbsp;&nbsp;<i class="fa fa-download"></i></a></li>
26
27
28
    </ul>
  </li>
</ul>
Mariano Montone's avatar
Content    
Mariano Montone committed
29

Mariano Montone's avatar
Mariano Montone committed
30
<p>Look <a href="/implementations">here</a> for other Common Lisp compilers.</p>
Mariano Montone's avatar
Content    
Mariano Montone committed
31

Mariano Montone's avatar
Mariano Montone committed
32
<p>You can also try Common Lisp online:</p>
Mariano Montone's avatar
Mariano Montone committed
33
34
35
36
37
38
39
40
41
42
<p>
  <button class="btn btn-primary" type="button" data-toggle="collapse" data-target="#try_lisp" aria-expanded="false" aria-controls="collapseExample">
    <i class="fa fa-play"></i>&nbsp;&nbsp;&nbsp;Try Lisp Online
  </button>
</p>
<div class="collapse" id="try_lisp">
  <p>This is a <a href="https://github.com/jscl-project/jscl">JSCL</a> Lisp REPL running on the Web. Note that it is not a complete Common Lisp implementation, but enough to have a taste of it:</p>
  <iframe style="width:100%; height: 400px;"  src="https://jscl-project.github.io/"></iframe>
</div>

Mariano Montone's avatar
Mariano Montone committed
43
<h2>Setup your environment</h2>
Mariano Montone's avatar
Mariano Montone committed
44

Mariano Montone's avatar
Mariano Montone committed
45
46
47
48
49
50
51
52
53
54
<p>A Lisp setup consists of three parts: a running Lisp instance, a text editor connected to that running Lisp instance, and project setup and libraries.</p>

<p>The most common way is to use <a href="http://www.emacs.org">Emacs</a> and <a href="https://common-lisp.net/project/slime/">SLIME</a> as text editor/IDE and <a href="https://common-lisp.net/project/asdf/">ASDF</a> + <a href="http://www.quicklisp.org">Quicklisp</a> for project setup and libraries.</p>

<p><a href="https://common-lisp.net/project/slime/">SLIME</a> is an extension to the Emacs text editor that connects the editor to the running Lisp image (called *inferior-lisp*) and interacts with it. It provides lisp code evaluation, compilation, and macroexpansion, online documentation, code navigation, objects inspection, debugger, and much much more.</p>

<p><a href="https://common-lisp.net/project/asdf/">ASDF</a> is the Lisp version of Make. It is used to define projects (called systems), its dependencies, and load and compile the project.</p>

<p><a href="https://www.quicklisp.org">Quicklisp</a> is a library manager for Common Lisp. Use it to download, install, and load any of over 1,500 libraries with a few simple commands.</p>

Mariano Montone's avatar
Mariano Montone committed
55
<p>For an introduction on how to set them all up, you can have a look at <a href="https://lispmethods.com/development-environment.html">this guide</a>.</p>
Mariano Montone's avatar
Mariano Montone committed
56
57
58

<p>You can also watch this video tutorial:</p>

Mariano Montone's avatar
Mariano Montone committed
59
60
61
62
63
64
<p>
  <button class="btn btn-primary" type="button" data-toggle="collapse" data-target="#setup_video" aria-expanded="false" aria-controls="collapseExample">
    <i class="fa fa-play"></i>&nbsp;&nbsp;&nbsp;Watch an introductory video
  </button>
</p>
<div class="collapse" id="setup_video">
Mariano Montone's avatar
Mariano Montone committed
65
  <iframe width="560" height="315" src="https://www.youtube.com/embed/VnWVu8VVDbI" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>  
Mariano Montone's avatar
Mariano Montone committed
66
67
</div>

Mariano Montone's avatar
Mariano Montone committed
68
69
70
71
72
73
74
<h2>Read about Lisp</h2>

<p>A good way to learn Lisp is to go through <a href="http://www.gigamonkeys.com/book/">Practical Common Lisp book</a>.
</p>

<p>Read <a href="/documentation">our documentation</a> for more options.</p>

Mariano Montone's avatar
Mariano Montone committed
75
76
<h2>Start a new project</h2>

Mariano Montone's avatar
Mariano Montone committed
77
78
<p>You may want check out <a href="http://articulate-lisp.com">Articulate Lisp site</a> for getting started on Common Lisp ecosystem.</p>

Mariano Montone's avatar
Mariano Montone committed
79
80
81
82
83
84
<p>
  <button class="btn btn-primary" type="button" data-toggle="collapse" data-target="#start_project_video" aria-expanded="false" aria-controls="collapseExample">
    <i class="fa fa-play"></i>&nbsp;&nbsp;&nbsp;Watch an introductory video
  </button>
</p>
<div class="collapse" id="start_project_video">
Mariano Montone's avatar
Mariano Montone committed
85
  <iframe width="560" height="315" src="https://www.youtube.com/embed/SPgjgybGb5o" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
Mariano Montone's avatar
Mariano Montone committed
86
</div>
Mariano Montone's avatar
Mariano Montone committed
87

Mariano Montone's avatar
Mariano Montone committed
88
<h2>Libraries</h2>
Mariano Montone's avatar
Content    
Mariano Montone committed
89

Mariano Montone's avatar
Mariano Montone committed
90
91
<p>Check out <a href="/libraries">this list</a> of Lisp libraries.</p>

Mariano Montone's avatar
Mariano Montone committed
92
<p>The easiest way to download and load libraries is via <a href="http://www.quicklisp.org">Quicklisp</a>.  <a href="http://articulate-lisp.com/quicklisp.html">Follow these instructions</a> to get started.</p>
Mariano Montone's avatar
Content    
Mariano Montone committed
93

Mariano Montone's avatar
Mariano Montone committed
94
<h2>Resources</h2>
Mariano Montone's avatar
Content    
Mariano Montone committed
95

Mariano Montone's avatar
Mariano Montone committed
96
97
<p>Here's a list of alternative guides for getting started:
  <ul>
Mariano Montone's avatar
Mariano Montone committed
98
99
100
101
    <li><a target="_blank" href="https://lispmethods.com/development-environment.html">Getting Started With Common Lisp</a> at lispmethods.com.</li>
    <li><a target="_blank" href="https://cliki.net/Getting%20Started">CLiki guide</a>.</li>

    <li><a href="http://articulate-lisp.com">Articulate Lisp site</a>.</li>
Mariano Montone's avatar
Mariano Montone committed
102
103
  </ul>
</p>