Generuji své knihy z Markdownu s plnou kontrolou nad každou stránkou

Vydavatelský průmysl vychází z hluboce zakořeněného předpokladu, že autoři píší a vydavatelé vyrábějí. Práce autora jsou slova. Práce vydavatele je všechno ostatní: layout, typografie, návrh stránky, umělecký kryt, distribuce a tisíce malých technických rozhodnutí, která transformují rukopis na hotovou knihu. Platformy pro nezávislé vydavatelství jako Amazon KDP narušily distribuční stranu této rovnice tím, že umožnily komukoli publikovat a prodávat knihu bez tradičního vydavatele. Ale produkční stranu narušily zdaleka ne tolik, jak jejich marketing naznačuje. KDP stále vyžaduje hotový PDF (k tisku) nebo formátovaný EPUB (k digitálu) a vytvoření těchto souborů ze surového rukopisu vyžaduje buď drahý software pro publikování jako Adobe InDesign, učební křivku měřenou v týdnech pro nástroje jako LaTeX, nebo přijetí omezených možností formátování konvertorských nástrojů, které odstraňují většinu kontroly, která dělá knihu profesionálně vypadající.

Pracovní postup popsaný zde jde úplně jinou cestou. Zdrojový materiál je psán v Markdownu, lehkém značkovacím jazyce, který vývojáři používají pro dokumentaci a který se neustále rozšiřuje do širší použití kvůli své jednoduchosti. Markdown řeší nadpisy, odstavce, tučný text, kurzívu, odkazy, obrázky, bloky kódu a seznamy se syntaxí tak minimální, že surový text je téměř stejně čitelný jako formátovaný výstup. Pro psaní prózy je Markdown lepší než dokumenty Word v jednom kritickém ohledu: zcela odděluje obsah od prezentace. Slova žijí v jednoduše textovém souboru se zjednodušenými značkami formátování. Vizuální návrh se aplikuje odděleně během kroku generování PDF. Toto oddělení znamená, že stejný zdroj Markdownu může vytvořit různě stylizované PDF pro různé účely (recenzní kopii se širokými okraji a velkým písmem, finální kopii s těsnější typografií a plnou barvou, kopii připravenou k tisku se značkami výtěhu a barevným prostorem CMYK) bez dotyku obsahu vůbec.

API generátor PDF knih přijímá obsah Markdownu spolu se sadou parametrů návrhu a vytváří hotový PDF. Tyto parametry návrhu řídí vše, co by řídila tradiční aplikace pro rozvržení stránky: velikost stránky, okraje, rodina písma a velikost pro text těla a nadpisy, výška řádku, rozestup odstavců, obsah a formátování záhlaví, obsah a formátování zápatí, styl a poloha číslování stránek, generování obsahu, pravidla pro rozdělení kapitol a umístění obrázků. Výsledkem je PDF, které se neodlišuje od toho vytvořeného profesionálním sázečem pomocí softwaru pro publikování, generované v sekundách ze zdrojového souboru prostého textu a konfigurace JSON.

Psaní v Markdownu a stylování pomocí HTML

Čistý Markdown je dostatečný pro přímou prózu: kapitoly textu s příležitostnými nadpisy, zdůrazněním a obrázky. Ale knihy často vyžadují formátování, které překročí to, co standardní Markdown podporuje. Vytahané citáty, postranní panely, boxů callout, vlastně stylizované odstavce, vícesloupcové rozvržení a ozdobné prvky jsou všechny běžné v profesionálně navržených knihách a všechny chybí ve specifikaci Markdownu. Řešením je vložit HTML a CSS přímo do zdrojového kódu Markdownu, kde je potřeba vlastní styl. Procesory Markdownu jsou navrženy tak, aby prošly surový HTML nezměněný, což znamená, že odstavec standardního Markdownu následovaný stylizovaným div s vlastním CSS následovaným dalším odstavcem standardního Markdownu se bude vše správně vykreslovat v konečném výstupu.

Tento hybridní přístup poskytuje to nejlepší z obou světů. Hlavnina obsahu je psána v čistém, bez rozptýlení Markdownu, který se soustředí zcela na slova. Příležitostný stylizovaný prvek je psán v HTML/CSS s ovládáním na úrovni pixelů nad vzhledem. Úvod kapitoly by mohl používat iniciálu vytvořenou pomocí CSS selektoru first-letter. Klíčový koncept může být zvýrazněn v barevném boxu callout s hranicí a pozadím. Poznámka autora může být nastavena v menším fontu se širšími okraji, aby se vizuálně odlišila od hlavního textu. Tyto stylizované prvky se zobrazují ve zdroji Markdownu jako bloky HTML, jasně ohraničené od okolní prózy, a jsou vykresleny v konečném PDF přesně tak, jak CSS specifikuje.

