Skip to content

Latest commit

 

History

History
33 lines (25 loc) · 1.69 KB

README.md

File metadata and controls

33 lines (25 loc) · 1.69 KB

Recent generated artifacts:

Generated artifacts are auto-published (post-commit on) https://songbook.21wdw.org. You can also check the latest release: https://github.com/wdw21/songbook/releases/latest.

About

This project contains:

Songs

Currently the songs are hosted in the ./songs directory. They are mostly Polish scouting and tourists songs. If the set growths, we will organize it into language specific directories. The XML format is pretty well self-describing.

Editing of the songs

To reduce the friction when working with git/github and XML format we provide a graphical editor and (github-integration https://ghe.songbook.21wdw.org/editor/] to make the songs editing as smooth as possible. The changes you will make can be easily published for review and added to this repository.

Generating PDF songbooks

The songs can be converted to a PDF songbook. We use LaTeX for this. You can download a ready PDF or generate it yourself.

Running the render script requires:

  1. a python environment with dependencies listed in requirements.txt
  2. a pdflatex compiler with ucs, extsizes, and Polish localization support

Generating EPUBs songbooks

You can run ./render_epub.sh. You can download recent generated EPUB from here: spiewnik.epub.