Skip to content

Commit e30633e

Browse files
committed
installation/ncurses: one single page (instead of one by platform)
1 parent 64d688c commit e30633e

File tree

6 files changed

+138
-239
lines changed

6 files changed

+138
-239
lines changed

content/en/_index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ Many languages are supported with Lem's **built-in LSP support**.
2121

2222
In addition, after installing lem, you can start developing in Common Lisp and extend the editor while it runs.
2323

24-
{{< button size="large" relref="installation/ncurses/linux" >}}Getting Started{{< /button >}}
24+
{{< button size="large" relref="installation/" >}}Getting Started{{< /button >}}
2525

2626
## Feature overview
2727

content/en/installation/additional_programs.md

Lines changed: 0 additions & 12 deletions
This file was deleted.

content/en/installation/ncurses/_index.md

Lines changed: 137 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,3 +3,140 @@ title: Lem ncurses
33
weight: -20
44
geekdocCollapseSection: true
55
---
6+
7+
8+
## Linux AppImage, MacOS and Windows binaries
9+
10+
[Lem has nightly releases](https://github.com/lem-project/lem/releases)! for Linux, MacOS and Windows.
11+
12+
13+
### How to Fix “App Is Damaged and Can’t Be Opened” on OSX
14+
15+
Copy the app file to the applications folder and type the following in your terminal:
16+
```
17+
xattr -d com.apple.quarantine /Applications/lem.app
18+
```
19+
20+
## Installation with Docker
21+
22+
Use the ready-to-use Lem image in the GitHub Container Registry:
23+
24+
$ docker run --rm -it ghcr.io/lem-project/lem:latest
25+
26+
27+
or clone the Lem repository and build the Docker image:
28+
29+
$ docker build -t lem .
30+
31+
You can now run it:
32+
33+
$ docker run --rm -it -v .:/shared lem
34+
35+
36+
## Debian/Mint/Ubuntu
37+
38+
There is an automatic installer that works on Debian, Linux Mint and Ubuntu.
39+
40+
Before that, install the dependencies:
41+
```
42+
sudo apt install sbcl curl git
43+
```
44+
45+
Now, run the command that will install Lem:
46+
{{< expand "Check the script! (it runs sudo to install more depencies regarding ncurses)" >}}
47+
48+
The sh script is located here https://lem-project.github.io/linux_installer.sh which downloads
49+
50+
the lisp file that is interpreted for SBCL, it can be checked here https://lem-project.github.io/linux-installer.lisp
51+
52+
53+
{{< /expand >}}
54+
```
55+
curl -L https://lem-project.github.io/linux_installer.sh | bash
56+
```
57+
58+
Important places from the script installation:
59+
- `$HOME/common-lisp/lem` (Lem installation location)
60+
- `/usr/local/bin/lem` (Lem symlink)
61+
62+
63+
## Installation from scratch
64+
65+
- [sbcl](https://www.sbcl.org/)
66+
- [ncurses](https://invisible-island.net/ncurses/announce.html#h2-overview)
67+
- [qlot](https://github.com/fukamachi/qlot)
68+
- [git](https://git-scm.com/)
69+
70+
### Optional dependencies
71+
72+
This is a list of optional programs that we advise to install along of Lem:
73+
74+
```
75+
fd
76+
```
77+
78+
- [fd](https://github.com/sharkdp/fd) or `fd-find` on Debian repositories: if present, Lem will use it in commands that find files recursively (see Usage: Opening Files). `fd` respects .gitignore by default and ignores common large development directories such as `node_modules/`. If it isn't present, Lem will fallback to a full Lisp solution.
79+
80+
### Install SBCL and ncurses library
81+
- Debian-like distro
82+
```
83+
sudo apt install sbcl libncurses5-dev build-essential fd-find
84+
```
85+
86+
- Fedora
87+
```
88+
sudo yum install sbcl ncurses-devel make automake gcc gcc-c++ fd-find
89+
```
90+
91+
- OpenSuse
92+
```
93+
sudo zypper install sbcl ncurses-devel make devel_basis fd
94+
```
95+
96+
### Install qlot
97+
- Automatic installer
98+
```
99+
curl -L https://qlot.tech/installer | bash
100+
```
101+
For an alternative installation, https://github.com/fukamachi/qlot#installation
102+
103+
104+
### Build the executables
105+
106+
- Create the directories
107+
108+
```
109+
mkdir $HOME/common-lisp && cd $HOME/common-lisp
110+
```
111+
```
112+
git clone https://github.com/lem-project/lem.git
113+
cd lem && make ncurses
114+
```
115+
116+
or run `make sdl2-ncurses` to build Lem with the two interfaces in it. Then choose the interface at startup with `-i / --interface`, either "sdl2" or "ncurses".
117+
118+
119+
### Add the executable to PATH
120+
- Copying the PATH to `~/.bashrc`
121+
```
122+
export PATH="$HOME/common-lisp/lem:$PATH"
123+
```
124+
125+
## Installation with roswell (deprecated)
126+
127+
> Note: the installation with Roswell is deprecated.
128+
129+
Please install roswell at first, [Roswell Installation Guide](https://github.com/roswell/roswell/wiki/Installation).
130+
131+
After that, please follow the steps bellow.
132+
133+
1. Install lem by roswell
134+
135+
```
136+
$ ros follow-dependency=t install lem-project/lem
137+
```
138+
139+
2. Add the PATH in the initialization file (such as `~/.bashrc`)
140+
```
141+
export PATH=$PATH:~/.roswell/bin
142+
```

content/en/installation/ncurses/linux.md

Lines changed: 0 additions & 123 deletions
This file was deleted.

content/en/installation/ncurses/macos.md

Lines changed: 0 additions & 85 deletions
This file was deleted.

content/en/installation/ncurses/windows.md

Lines changed: 0 additions & 18 deletions
This file was deleted.

0 commit comments

Comments
 (0)