Šablonování PDF (diskuse)

[Josef Kufner]

Kdysi jsem si trochu hrál s LaTeXem a s Twig. Výsledkem je toto: github.com/jkufner/lyx-on-twig.

Myslím, že použití LuaLaTeXu na předávání dat by bylo ještě lepší, ale tohle funguje docela dobře. Ve wysiwym editoru (LyX) si vyrobíš šablonu s kousky Twig konstrukcí, nacpeš do ní cokoliv potřebuješ a pak to buildneš jako běžný LaTeX dokument. Dokonce i nevyplněná šablona je validní LaTeX, takže náhled bez dat dává většinou smysl.

[alfonz]

Pro Pripravto jsme v jednu dobu používali rsttopdf či Latex/pdftex a pak také svg do PDF. No co k tomu dodat > byla to dost špatná zkušenost. Nakonec jsme skončili u přímo HTML a SVG (někdy generované přes RST) a to vcelku funguje, Někdy je potřeba si trochu pohrát s CSS. Zkoušeli jsme používat i reportlab a to bylo trochu lepší, ale vcelku komplikované. Používat přímo Cario, je asi docela v pohodě -> kreslí pěkně, akorát nevím jak to bude s udržitelností?

[Filip Jirsák]

K tomu Apache FOPu jste asi četl něco starého. FOP byl v první implementaci těžkopádný na konfiguraci a projekt pak na několik let usnul. Ale před pár lety se znovu probudil, vyvíjí se a zrovna na té konfiguraci se hodně zapracovalo – dnes stačí FOP rozbalit nebo přidat do závislostí a spustit a vše funguje. Používám FOP na různé věci a nikdy jsem nenarazil na to, že bych měl vážný problém s tím, co v něm není implementováno.

[kralyk z abclinuxu]

Aha, ok. A umělo by to to potřebné zarovnání akordů a textu? Tzn. v HTML se tohle řeší typicky tabulkou, kde se akordy dají do jednoho řádku a text do druhého a ono to samo spočte potřebné velikosti políček.

Já bych se asi stejně radši té závislosti na Javě vyhnul, ale i tak je dobré to vědět, díky.

[Filip Jirsák]

Automatickou šířku sloupců tabulky Apache FOP neumí, to máte pravdu. Já tohle nikdy nepoužívám, ani v HTML nebo jiných tabulkách, protože to vždycky dopadne špatně. Tabulky v layoutu se přeceňují… Ten univerzální automat prostě nemůže uhodnout, jak tu tabulku zformátovat hezky. I v HTML bych akordy dělal spíš pomocí textu, tam stačí jednoduchý styl

.chord {
  display: inline-block;
  position: relative;
  top: -1em;
  width: 0px;
}

Ale z hlavy nevím, zda jde to samé udělat i v XSL-FO.

Píšete, že výstupem je i HTML – pak mi připadá nejjednodušší použít headless režim Chrome, ve kterém jde tisknout do PDF – Chrome umí z příkazové řádky pořídit screenshot nebo PDF. Podpora CSS v prohlížečích se v posledních letech rapidně zlepšila a pro stránkování podle mne nepotřebujete nic moc extra, a základní podporu prohlížeče mají.

Pokud si ale chcete pohrát s tím, aby výstup vypadal přesně tak, jak chcete, a má to být to podstatné na vaší aplikaci, je nejlepší si to vykreslovat sám, pak máte všechno v ruce. Ale samozřejmě je to pracnější.

[kralyk z abclinuxu]

I v HTML bych akordy dělal spíš pomocí textu, tam stačí jednoduchý styl

.chord {
  display: inline-block;
  position: relative;
  top: -1em;
  width: 0px;
}

No, on by neměl mít nulovou šířku - v případě, že je širší než k němu vázaný text, měly by dohromady mít šířku akordu, aby se nepřekrýval s následujícím. Ale jinak ano, principielně souhlasim. Já ty tabulky použil jako rychlý hack, o kterém jsem věděl, že bude fungovat a dávat celkem správné výsledky, ale dobudoucna bych to mohl nahradit nečím pěknějším v CSS třeba...

Píšete, že výstupem je i HTML – pak mi připadá nejjednodušší použít headless režim Chrome, ve kterém jde tisknout do PDF – Chrome umí z příkazové řádky pořídit screenshot nebo PDF. Podpora CSS v prohlížečích se v posledních letech rapidně zlepšila a pro stránkování podle mne nepotřebujete nic moc extra, a základní podporu prohlížeče mají.

