Minimal Manual: kapitoly, oddíly a čísla
Minimal je stavěný na blog: nejnovější nahoře, k příspěvku se dostaneš z výpisu a po přečtení jdeš dál. Příručka se nečte, v příručce se hledá. Chceš vědět, kde jsi, co je kolem a jak se dostat o kapitolu vedle. Minimal Manual je varianta pro weby s dokumentací. Stránka je v něm příručka.
Tenhle text je průvodce, ne příběh: co je jak a proč, s čísly opsanými ze souboru. Všechno, co tu není, je stejné jako v Minimalu a najdeš to v jeho průvodci. Ukázky jsou z kopie živé ukázky ./blog.sh manual, dokumentace enginu v tomhle skinu, ve výchozí paletě enginu. Kdo nechce číst všechno, najde na konci deset otázek kontrolního seznamu.
Jedna věta
Minimal Manual je příručka: vlevo kapitoly, uprostřed stránka s číslovanými oddíly a vpravo její obsah, který zůstává na očích. Je to skin pro weby na ./blog.sh, z rodiny Minimal, a barvy si bere z webu, na kterém běží. Od ./blog.sh 1.11 je součástí enginu a oblékneš ho řádkem site.skin: minimal-manual v config/site.yml, stejně jako v ./style.sh v části Layout; projeví se po ./blog.sh rebuild. Průvodce ho popisuje ve stavu 1.11.1, která mu srovnala poslední hrany.
Pravidla
Pět vět, kterými se liší od Minimalu. Jeho vlastních pět platí dál.
- Kapitola je série, stránka je příspěvek. Příručka se staví z toho, co engine už zná.
- Čtenář vždycky vidí, kde je. Kapitoly vlevo a obsah článku vpravo drží na obrazovce.
- Oddíly čísluje stylesheet. Stejné číslo má nadpis v textu i řádek v obsahu článku.
- Výpis je obsah. Titulek, dva řádky o čem to je, a který je to díl.
- Akcent na stránce je číslo oddílu a zvolená kapitola. Nadpisy jsou v inkoustu, datum tlumeně.
Jak se příručka staví
Manual nezavádí nic, co by engine neznal. Jen tomu dává jiná jména.
| V příručce | V ./blog.sh |
|---|---|
| kapitola | série |
| stránka | příspěvek, díl série |
| obsah kapitoly | výpis série |
| menu kapitol | nav: v nastavení webu |
| oddíl | mezititulek v příspěvku |
| poznámka | citace |
Menu kapitol si web píše sám, v nav:: popisek a k němu sérii jejím jménem (series:), adresu stránky, nebo štítek. Nadpis nad několika kapitolami je položka sama pro sebe: popisek s group: true, který drží kapitoly pod sebou až k dalšímu nadpisu. Nabídne ho ./style.sh a ./blog.sh doctor ohlásí položku, která přestala někam vést. Pořadí stránek v kapitole je pořadí dílů série. Pořadí kapitol v menu je pořadí, v jakém je napíšeš. Seznam sérií řadí engine: první je série s nejnovější stránkou, nebo s order: oldest pod series_index: série začatá nejdřív. Kapitoly tedy datuj v pořadí čtení a nastav order: oldest.
layout.series_contents: true vypíše na každé stránce kapitoly všechny její díly, pod řádkem nad titulkem, a series_index: dá seznamu sérií vlastní jméno, třeba title: Kapitoly.
Barvy
Beze změny. Papír, inkoust, tlumená a akcent se čtou z colors: webu, linka a deska se z nich míchají ve stejných poměrech jako v Minimalu.
Přebarvily se dvě věci. Mezititulky jsou v inkoustu; akcent na nich nese jen jejich číslo. A datum stránky je tlumené: u příručky říká, kdy byla stránka napsaná, ne čím je.
Písmo
Dvě písma enginu a tři hlasy jako v Minimalu.
Číslo oddílu je hlas enginu: JetBrains Mono, tučně, v akcentu, 0,72 velikosti nadpisu, před nadpisem. Oddíl druhé úrovně má „1“, třetí „1.1“. Na stránce používej jen tyhle dvě úrovně: nadpis jiné úrovně v textu číslo nemá, ale v obsahu článku se počítá.
Nadpis oddílu je Open Sans v inkoustu, druhá úroveň 1,45 rem, třetí 1,12 rem.
Kapitola v menu je Open Sans 14,5 px, tak jak je napsaná. V Minimalu je položka menu pilulka v mono a malými písmeny; ve svislém seznamu názvů kapitol by pilulky různých šířek nedávaly smysl.
Tvary a značky
Pilulka, klávesa, karta a vyplněné tlačítko jsou z Minimalu. Manual přidává šest věcí.
Řádek kapitoly v menu má roh 8 px. V klidu je to jen název, pod kurzorem stojí na desce a zvolená kapitola je vyplněná akcentem s bílým písmem.
Skupina kapitol má nad sebou nadpis hlasem, kterým rodina popisuje: malým tučným monospacem, malými písmeny a tlumeně, se vzduchem nad sebou. Pod 1100 px je to tichý popisek před pilulkami jako v Minimalu.
Poznámka je citace: deska s 3px linkou v akcentu po levém kraji a rohem 14 px vpravo. Engine má jeden způsob, jak slova od textu oddělit, a v příručce se jím říká „dejte pozor“.
Odkaz ven má za sebou malou šipku v akcentu. V příručce záleží na tom, jestli odkaz vede na další stránku, nebo úplně jinam. Stylesheet to pozná podle adresy: odkaz psaný s protokolem vede ven, odkaz psaný od kořene zůstává.
Tabulka jde přes celou šířku sloupce a má plné vlasové linky; v příručce se čte napříč i dolů.
Karta přechodu je na konci stránky dvakrát: předchozí stránka vlevo, další vpravo, každá přes polovinu sloupce, na desce s vlasovou linkou.