Praktická zkušenost psaní knihy tímto způsobem je překvapivě příjemná. Editor Markdownu (nebo dokonce základní textový editor) poskytuje čisté, soustředěné písemné prostředí bez vizuálního neřádu panelu nástrojů, pásu a panelů formátování textového editoru. Autor vidí text, nadpisy a příležitostný blok HTML a nic více. Neexistují žádné nabídky písem soutěžící o pozornost, žádné galerie stylů navrhující nežádoucí formátování, žádné aspekty rozvržení stránky přerušující tok myšlení. Design se stane později, odděleně, jako odlišný krok spíše než pokračující rozptýlení. Pro autory, kteří zažili zvýšení tvůrčí produktivity, která nástroje jako iA Writer a Ulysses poskytují prostřednictvím jejich minimalistických rozhraní, tento pracovní postup rozšiřuje tuto filozofii až po finální výrobu PDF.

Záhlaví, zápatí, čísla stránek a obsah

Podrobnosti, které oddělují amatérsky nezávisle vydanou knihu od profesionálně vyprodukované, jsou téměř zcela v nábytku stránky: záhlavích, zápatích, číslech stránek a obsahu. Tyto prvky jsou tak všudypřítomné v publikovaných knihách, že je čtenáři si nevšímají vědomě, ale jejich absence nebo špatné provedení je okamžitě zřejmé. Kniha bez čísel stránek vypadá nedokončená. Kniha s nekonzistentními záhlavími vypadá nepečlivě. Kniha, jejíž obsah uvádí čísla stránek, která se neshodují se skutečnými stránkami, vypadá rozbitě.

Generátor PDF knih řeší všechny tyto prvky prostřednictvím parametrů konfigurace spíše než jejich vložením do obsahu Markdownu. Čísla stránek lze umístit na spodek středu, dolní část venku (střídavě vlevo a vpravo pro sudé a liché stránky, jak tradiční knižní typografie diktuje), nebo dolní část vnitřku. Formát číslování podporuje arabské číslice pro hlavní část a římské číslice pro přední materiál (předmluva, slovo od autora, poděkování), s automatickým přechodem v určené kapitole. Záhlaví mohou zobrazovat název knihy na levých stránkách a název kapitoly na pravých stránkách, opět následující tradiční typografickou konvenci, kterou čtenáři očekávají bez vědomého rozpoznání.

Obsah se generuje automaticky ze struktury nadpisů zdroje Markdownu. Nadpisy první úrovně se stanou položkami kapitol. Nadpisy druhé úrovně se stávají položkami sekcí odsazenými pod svou rodičovskou kapitolou. Čísla stránek v obsahu se počítají během procesu vykreslování a zaručeně se shodují se skutečnými stránkami v generovaném PDF, protože jsou odvozeny ze stejného průběhu vykreslování spíše než vloženy ručně. Tato automatická generace eliminuje jednu z nejúnavnějších a nejchybovějších úloh v knižní produkci: udržování obsahu, který zůstává přesný, když se obsah během procesu úprav přidává, odstraňuje nebo reorganizuje. V tradičním textovém editoru každá strukturální změna knihy riskuje porušení obsahu. V tomto pracovním postupu se obsah znovu generuje při každém vykreslování PDF, vždy přesný, vždy aktuální.

Rozdělení kapitol je nakonfigurováno tak, aby vynucovalo nové kapitoly na pravé (recto) stránky, což je standardní konvence v knižním vydavatelství. Pokud kapitola končí na pravé straně, další levá stránka je ponechána úmyslně prázdná (někdy se jemnou poznámkou "tato stránka je úmyslně prázdná", někdy opravdu prázdná), aby se nová kapitola začala na následující pravé straně. Tento detail je téměř neviditelný čtenářům, ale okamžitě je vidět, když chybí, protože kapitoly začínající na levých stranách se cítí "špatně" všem, kdo jsou zvyklí na čtení tradičně publikovaných knih, i když to nemohou formulovat.

Vodoznak každé kopie s jedinečným QR kódem

Nejinnovativnější součástí tohoto vydavatelského kanálu je to, co se stane po vygenerování PDF. Každá prodaná kopie obdrží jedinečný vodoznak obsahující QR kód, který identifikuje konkrétní kopii, kupujícího a transakci. Toho dosahuje přijetím generovaného PDF prostřednictvím API vodoznaku, který aplikuje překrytí na každou stránku (nebo na konkrétní stránky, v závislosti na konfiguraci) obsahující polotransparentní QR kód v poziční poloze rohu, která je viditelná při inspekcích, ale nebrání čtení.

