BEST Aalborg Songbook

This songbook was originally created for the BEST Aalborg Summer Course 2013. It was used as a camp fire songbook, and as a codex for the cantus we held during the summer course.

Compilation

This section explains how to compile the songbook.

Prerequisites

The songbook is written in LaTeX using the Songs-package. Thus in order to compile the songbook you must have a working LaTeX distribution installed along with the Songs package. The Songs package is freely available at https://songs.sourceforge.net.

Compiling the songbook

A makefile is distributed along with the source. Open a terminal in the src/-directory and type:

src/ $ make && make index && make

The first make produces a songbook in PDF-format without an index of songs. The make index generates the index, whilst the second make includes the index of songs. See the file Songbook.pdf for an example output.

Adapting the songbook to your needs

You can change the title, author, layout and more in the "master" file src/Songbook.tex. Similarly, you can add / remove Cantus, SitSit, etc. rules. By default the savetrees-package is disabled. Enabling this package slightly alters the layout but in turn reduces the number pages. Furthermore, enabling savetrees may cause the song index to display wrong page numbers for some songs.

Adding and removing songs

By default all songs are found in src/songs/-directory. Simply create a new tex-file in that directory (or any subdirectory). To include the new song in the songbook edit the src/songs/index.tex to input the song. The index file can be generated automatically by the BASH script src/link-doc.sh, e.g.:

src/ $ sh link-doc.sh Songbook
Successfully linked 70 files.

To remove songs either include the text %[LINK-DOC] ignore in the header of the song files or simply delete them. However, remember to regenerate the index-file afterwards.

Note: the link-doc.sh-script traverses the directory src/songs/ recursively in alphabetical order.

If you happen to add new songs, then feel free to make a pull request to include them with this distribution.

Distributing the songbook

This songbook is meant to be printed as a "booklet". It is ideal for as a camp fire songbook or Cantus codex, SitSit songbook or similar. However familiarise yourself with the license before distributing the songbook. Moreover, please include proper acknowledgements in your print (e.g. include 99-acknowledgements.tex).

Acknowledgements

The songbook is created by BEST Aalborg (summer course team 2013) with aid by BEST Copenhagen and BEST Gothenburg. The songbook is based on BEST Vienna's songbook, edition 2012. Thanks to the main contributors:

• Daniel Hillerström, Daniel Rune Jensen, Monika Michael, and Helle Toft from BEST Aalborg.
• Christoffer Brøndum, and Marie Rasmussen from BEST Copenhagen.
• Kristian Ott Milbo from BEST Gothenburg.
• Rok Kosmina from BEST Ljubljana.

License

The source code for the BEST Aalborg Songbook is published under Attribution-NonCommercial-ShareAlike 4.0 International license, see LICENSE.md for more details.