Linky a vzduch
Od 1100 px šířky má stránka tři sloupce: menu kapitol 184 px, text 556 px a obsah článku 200 px. Mezi menu a textem je 44 px, mezi textem a obsahem 56 px. Celek i s okraji drží 1080 px jako všude v rodině.
Čára v akcentu, kterou Minimal kreslí pod menu, je tu pod hlavičkou, přes celou šířku stránky. Rámuje stránku shora stejně, jen menu už pod ní nestojí vedle sebe, ale ve sloupci.
Oddíl druhé úrovně začíná pod vlasovou linkou a má nad sebou vzduch 2,2 velikosti nadpisu: kde oddíl začíná, se má najít pohledem.
Text stránky jde až k pravému kraji svého sloupce, na stejnou hranu jako obrázky, tabulky a kód.
Co Minimal drží vedle obsahu (o webu, poslední příspěvky ze sítí), stojí pod ním ve dvou kartách vedle sebe. Vedle textu příručky je místo na dvě věci a obě jsou navigace.
Titulka a výpis
Výpis je obsah: řádky jsou hustší než v Minimalu (14 px nad a pod místo 20) a úryvek má dva řádky místo tří. Datum nemá vlastní sloupec: stojí v řádce údajů pod úryvkem, stejně jako v Minimal Literal. Na obsahu kapitoly před ním stojí „díl 3 z 22“.
Výpis série je obsah kapitoly a v menu je při něm kapitola zvolená. Na každém jejím dílu je řádek kapitoly v akcentu a tučně: jsi v kapitole, ne na jejím obsahu.
Úvodník je z Minimalu beze změny. Připnutý příspěvek je v příručce přirozené „začněte tady“.

Příspěvek
Příspěvek s oddíly je stránka příručky. Engine dává stránce obsah od čtyř nadpisů, pokud příspěvek neřekne jinak přes toc:; i stránka bez obsahu má text až ke kraji sloupce.
Obsah článku (v rozhraní enginu „na téhle stránce“) stojí vpravo od textu, bez karty, jen s vlasovou linkou vlevo, a při rolování zůstává 22 px pod horním krajem okna. Řádky mají stejná čísla jako nadpisy v textu; pododdíl je odsazený a menší.
Nadpis, na který se skočí, zastaví pod horním krajem, ne za ním.
Řádek nad titulkem říká, kde v příručce jsi: datum tlumeně a vedle něj „název série — díl 21 z 22“ v akcentu jako odkaz zpět na obsah kapitoly.
Na konci stránky jsou dvě karty přechodu a pod nimi štítky, sdílení a komentáře jako v Minimalu.




