Na tomto místě naleznete podklady k sestavení TP zpěvníků z let 2011 – 2013. Vysázené zpěvníky naleznete na http://karel-brinda.github.io/tp-zpevnik/.
Co tento systém umožňuje:
Od roku 2011 jsou TP zpěvníky sázeny v LaTeXu způsobem, jakým se obvykle připravují např. diplomové práce nebo knihy.
Tento githubový repozitář poskytuje jednotný přístup k těmto zpěvníkům a všem jejich zdrojovým datům. Původní způsob sázení byl sice mírně odlišný, ale výsledek by měl být téměř totožný.
Podporovaný OS
Python 3 (včetně programu pip) – nejjednodušší instalace je pravděpodobně v rámci balíku Anacoda (k dispozici pro Windows, Linux i MacOS)
Snakemake (http://bitbucket.org/johanneskoester/snakemake/) – program podobný Make s mnohem většími možnostmi, který je postaven na Pythonu, slouží k sestavení celého zpěvníku. Nainstalujete ho pomocí
pip install snakemake
XeLaTeX – stačí mít standardně nainstalovaný TeX (v případě Windows MikTex, v případě Linuxu standardní latexové balíčky z repozitáře)
GIT (http://git-scm.com/) – program pro práci s repozitáři zdrojových kódů
Samotné písně naleznete v adresáři tp-songs, který dále obsahuje 4 podadresáře podle skupin písní v TP zpěvnících (obdobná logika jako v modré Já písničce).
V konzoli přejděte do adresáře, ve kterém chcete pracovat.
Stáhněte aktuální verzi zpěvníku vč. dalších vyžadovaných repozitářů příkazem
git clone --recursive http://github.com/karel-brinda/tp-zpevnik
Přejděte do adresáře zpěvníku a sestavte všechny zpěvníky pomocí
cd tp-zpevnik
./zkompiluj_vse_seriove.sh
Pokud chcete sestavit pouze některý zpěvník, např. z TP 2011, zadejte
snakemake -s Snakefile.TP2011
Obdobně pro ostatní zpěvníky.
Opravte soubor přímo přes webové rozhraní GitHubu (musíte být ale přihlášeni). Pak mi zašlete pull request.
Vytvořte vlastní fork repozitáře http://github.com/karel-brinda/tp-zpevnik (ve web gui klikněte na tlačítko "fork" vpravo nahoře).
Naklonujte zpěvník ze svého nového repozitáře (vzniklého forknutím) včetně externích repozitářů (soubory v nich modifikovat nebudete, pro ty tedy fork vytvářet nemusíte).
git clone --recursive http://github.com/<vase-username-na-githubu>/tp-zpevnik
Opravte chyby.
Otestujte, zda se zpěvník správně přeloží (a neskončí např. xelatexovou chybou). Důkladně zkontrolujte, jestli po vysázení vypadá daná píseň správně.
Odešlete změny na server pomocí příkazů
git add jmeno_upraveneho_souboru_1.tex jmeno_upraveneho_souboru_2.tex
git commit -m 'kratky popis zmen - co konkretne jste opravili'
git push
Na GitHub.com mě požádejte mě o merge (propuštění změn do původních repozitářů – zelené tlačítko Pull request). Pokud bude změna korektní, schválím ji.
Postupujte obdobným způsobem jako v minulém bodu. Místo opravy vytvořte soubor pro píseň z nějaké již existující. Dodržujte, prosím, logiku celého zpěvníku:
Pojmenujte píseň podle vzoru Celé_Jméno_Interpreta____Jméno_písně.tex
.
Prosím, nekopírujte nekriticky text z jiné stránky. Minimálně si jej vložte nejdřív do textového editoru a nechte ověřit překlepy.
Ověřte správnost akordů a jejich umístění nad začátky slabik, a to i uprostřed slov (předložky k, s, v, z slabiku nezačínají).
"Sólo", "předehra" / "intro", "mezihra" a podobné nepotřebují text a vlastní \zs ... \ks
(výjimkou je sloka nahrazená sólem beze zpívání). Stačí v odpovídajícím místě napsat řadu akordů s prázdným textem.
České písně by měly mít texty psané jako celé věty včetně kompletní interpunkce, zalámané do veršů. Písničky v angličtině a několika dalších jazycích mají velké písmeno na začátku každé řádky a interpunkce na jejich koncích (kromě té se speciálním významem), včetně tečky na konci věty, se ruší.
Po zavedení písně zpěvník přeložte a zkontrolujte, zda vypadá v pořádku a jak dlouhá se vysází. Jestli přesahuje jednu stránku jen o několik řádek, zkuste ji upravit, aby se vešla na jednu A4 celá:
/: ... :/
nebo tří teček, refrény vynechat.Do adresáře, kde si chcete vlastní zpěvník vytvořit, naklonujte tento repozitář:
git clone --recursive http://github.com/karel-brinda/tp-zpevnik
Vytvořte soubor Snakefile.muj
. Ukázkový soubor najdete pod názvem Snakefile.test
. Ilustruje vložení písní Let it be a Love me do od Beatles a žádost o automatické spočítání transpozice u Let it be:
# -*-coding: utf-8 -*-
left_page_head="Levá hlavička"
right_page_head="Pravá hlavička"
chordbook="muj_novy_zpevnik"
#cover_front="obalka_predni.pdf"
#cover_back="obalka_zadni.pdf"
songs=[
("./tp-songs/03_zahranicni/Beatles____Let_it_be.tex", 5), # 5 = transpozice o 5 půltónů nahoru
"./tp-songs/03_zahranicni/Beatles____Love_me_do.tex",
]
include:"tpcb/snake_incl.py"
rule all:
input:
cb_pdf()
Jestliže chcete písničky vysázet nezávisle na sobě jako jednotlivé
soubory PDF, nahraďte poslední řádku cb_pdf()
za singles
. Jestliže si
přejete vygenerovat oba výstupy, oddělte je čárkou.
Spusťte
snakemake -s Snakefile.muj
Měl by se vám vysázet zpěvník _muj_novy_zpevnik.pdf
.
\zp{jméno písně}{autor písně nebo interpret}
- začátek písně\kp
- konec písně\zr
- začátek refrénu\kr
- konec refrénu\zs
- začátek sloky\ks
- konec sloky<Dmi>Text, nad kterým bude akord
- akord<...>
vkládejte právě jeden akordy (pokud jich tam bude více, program ohlásí neznámý formát akordové značky).