Samotný QR kód odkazuje na zkrácenou adresu URL, která se řeší na ověřovací stránku potvrzující legitimitu kopie. To slouží více účelům současně. Nejprve funguje jako odstrašující prvek pirátství. PDF sdílené bez autorizace stále nese QR kód identifikující původního kupujícího, který vytváří odpovědnost. Za druhé funguje jako mechanismus ověření autenticity. Čtenář, který chce potvrdit, že jeho kopie je legitimní, může naskenovat QR kód a vidět ověřovací stránku spíše než chybu. Za třetí funguje jako analytický kanál. Každé skenování QR kódu je zaznamenáno, což poskytuje data o tom, kdy a kde jsou kopie čteny, což jsou informace, které tradiční publikování poskytuje pouze prostřednictvím prodejních údajů a průzkumů.

Vodoznak se aplikuje poté, co se základní PDF vygeneruje, což znamená, že stejný zdroj Markdownu vyrábí stejné základní PDF pokaždé a přizpůsobení na kopii se stane v samostatném kroku zpracování. Toto oddělení je důležité, protože znamená, že pracovní postup úpravy a rozvržení je zcela nezávislý na pracovním postupu distribuce. Změny obsahu, úpravy návrhu a typografická vylepšení se všechny vyskytují na úrovni základního PDF. Přizpůsobení specifické pro kopii se vyskytuje na úrovni distribuce. Žádný proces nenarušuje druhý a oba mohou být automatizovány nezávisle.

Kompletní kanál nezávislého vydavatelství

Zobrazeno od konce ke konci, kanál od surového textu k vodoznáku, prodejní-připraveném PDF se skládá ze čtyř diskrétních kroků, každý zpracovaný jinou součástí, ale všechny propojené prostřednictvím jednoho automatizovaného pracovního postupu. Krok jedna je psaní obsahu v Markdownu s volitelným stylováním HTML/CSS pro vlastní prvky. Tento krok probíhá v jakémkoli textovém editoru, který autor preferuje, a vytváří soubor prostého textu, který je kontrolovatelný verzí, diffable a imunní vůči problémům s proprietárním formátem, které trápí dokumenty textového editoru. Krok dva je konfigurace parametrů generování PDF: velikost stránky, písma, okraje, záhlaví, zápatí, číslování a nastavení obsahu. Tato konfigurace je objekt JSON, který lze uložit, verzovat a znovu použít v různých knihách nebo vydáních. Krok tři je generování základního PDF odesláním obsahu Markdownu a konfigurace do API generátor PDF knih. Výstupem je profesionálně formátovaný PDF připravený k přezkumu. Krok čtyři je aplikace vodoznaky na kopii, když se kopie prodávají, pomocí API vodoznaku k razítku každého PDF s jedinečným QR kódem před doručením.

Celý kanál běží bez jediného kusu softwaru pro publikování. Žádný InDesign. Žádný LaTeX. Žádný Word. Nástroj pro psaní je textový editor. Nástroj rozvržení je soubor konfigurace JSON. Nástroj vykreslování je API. Nástroj vodoznaku je další API. Mechanismus distribuce je cokoli, co si autor vybere: přímý prodej prostřednictvím vlastních webových stránek, doručování prostřednictvím e-mailu nebo distribuce prostřednictvím platforem, které přijímají podání PDF. Autor řídí každý prvek procesu, od slov na straně po písmo, ve kterém jsou nastavena, polohu čísel stránek a vodoznak, který identifikuje každou kopii. Nic se nevzdaluje platformě, která ukládá svou vlastní šablonu, své vlastní značky nebo svá vlastní omezení.

Pro nezávislé autory a vlastní vydavatele, kteří se cítili omezeni omezeními spotřebitelských nástrojů pro publikování, tento kanál nabízí něco, co bylo historicky dostupné pouze profesionálním vydavatelům s vyhrazeným personálem výroby: úplná typografická kontrola nad konečným výstupem, v kombinaci s přizpůsobením specifické pro kopii pro distribuci a prevenci pirátství, vše běží prostřednictvím automatizovaného pracovního postupu, který snižuje kroky výroby z hodin ruční práce rozvržení na jeden volání API. Kniha, kterou držíte (nebo PDF, které čtete na obrazovce), byla psána jako prostý text, stylizována jako JSON, vykreslena jako pixely a razítkem s QR kódem, který odkazuje vaši konkrétní kopii na váš konkrétní nákup. Každá stránka, každý okraj, každé záhlaví, každé zápatí bylo vědomou volbou spíše než výchozí šablonou. Vydavatelský průmysl má termín pro tuto úroveň kontroly. Nazývají ji "profesionální produkcí." Příslušný termín na dosažení z textového editoru a volání API je jednoduše "vydávání v roce 2026."