Já se touhle možností zabýval, ale zkoušel jsem myslím jen Firefox, ve kterém ta podpora není nic až tak dobrá (viz třeba tady). Nelezly mi z toho dobrý výsledky. Nicméně v Chromu to vypadá lépe, alespoň podle toho, co píšou na internetech.

Pokud si ale chcete pohrát s tím, aby výstup vypadal přesně tak, jak chcete, a má to být to podstatné na vaší aplikaci, je nejlepší si to vykreslovat sám, pak máte všechno v ruce. Ale samozřejmě je to pracnější.

Ono se to koneckonců nevylučuje a v zásadě by nebyl problém nechat uživatele vybrat, jestli chce jen HTML, které může s možností tisku počítat, nebo jestli chce i PDF + větší kontrolu. Dát do konfigurace možnost třeba spustit nad výstupním souborem nějaký příkaz nebude složité.

[Josef Kufner]

Ta nulová šířka je kvůli tomu, aby ti to nevyrobilo mezeru mezi písmenkama v textu. Akord samotný přeteče ven a bude vidět normálně široký, jak je třeba.

[kralyk z abclinuxu]

Přílohy:

• render.png (3692 bytů)
• render-spatne.png (4957 bytů)

Nerozumíme si. Jde mi o následující situaci (v syntaxi ChordPro):

tam [G]písnič[C]ku někdo [G]pí[C]s[D]ká.

Ten akord C (předposlední na řádku) je textově širší než ten jeden znak, ke kterýmu se váže ("s"). Z toho důvodu přeteče do následujícího akordu (D) a překryje se s ním. Viz přiložené snímky, ten správný je pomocí tabulky, ten druhý s tím CSS výše. Kdyby ten C akord byl ještě navíc třeba Cmi7 nebo něco takového, bylo by to ještě horší.

Další věc je, že je potřeba za tím akordem zajistit nějakou minimální mezeru (třeba pár pixlíků), aby nebyly těsně na sebe. V tom 'správném' snímku je ta mezera skoro až moc velká.

Neříkám, že se to nedá pomocí CSS vyřešit, určitě jo, jen to není tak jednoduché.

[Josef Kufner]

Pokud dáš do spanu to, nad čím akord platí, tak to nastavením minimálních šířek uděláš snadno. Tedy DOM bude muset vypadat nějak takto (span je {}):

{tam }{[G]písnič}{[C]ku někdo} {[G]pí}{[C]s}{[D]ká.}

[kralyk z abclinuxu]

nastavením minimálních šířek uděláš snadno

Nastavením minimálních šířek na co? Ta šířka je pokáždé jiná.

Další problém je, že když jsou takovéhle dva řádky pod sebou, tak akordy z toho spodního překrývají ten vrchní.

Já bych na to šel asi přes flexbox, ale nechce se mi teď s tím dělat...

[Josef Kufner]

Nastavíš min-width spanu s textem na šířku akordu a akordy se ti nebudou překrývat. Pokud bude text delší, span se roztáhne.

Pokud akordy překrývají předchozí řádek, buď nastav line-height tak, aby se akord vešel.

S flexboxem to bude spolehlivější vůbec lepší, ale pointa je stejná.

[kralyk z abclinuxu]

Nastavíš min-width spanu s textem na šířku akordu a akordy se ti nebudou překrývat.

Šířku akordu neznám. To je právě to, co chci po tom layoutu - aby si ji spočítal a uplatnil sám.

[Josef Kufner]

Tak to máš smůlu a budeš to muset celé přeskládat do flexbox layoutu a v podstatě z toho udělat tu tabulku.

[Filip Jirsák]

Pokud chcete automatické zalamování řádků, řeší to line-height, pokud chcete řádky zalamovat ručně, řešil by to i margin-top.

Jak má být vlastně graficky správně vysázeno to, když jsou akordy delší než text? Pouze s mezerami, jak je to na obrázku nahoře, je to podle mne špatně – mohou tím vzniknout jiná slova, a když ne, stejně se to špatně čte. Podle mne by to mělo být spojené buď alespoň pomlčkou, nebo lépe vodorovnou čárou vyplňující celou tu mezeru. Je na to nějaký úzus, jak se to dělá správně? Použít by na to šel asi flexbox, ten by na rozdíl od tabulky uměl i to automatické zalamování řádků. Řadit horizontálně úseky „od akordu k akordu“ a ten úsek pak rozdělit na horní polovinu pro akord a dolní pro text. Pomocí pozadí by se tam asi dala udělat i ta horizontální čára spojující části slov.

