aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorThomas Voss <mail@thomasvoss.com> 2023-10-29 21:30:53 +0100
committerThomas Voss <mail@thomasvoss.com> 2023-10-29 21:30:53 +0100
commitff9d73c1ff87bd6c54b0d306a8ad08ee653c9155 (patch)
tree795f62064fea8f02c30197fa40b6cc82b3986e3d /README.md
parentfa75c5392ac90ac9f801a83aacb072ffb821d3b7 (diff)
Update README
Diffstat (limited to 'README.md')
-rw-r--r--README.md39
1 files changed, 37 insertions, 2 deletions
diff --git a/README.md b/README.md
index a50b5a5..18f2fbb 100644
--- a/README.md
+++ b/README.md
@@ -7,10 +7,43 @@ far too bloated, visually polluting your documents.
support for such things, just use a programming- or macro language such as
Python or M4.
+## Installation
+
+You need to ensure you have both the Go compiler and the `make` command
+available. If you don’t have Go, you can get it [here][1]. If you’re on a
+UNIX-like system such as Linux or MacOS then you should already have `make`. If
+you’re on Windows you should be using WSL anyways, and you can figure out how to
+get Make. You also need Git.
+
+First, clone the repository and move into it:
+
+```
+$ git clone https://git.sr.ht/~mango/gsp
+$ cd gsp
+```
+
+Then you can compile the transpiler with either of the two commands:
+
+```
+$ make
+$ go build
+```
+
+Finally, you can install the transpiler and documentation with the following:
+
+```
+$ sudo make install
+```
+
## Documentation
-Documentation for the transpiler can be found in the `gsp(1)` manual.
-Documentation for the language can be found in the `gsp(5)` manual.
+Documentation for the transpiler can be found in the `gsp(1)` manual and
+documentation for the language can be found in the `gsp(5)` manual:
+
+```
+$ man gsp # transpiler documentation
+$ man 5 gsp # language documentation
+```
## Why Not Use Pug or [INSERT LANGUAGE HERE]
@@ -56,3 +89,5 @@ html lang="en" {
## Why The Name GSP?
I was originally inspired by Pug, but my dog is a GSP, not a pug.
+
+[1]: https://go.dev/dl/