Introduction

Warning

The BFH LaTeX Docker image is available exclusively to BFH members.

Note

After installation, please refer to here for further instructions.

We provide a Docker image with all required packages and tools pre-installed, providing you the simplest start, requiring only a few configurations. In detail, you will be editing your LaTeX document inside a Docker container, which is basically a lightweight virtual machine.

As the image contains an already set up and working LaTeX environment, the section about installing the BFH CI can be skipped.

Install

Docker can package an application and its dependencies in an encapsulated environment (lightweight virtual environment), also known as a container, that can run on any GNU/Linux, Windows, or macOS system. To install Docker on your host, follow the OS-dependent instructions on the official website. The link below will take you there.

• Docker manual

Note

For Arch/Manjaro-based Linux distributions, use pacman instead.

# pacman -S docker 

Additions Tools

VSCode (recommended)

It is very well possible to start developing LaTeX documents in a plain Docker container (see here). However, for the best experience, we recommend using the Visual Studio Code Editor, as it provides many features for developing inside a Docker container.

Visual Studio Code is an open-source code editor developed by Microsoft, compatible with Windows, macOS, and GNU/Linux. The Visual Studio Code Remote-Containers extension lets you use a Docker container as a full-featured development environment. For an overview and brief introduction, refer to the introduction on the official website. To install the editor, follow the OS-dependent instructions on the official website. The link below will take you there.

• Official Documentation

Note

For Arch/Manjaro-based Linux distributions, use the installation documentation below. Do only use Flatpak or the official pacman package manager when you know what you are doing, as these installations will only work correctly when configured accordingly.

# pacman -S --needed git base-devel

$ git clone https://aur.archlinux.org/visual-studio-code-bin.git

$ cd visual-studio-code-bin

$ makepkg -si