Ale pokud si s tím chcete pohrát, aby to vypadalo hezky, asi opravdu pomůže jen naprogramovat si vlastní vykreslovač – pochybuju, že nějaký z obecných vykreslovačů půjde znásilnit k tomu, aby tohle vykresloval hezky i ve všech okrajových případech. A psaní takového vykreslovače je určitě zábava

[kralyk z abclinuxu]

Jak má být vlastně graficky správně vysázeno to, když jsou akordy delší než text? (...) Je na to nějaký úzus, jak se to dělá správně?

Popravdě úplně nevim. Asi na to obecný úzus není. Tady jsou tři [1, 2, 3] příklady, jak to řeší jinde. Ten první se mi nelíbí, ty ostatní jsou meh. Ten třetí je taky s mezerou a to samý dělá i ChordPro.

Ta vodorovná čára by mi asi osobně vyvhovovala nejvíc, možná by mohla být např. světlejší barvou nebo dotted nebo tak něco. Jen nevim, jestli by to šlo udělat v HTML. Možná by to mohl být element s výškou 0.5em, vertikálně zarovnaný dole, ~100% šířkou a border-top.

Ale pokud si s tím chcete pohrát, aby to vypadalo hezky, asi opravdu pomůže jen naprogramovat si vlastní vykreslovač – pochybuju, že nějaký z obecných vykreslovačů půjde znásilnit k tomu, aby tohle vykresloval hezky i ve všech okrajových případech. A psaní takového vykreslovače je určitě zábava

jj to každopádně, a s použitím Lua je na tom navíc fajn, že to není hardcoded...

[kralyk z abclinuxu]

Resp. ne 100% šířka, ale auto nebo jak se to dělá...

[Filip Jirsák]

Vodorovná čára by se v HTML nejsnáze udělala obrázkem na pozadí, text před ní by měl bílé pozadí, aby ji překryl. Kdyby se mělo použít ohraničení, musel by tam být vložený další element a asi zase pomocí flexboxu by musel vyplňovat zbývající místo.

Jinak v HTML by bylo nejsnazší použít ruby element, který je přesně pro anotace v textu určený, jenže jeho speciální styly podporuje jenom Firefox. Viz codepen.io/anon/pen/JxeNEL.

[Josef Kufner]

Můžeš nastylovat :after a/nebo :before. Přidat nějaký ten border a ujistit se, že při nulové šířce nebude vidět.

[Joe]

Songs LaTeX Package nestačí? Osobně občas sáhnu přímo do songs.sty, když si chci přidat nějakou nestandardní věc - pochopitelně jen úpravou již existujícího \beginverse nebo změnou metrik.

[kralyk z abclinuxu]

No, v zásadě ano, ale je to otázka komfortu a user-friendliness.

Tenhle progámek za mě např. řeší pospojování více souborů aniž bych to musel nějak explicitně řešit, dále umí např. transpozice nebo konverze notace (německá ↔ západní ↔ nashville), příp. experimentuju i s vysázením dvou sad akordů, kde např. jedna je bežná a druhá je auto-konverze do nashville pro snadnou transpozici apod. Ten LaTeXový formát je složitější než ChordPro a mně popravdě už to ChordPro přijde skoro zbytečně složité, chystám se zkusit použít na to Markdown s nějakými velmi drobnými rozšířeními (v podstatě potřebuju akorát značky pro tóninu, notaci a transpozici, jinak Markdown vlastně všechno má).

Další věc je, že o to vyjádřili zájem někteří příbuzní a kamarádi, kteří používají Windows a nejsou prorgamátoři (ačkoli jinak jsou počítačově gramotní) - v takovém případě je ideální, když jim můžu poskytnout standalone binárku.

[mirec]

Ja na generovanie PDF momentálne používam z3c.rml. Nevyžaduje to cairo, X-ka, webkit ani nič podobné, je to čisté python riešenie bez nejakých hrozných závislostí. Zdrojové xml-ka nie sú až také škaredé.

[kralyk z abclinuxu]

To je zajímavé, díky.

[Rezervní Polská Kotace]

...

Ale ted vážně, kde je zdroják? Nebo jsem to přehlédl? Každopádně dík za článek.

Osobně bych šel spíš cestou TeXu (tip: jsou i jiné varianty než plain a La - třeba právě Lua), ale souhlasím, že je to velký balík a jako součást malého programu to nní ono. Tam je asi Cairo správná volba.

[kralyk z abclinuxu]

Ale ted vážně, kde je zdroják?

Ještě není. Měl by být (např. podle doporučení Pietera Hintjense, že ano), ale zkrátka ještě není...

[Václav HFechs Švirga]

