• Linux
  • Arch Linux
  • Debian
  • Void Linux
• Docker
• Windows
  • WSL
  • Cygwin
• MacOS
• tlmgr

Linux

Arch Linux

sudo pacman -S inkscape make git git-lfs texlive-binextra texlive-latexextra texlive-fontsrecommended texlive-fontsextra

git lfs install

git clone https://gitlab.com/bindrpg/core.git

cd core

make all

Debian

sudo apt install texlive-full inkscape git git-lfs make

git clone https://gitlab.com/bindrpg/core.git

cd core

make all

Void Linux

sudo xbps-install texlive-most inkscape git git-lfs make texlive-latexmk

git clone https://gitlab.com/bindrpg/core.git

cd core

make all

Docker

You can select any number of books, then compile them via docker. Just list the books at the end.

books='core stories oneshot'
docker run -it --rm --name texbooks andonome/texbind gimme $books

Windows

You have two options on Windows: WSL (the built-in Linux), and Cygwin.

WSL

The 'Windows Subsystem for Linux' virtualises Linux.

1. Install it using these instructions.
2. Install Ubuntu (or anything really).
3. Open the terminal and access your Windows desktop by typing cd /mnt/c/Users/$YOURNAME/Desktop
4. Follow the Debian instructions (above).

Cygwin

If you want to replicate a *nix-style workflow on a Windows platform, the following setup may work for you:

• Install Cygwin making sure to select the git and make packages.
  • If you wish to use SSH for git access, instead of HTTPS, then add the openssh package also
• Open up the Cygwin bash console so that it can create a home folder within it's folder structure for you.
• Download the Windows binary for git-lfs and place the executable in a location that is in the PATH. One option is to create a "bin" subfolder in your Cygwin home folder and add it to your path by editing .bash_profile. You could also place it elsewhere on your filesystem and just edit the Windows PATH environment variable in order to add that location.
• Install TeX Live
• Install Inkscape
• From a newly opened Cygwin bash console and clone the repo with one of the following commands:
  • git clone git@gitlab.com:bindrpg/core.git
  • git clone https://gitlab.com/bindrpg/core.git
• Then execute the following commands:
  • cd core
  • make

The above process should build the Core Rulebook. If you wish to execute the build of the config repository itself, there is one additional step that will be required. Typical Windows installations do not support symlinks. The config repository utilizes a symlink in order to emulate the folder structure of the other document repositories. At the top of the config repo, you will find a symlink named "config" that points to the config repo folder itself. In order to execute builds of the config repo on Windows, execute the following commands before make:

• cd config
• rm config
• mkdir config
• shopt -s extglob
• cp -R !(config) config/
• make

MacOS

I don't have a Mac to test on, but this will probably work with homebrew.

tlmgr

If you want to install just the LaTeX packages you'll need with tlmgr, clone the config repo, and run ./Docker/tlmgrDeps.sh.

Run the tlmgr.sh script.