bard 2.0.1

Creates PDF and HTML songbooks out of easy-to-write Markdown sources.
Documentation
# Installation

Binary packages are provided for [Linux](#linux) and [MS Windows](#ms-windows) on x86-64.\
On other platforms or architectures, you can [build from sources](#form-sources).

## Linux

The following are provided:

- [Static binary]https://github.com/vojtechkral/bard/releases/latest/download/bard
- [Deb package]https://github.com/vojtechkral/bard/releases/latest/download/bard.deb
- [RPM package]https://github.com/vojtechkral/bard/releases/latest/download/bard.rpm
- [AUR package]https://aur.archlinux.org/packages/bard, [AUR binary package]https://aur.archlinux.org/packages/bard-bin
- Docker: [`vojtechkral/bard`]https://hub.docker.com/repository/docker/vojtechkral/bard

To build PDFs, a TeX distribution is needed. Please consult your distribution package repository for the appropriate package.
The default Bard template typically requires an extended TeXLive package such as `texlive-xetex` on Ubuntu,
`texlive-latexextra` on Arch or `texlive-scheme-medium` on Fedora.

Alternatively, you can install the [Tectonic](https://tectonic-typesetting.github.io/) engine.

See the [TeX Configuration](./tex.md) chapter for how to configure TeX use.

## MS Windows

The following are provided:

- [Portable binary]https://github.com/vojtechkral/bard/releases/latest/download/bard.exe
- [Portable binary without Tectonic]https://github.com/vojtechkral/bard/releases/latest/download/bard-no-tectonic.exe

The portable binary linked above contains the [Tectonic](https://tectonic-typesetting.github.io/en-US/) TeX system, so no additional software is needed. If you'd like to use a different TeX system, such as [MiKTeX](https://miktex.org/), the Tectonic-less binary is recommended.

See the [TeX Configuration](./tex.md) chapter for how to configure TeX use.

## From Sources

You will first need the Rust toolchain to build from sources – it can be installed via [Rustup](https://rustup.rs/) or from your OS package repository, if available.

Once the Rust toolchain is installed, i.e., the `rustc` and `cargo` commands are available, use the following command to build and install from sources using `cargo`:

    cargo install -f bard