Je to sice phpčko (které ale v případě distribuovatelnosti pro windows je pár exáčů/dllek, netřeba instalovat), ale zkušenosti s tím mám dobré - mpdf.

Varianta je to HTML+CSS.

Stránkování má nějak vyřešené.

Muselo by se to ale zkusit.

Když mi zabalíš nějaký CSS+HTML export, klidně to tím zkusím prohnat.

[retro]

je dobré vzpomenout u mpdf https://github.com/mpdf/mpdf/blob/development/LICENSE.txt což se nemusí úplně na všechno hodit

[Václav HFechs Švirga]

Jako jo, to je fakt. Na druhou stranu, pokud si z mpdf udělá nějaký tool ve smyslu

convert.php -i file.html -o file.pdf

a ten licencuje jako GPL2 (a z podstaty věci dodá i se zdrojáky),

program který ten convert.php bude execovat klidně může být pod jinou licencí.

[PetrHL]

HTML + CSS bych nezatracoval. Na generování PDF bych použil headless Chrome. Wkhtmltopdf je fajn, ale na každém systému web vypadá jinak. Díky Chrome nebudete mít problém s podporou CSS.

[j.]

Já noty sázím zásadně v lilypondu a z hlediska výstupu je to ideální nástroj. Z hlediska vstupu ... no je to latex, co si budeme povídat

[kralyk z abclinuxu]

To je ale něco jinýho, to jsou noty. Na to bych taky použil Lilypond. Myslimže na to existují i nějaký GUI, ale nevim, jak moc jsou dobrý...

[dumblob]

Lilipond bylo první co mě napadlo. Samozřejmě i bez not Lilipond:

Lilypond: Is there a way to create a song with just lyrics and chords? Without the notes

[kralyk z abclinuxu]

Hmm, pro běžné použití je ta notace těžkopádná (zkoušel jsem to už dřív), ale používat Lilypond jako backend by možná nemuselo vůbec být marný, pokud se dá nějak samonosně 'vzít s sebou'. A jako bonus to má vestavěnou databázi diagramů.

[dumblob]

Vzít s sebou určitě nějak jde, protože jsem se o něm dozvěděl před mnoha lety od známého, který je muzikant z povolání a vůbec nemá technické vzdělání, ani IT ho nezajímá, v "počítačích" se téměř nevyzná a tenkrát používal Windows (a dnes určitě taktéž Windows).

Sám mi tenkrát řekl, že je ta notace pro něho jednodušší než se trápit s grafickými a drahými programy (které tehdá zkoušel), které si dělají co chtějí, nepodporují vše co je potřeba a výsledky jsou stejně nic moc. Myslím, že Lilipond uměl snad i transponovat či ty zápisy šly i přehrát přes MIDI atd.

Jinak pokud jde pouze o částečnou modularitu, tak já používám např. Pandoc s jeho minimalistickou LaTeX šablonou a přes parametry pandocu předávám dodatečné "moduly" (texťáky s běžným LaTeXem), které mi poskytujou dodatečnou funkcionalitu. Pro dokumentace jsem vytvořil a používám např. tyto "moduly":

tex_deeply_nested_lists.include
tex_external_link_symbol.include
tex_fix_figure_position.include
tex_header_settings.include
tex_table_alternating_color.include
tex_verbatim_bgcolor.include

Tím lehce rozšiřuji či zužuji potřebnou funkcionalitu v závislosti na projektu.

Pokud LaTeX backend, tak jedině na této hodně "vysoké úrovni" zapínání a vypínání takovýchto "modulů" (tzn. žádné "generování LaTeXu").

Jinak, a teď prosím no flame, LaTeX nemám vůbec v oblibě (i to psaní matematiky jde v mnohých jiných notacích lépe) a preferuji téměř jakýkoliv jiný nástroj (především grafické, nevyžadující psaní značek).

[kralyk z abclinuxu]

Myslím, že Lilipond uměl snad i transponovat či ty zápisy šly i přehrát přes MIDI atd.

Transponovat umí určitě, ale třeba Nashville notaci AFAIK neumí (ačkoli by se to asi dalo dohackovat v Guile).

Pokud LaTeX backend, tak jedině na této hodně "vysoké úrovni" zapínání a vypínání takovýchto "modulů" (tzn. žádné "generování LaTeXu").

Tomu asi nerozumím. Jak bych třeba použil Lilypond aniž bych generoval .ly tak nebo onak?

[dumblob]

Tomu asi nerozumím. Jak bych třeba použil Lilypond aniž bych generoval .ly tak nebo onak?

