If a tree cascades in a Corola forest, does it trace a Riemannian manifold?
- IngSoc
Stochastic parasitics with high-quality mathematical typesetting.
See here for a very quick tour of Forest (and its LocalCharts incarnation).
- Install nix. The best way to do this if you don't already have nix installed is via the Determinate Nix installer. If you are on macOS, you can do this without even going into Terminal.app, with the Graphical Nix Installer.
- Clone this repository with
git clone https://github.com/LocalCharts/forest
, or if you have an SSH key on github,git clone [email protected]:LocalCharts/forest
. - Move into the directory you cloned into with
cd forest
Here you have two choices:
-
The way G-d intended (standard but longer, involves downloading and installing 2GB+ of stuff):
This step might take a while the first time as it installs OCaml, TeXlive, and the automatically refreshing preview server.
- Run
nix --extra-experimental-features nix-command --extra-experimental-features flakes develop
. - Run
forester-dev
. This will start a server athttp://localhost:8080
which serves the built version of the forest. Note that if you go tohttp://localhost:8080
you will get a blank screen; you have to go tohttp://localhost:8080/index.xml
to get the main page, orhttp://localhost:8080/namespace-XXXX.xml
for looking at other pages.
- Run
-
The shortcut (less standard but quicker, recommended if you don't use Nix otherwise):
In this case you must have a recent TeXlive installation on your computer.
- Run
nix --extra-experimental-features nix-command --extra-experimental-features flakes develop '.#shell-minimal'
, which only contains forester and thenew
andbuild
wrapper commands. - Run
build
to build the site into theoutput/
directory, and then runserve
to start up a server to preview the output; you can then go tohttp://localhost:8080/index.xml
as in the previous instructions.
- Run
Now you can go and edit some files in the trees/
directory!
For a general reference on forester syntax, see The Forester markup language.
You can send PRs to either github