Stránky enginu
Archiv, seznam štítků, seznam sérií, hledání a stránka, která není, jsou z Minimalu. Na širokém monitoru stojí vedle menu kapitol a postranní sloupec mají pod sebou. Seznam sérií je v příručce seznam všech kapitol: stylesheet je čísluje stejně jako oddíly, číslo v akcentu a jméno v inkoustu, a roky, kdy série běžela, o kapitole nic neříkají, takže je nevidět. Čísla jdou v pořadí příručky, když seznam běží s order: oldest; viz Jak se příručka staví.
Stav a odezva
Najetí, fokus, blikající kurzor, ztlumené obrázky v noci a nuly, které se neukazují, jsou z Minimalu. Kapitola v menu dostane pod kurzorem desku a text v akcentu; karta přechodu obrys a text v akcentu.
Menu svítí dvojím způsobem. Na výpisu série je kapitola vyplněná akcentem, na každém jejím dílu je její řádek v akcentu a tučně: jsi v kapitole, ne na jejím obsahu. V nastavení je menu plochý seznam, group: true nad něj dává nadpisy a hlouběji se nic nevnořuje.
Telefon
Pod 1100 px šířky je menu Minimalova řada pilulek pod hlavičkou a čára v akcentu je zase pod ním. Mezi 901 a 1099 px má stránka dva sloupce: text nejvýš 700 px a obsah článku 250 px, který drží 86 px pod horním krajem, pod menu.
Od 701 do 900 px je obsah článku Minimalova karta plovoucí vedle začátku textu; do 700 px je to blok nad textem jako v Minimalu. Postranní sloupec jde pod obsah od 860 px. Na telefonu jsou karty přechodu pod sebou.
Číslování oddílů, poznámka, šipka u odkazů ven a tabulka s linkami jsou na všech šířkách stejné.

Rodina
Minimal Manual je z rodiny Minimal, skinů nad ./blog.sh, která stojí na Minimalu, Terminal na classic. Skiny mají společné čtyři věci: barvy čtou z nastavení blogu, jsou jeden soubor, nesahají na žádnou šablonu a jejich průvodce mají tyhle oddíly v tomhle pořadí, jen tady navíc oddíl o stavbě příručky. Co Minimal už umí, to varianta dědí beze změny; tabulka říká, v čem je tahle jiná.
| Minimal | Minimal Manual | |
|---|---|---|
| Menu | řada pilulek pod hlavičkou | sloupec kapitol vlevo, drží na místě |
| Obsah článku | karta, plave vedle začátku textu | sloupec vpravo, drží na místě |
| Oddíly | mezititulky v akcentu | číslované, v inkoustu, pod linkou |
| Citace | linka v akcentu vlevo | poznámka na desce |
| Odkaz ven | jako každý jiný | se šipkou |
| Přechod mezi díly | dvě pilulky | dvě karty přes šířku textu |
| Datum příspěvku | v akcentu | tlumeně |
| Řádek výpisu | tři řádky úryvku | dva řádky, díl série první |
| Datum ve výpisu | vlastní sloupec vlevo | v řádce údajů, jako v Minimal Literal |
| Seznam sérií | jména v akcentu, s roky | číslované kapitoly v inkoustu, bez roků |
| Postranní sloupec | vedle obsahu | pod obsahem od 1100 px |
Kontrolní seznam
Deset otázek, než se do skinu cokoli přidá. Když na kteroukoli vyjde ne, není to Minimal Manual.
- Vidí čtenář na širokém monitoru pořád kapitoly i obsah článku, ať je v textu kdekoli?
- Má oddíl v textu stejné číslo jako jeho řádek v obsahu článku?
- Čísluje stylesheet, a není žádné číslo napsané v textu?
- Jsou nadpisy v inkoustu a v akcentu jen jejich číslo?
- Je zvolená kapitola vyplněná akcentem, a je vyplněná jen ona?
- Pozná se odkaz ven od odkazu na další stránku příručky?
- Jde text stránky až k pravému kraji sloupce, kde končí obrázky a tabulky?
- Je na konci stránky vidět, co je před ní a co po ní?
- Je pod 1100 px všechno dosažitelné stejně, jen pod sebou?
- Veze skin jen sám sebe: žádné písmo, žádný skript, žádný zásah do šablony?
Změny
13. 10. 2026: první vydání.
14. 10. 2026: datum ve výpisu jako v Minimal Literal; číslované kapitoly v seznamu sérií; živá ukázka; pojmy stejné jako ve zbytku rodiny.
16. 10. 2026: skin je od ./blog.sh 1.11 součástí enginu a obleče ho site.skin: minimal-manual; skupiny kapitol v menu (group: true) a na stránce dílu kapitola v akcentu.
15. 11. 2026: srovnáno s ./blog.sh 1.11.1. Karta na další stránku vyplní svou polovinu a každá stránka má text až ke kraji sloupce, obrázek i video v něm; pořadí menu podle zápisu a order: oldest pro seznam sérií; series_contents; svítící kapitola na stránce; šířky mezi 701 a 1099 px. Nové snímky z kopie živé ukázky.
Komentáře