Vyjádřil jsem se nepřesně. Samozřejmě obsah samotný bude nutné generovat. Avšak parametrizaci obsahu bych rozhodně nechtěl generovat jako součást obsahu, nýbrž pouze jako zapínání či vypínání "modulů" (např. obdobně jako jsem uvedl v případě pandocu).

[ʚĭɞ 🍉]

Lout je hodně zajímavý jazyk. Sice jde v podstatě o one-man show s hodně pomalým vývojem, ale je to škoda.

[r]

Nestačil by plainTeX?

\obeylines
\lineskip=10pt
\font\chordfont=cmr7
\font\rm=cmr12

\catcode`[=13
\def[#1]#2{{\raise1em\if#2>\hbox{\chordfont #1\hss}\else\hbox to0pt{\chordfont #1\hss}#2\fi}}

tam [G]písnič[C]ku někdo [G]pí[C]>s[D]ká
tam [G]pí[C]sničku někdo [G]pí[Cmi7]>s[D]ká
\bye

[radek]

Trochu out of date, ale přesto zkusím. Nevíte někdo o nějakém zpěvníku, v textové podobě ve formátu jako má ChordPro, případně jiném podobném, který se nechá pár reg. výrazy do té podoby upravit? Chtěl bych pořádně vyzkoušet svůj výtvor v palainTeXu. Jinak díky za inspirativní blog.

[kralyk z abclinuxu]

Asi bohužel nemam nic, co by se dalo okamžitě použít, sorry. Mam tu pár testovacích chordpro souborů, ale asi jsou copyrightované. Chtěl bych si sestavit nějaký malý demo zpěvníček z public domain věcí, ale ještě jsem to neudělal. Všechno mi to jde taknějak pomalu.

Pokud ti jde jen o ty značky akordů v textu, tak je to celkem v pohodě a nejspíš to vytáhneš z nějakého online zpěvníku [1, 2].

Ale jinak mi ten ChordPro nepřijde jako moc dobře navrženej formát, cokoli na rámec holého plaintextu v tom není podporováno nebo nešikovně (třeba označování slok a refrénu, konverze notace, transpozice). Takže mám teď rozepsanou podporu pro subset markdownu, aby to bylo snáz použitelnější a míň alien.

[radek]

Příloha:

• songbook.pdf (30628 bytů)

Mě to v prvé řadě přišlo zajímavé programátorsky. V TeXu se dá zjistit délka textu pod akordem a s tím pak pracovat při formátování textu. Jinak kromě formátu ChordPro, který beru jako kostru formátu, mohu v textu používat makra TeXu. Testoval jsem na krátkém zkušebním textu:

\nadpis{Pískající cikán}
\interpret{Spirituál kvintet}

[G]Dívka [Ami]loudá se [G]vin[Ami]icí, [G]Tam, kde [Ami]zídka je [Hmi]níz[Ami]ká
[G]tam, kde [Ami]stráň končí [Hmi]voní[C]cí, si [G]písnič[C]ku někdo [G]pí[C]sk[D]á.

\nadpis{Be happy!}

[Cmi] [Dmi] [F] [C]
[Cmi7]H[C]ere's a little song I wrote
[Dmi]You might want to sing it note for note
Don't [F]worry be [C]happy

Dont worry be happy now
|:Dont worry be happy:| 4x

a vylezl mi z toho přiložený soubor. Myslím, že to nevypadá zle, v porovnání s tím, co jsem po krátkém hledání našel na internetu.

[kralyk z abclinuxu]

Přílohy:

• whiskey.cho (1507 bytů)
• songbook.pdf (15417 bytů)
• songbook-transpose.pdf (15592 bytů)
• songbook-altchords-transpose.pdf (15715 bytů)
• songbook-altchords-nashville.pdf (15549 bytů)
• songbook-serif.pdf (16441 bytů)

Hezký to máš.

Hodil jsem do chordpro Whiskey in the Jar (to by snad neměl být copyright problém), viz příloha.

Já si ten ChordPro dost ohackoval, že např. sám dělá sloky po dvojitém odřádkování apod. a přidal jsem transpozici + možnost mít dvoje akordy, viz ukázky.

Většinou používám sans-serif, přijde mi, že v horším osvětlení (táborák, ...) se to líp čte, ale zas ten serifovej font vypadá taknějak víc seriózně Ale to je asi detail...

[kralyk z abclinuxu]

PS. tohle je ještě renderovaný ještě s tím SVG coby mezikrokem, před přechodem na Lua, to ještě nemam dodělaný.

[kralyk z abclinuxu]

PPS. Koukám, že se mi tam dostala řádka navíc pod tím refrénem, tak si to kdyžtak odmaž :)