Write install instructions (README.md)
This commit is contained in:
parent
b1e910290b
commit
125976e844
4
Makefile
4
Makefile
|
@ -1,4 +1,4 @@
|
||||||
LISP ?= ecl
|
LISP ?= sbcl
|
||||||
SWANK ?= ${HOME}/.config/emacs/elpa/slime-20221206.26/swank-loader.lisp
|
SWANK ?= ${HOME}/.config/emacs/elpa/slime-20221206.26/swank-loader.lisp
|
||||||
USE_SWANK ?= no
|
USE_SWANK ?= no
|
||||||
|
|
||||||
|
@ -9,7 +9,7 @@ maps:
|
||||||
$(LISP) \
|
$(LISP) \
|
||||||
--load "res/maps/tmx→lisp.lisp"
|
--load "res/maps/tmx→lisp.lisp"
|
||||||
|
|
||||||
build:
|
build: maps fonts
|
||||||
$(LISP) \
|
$(LISP) \
|
||||||
--eval '(ql:quickload :flora-search-aurora)' \
|
--eval '(ql:quickload :flora-search-aurora)' \
|
||||||
--eval '(asdf:make :flora-search-aurora)' \
|
--eval '(asdf:make :flora-search-aurora)' \
|
||||||
|
|
|
@ -0,0 +1,36 @@
|
||||||
|
# Flora Search Aurora
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
|
||||||
|
You can run the game through a pre-built binary, available under Releases of this repository.
|
||||||
|
|
||||||
|
If you’d rather (or have to) run the game from source, you can set up the game like so:
|
||||||
|
|
||||||
|
1. Install a Common Lisp implementation. I’d recommend [Steel Bank Common Lisp](http://www.sbcl.org/), which is robust and available on many *nixes under the package-name `sbcl`.
|
||||||
|
2. Set up [Quicklisp](https://quicklisp.org/), which is a “package-manager” for Common Lisp libraries.
|
||||||
|
3. Clone this repo into your Quicklisp projects path.
|
||||||
|
4. Run or build the game with `make run` or `make build`.
|
||||||
|
|
||||||
|
To do so, you can run the following commands, replacing `guix` with your package-manager of choice:
|
||||||
|
|
||||||
|
```
|
||||||
|
$ guix install sbcl
|
||||||
|
$ wget https://beta.quicklisp.org/quicklisp.lisp
|
||||||
|
$ sbcl --load quicklisp.lisp \
|
||||||
|
--eval '(quicklisp-quickstart:install :path "~/.local/share/quicklisp/)' \
|
||||||
|
--eval '(ql:add-to-init-file)'
|
||||||
|
$ rm quicklisp.lisp
|
||||||
|
$ cd ~/.local/share/quicklisp/local-projects/
|
||||||
|
$ git clone https://notabug.org/jadedctrl/flora-search-aurora
|
||||||
|
$ cd flora-search-aurora/
|
||||||
|
$ make build
|
||||||
|
$ ./flora-search-aurora
|
||||||
|
```
|
||||||
|
|
||||||
|
For development, so that you can connect to the game’s REPL with (i.e.) [SLIME](https://slime.common-lisp.dev/), you might want to run the game like so:
|
||||||
|
|
||||||
|
`$ USE_SWANK=yes SWANK=… make run`
|
||||||
|
|
||||||
|
… where SWANK is the path to SLIME’s `swank-loader.lisp` file, probably at `~/.config/emacs/elpa/slime-*/swank-loader.lisp`.
|
||||||
|
|
||||||
|
The game has been tested with both [Embeddable Common Lisp](https://ecl.common-lisp.dev/) and SBCL. It runs perfectly on both, but building a binary isn’t working on ECL at the moment.
|
Ŝarĝante…
Reference in New Issue