67 lines
2.4 KiB
Markdown
67 lines
2.4 KiB
Markdown
The HoTT Game
|
|
=============
|
|
|
|
The Homotopy Type Theory (HoTT) Game is a project written by mathematicians
|
|
for mathematicians interested in HoTT and no experience in proof verification,
|
|
with the aim of introducing Cubical Agda as a tool for
|
|
trying out mathematics in HoTT.
|
|
This page will help you get the Game working for you.
|
|
|
|
## Installing Agda and the Cubical Agda library
|
|
|
|
Our Game is in Agda, which can be installed following instructions
|
|
[on their site](
|
|
https://agda.readthedocs.io/en/latest/getting-started/installation.html).
|
|
It is recommended that you use Agda in the text editor
|
|
[emacs](
|
|
https://www.gnu.org/software/emacs/tour/index.html),
|
|
in particular
|
|
[Doom Emacs](https://github.com/hlissner/doom-emacs),
|
|
if you can't be bothered to do a bunch of configuration.
|
|
|
|
Once you have Emacs and Agda, get the [Cubical Library](
|
|
https://github.com/agda/cubical) (version 0.3)
|
|
and make sure Agda knows where your cubical library is
|
|
by following instructions on the [library management page](
|
|
https://agda.readthedocs.io/en/latest/tools/package-system.html?highlight=library%20management).
|
|
In short: locate (or create) your `libraries` file and add a line
|
|
```
|
|
the-directory/cubical.agda-lib
|
|
```
|
|
to it, where `the-directory` is the location of `cubical.agda-lib` on your computer.
|
|
|
|
Get the HoTT Game by [cloning this repository](
|
|
https://git-scm.com/book/en/v2/Git-Basics-Getting-a-Git-Repository)
|
|
into a folder and then making sure that Agda knows where the HoTT Game is
|
|
by adding a line
|
|
```
|
|
the-directory/HoTTGameLib.agda
|
|
```
|
|
to your `libraries` file as above.
|
|
|
|
Try opening `Trinitarianism/Quest0.agda` in Emacs
|
|
and do `Ctrl-c Ctrl-l`.
|
|
Some text should be highlighted, and any `?` should turn into `{ }`.
|
|
|
|
## How the game works
|
|
|
|
Our Game is currently under development.
|
|
As of now you can try the _quests_ in the `Trinitarianism` folder.
|
|
Each quest consists of three files, for example :
|
|
- `Trinitarianism/Quest0.md` is the guide for the quest.
|
|
In there, you will find details of the tasks
|
|
you must finish in order to complete the quest.
|
|
For now, it is recommended that
|
|
you view these online within github.
|
|
- `Trinitarianism/Quest0.agda` is the agda file in which
|
|
you do the quest.
|
|
- `Trinitarianism/Quest0Solutions.agda` contains
|
|
solutions to the tasks in the quest.
|
|
|
|
## Emacs and Agda usage
|
|
We will have a file with a list of basic Emacs commands,
|
|
but you _should_ be able to learn how to use Agda as you go along.
|
|
|
|
## Feedback
|
|
If you have any feedback please contact the devs.
|