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
Currently the songs are hosted in the ./songs directory. They are mostly Polish scouting and turists songs. If the set growths, we will organize it into language specific directories. The XML format is pretty well self-describing.
The reduce the friction when working with git/github and XML format we provide a graphical editor and (github-integrationhttps://songbook-gh6-j72bw4qyaq-ew.a.run.app/] 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
The code to generate EPUBs is in the review (wdw21#2). You can download recent generated EPUB from here: spiewnik.epub.