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.
This project contains:
- songs (in XML format)
- tools to generate PDFs, EPUBs and HTMLs out of this songs
- web editor to enable easy edits of the songs and github-integration
- web editor to enable easy edits of the songs and github-integration
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.
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.
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:
- a python environment with dependencies listed in requirements.txt
- a pdflatex compiler with ucs, extsizes, and Polish localization support
You can run ./render_epub.sh.
You can download recent generated EPUB from here: spiewnik.epub.