Skip to content

Commit

Permalink
add documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
joneugster committed Aug 22, 2024
1 parent fa4342d commit 86f74ed
Showing 1 changed file with 22 additions and 0 deletions.
22 changes: 22 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,28 @@ That is why we start the Lean server using [Bubblewrap](https://github.com/conta
If bubblewrap is not installed, the server will start without a container and produce a warning.
You can also opt-out of using bubblewrap by setting `NODE_ENV=development`.

## Documentation

### URL arguments

The website parses arguments of the form `https://myserver.com/#arg1=value1&arg2=value2`.
The recognised arguments are:

- `code=`: plain text code.
(overwrites `codez`)
- `codez=`: compressed code using [LZ-string](https://www.npmjs.com/package/lz-string).
- `url=`: a URL where the content is loaded from.
(overwrites `code` and `codez`).
- `project=`: the Lean project used by the server to evaluate the code. This has the be the name
of one of the projects the server defines in their config.

The server will automatically only write one of `code`, `codez`, and `url` based on the following
logic:

1. if the code matches the one from the loaded URL, use `url`
2. if the preferences say no comression, use `code`
3. otherwise use `codez` or `code` depending on which results in a shorter URL.

## Build Instructions

We have set up the project on a Ubuntu Server 22.10.
Expand Down

0 comments on commit 86f74ed

Please sign in to comment.