Minimal Terminal: dvě písma a hranaté závorky

./blog.sh v1.11 — díl 6 z 12

Minimal vznikl pro osobní web a je na něm znát: krémový papír, pilulky, karty. Když jsem ho zkusil obléct blogu o enginu, který se pouští z terminálu, sedělo to, ale neříkalo to nic o tom, co ten web je. A tak vznikl Minimal Terminal: varianta, která z Minimalu převzala kázeň a všechno ostatní řekla po svém. Stránka v něm vypadá tak, jak by ji vytiskl terminál.

Rozhodnutí roztroušená v jednom stylesheetu a v mé hlavě jsou málo, proto je tohle průvodce, ne příběh. Co je jak a proč, s čísly opsanými ze souboru, ne zaokrouhlenými. Kdo nechce číst všechno, najde na konci deset otázek kontrolního seznamu.

Jedna věta

Minimal Terminal je stránka tak, jak by ji vytiskl terminál: dvě písma, závorky místo tlačítek, značky místo tvarů a jediná výplň, inverzní výběr. Je to skin pro blogy na ./blog.sh, druhý z rodiny Minimal, a barvy si bere z blogu, na kterém běží. Od ./blog.sh 1.11 je součástí enginu a oblékneš ho řádkem site.skin: minimal-terminal v config/site.yml, stejně jako v ./style.sh v části Layout; projeví se po ./blog.sh rebuild. Název a claim sází jako text, proto se k němu hodí banner.show_image: false.

Pravidla

Celý skin drží pohromadě čtyři věty.

  • Dva hlasy. Neproporcionální písmo říká všechno, co říká engine. Bezpatkové je to, co je napsané.
  • Žádné tvary. Nic kulatého, nic vyplněného, nic v rámečku. Věc se odliší linkou, písmem nebo znakem z terminálu.
  • Akcent je pro to, s čím se dá něco udělat, a pro hranu bloku kódu. Data, popisky a ikony jsou tiché.
  • Linky mezi věcmi jsou čárkované, linky, které drží stránku, jsou plné.

K tomu jedno páté, které vzešlo až z práce: data se nekreslí. Žádný graf, žádná mapa, žádné sloupečky. Co engine ví, to řekne textem. Proč, na to dojde u archivu.

Barvy

Minimal Terminal nemá vlastní barvu ani jednu, stejně jako Minimal. Engine zapisuje barvy webu z colors: v site.yml do proměnných, pro den a pro noc; skin z nich čte pět a jen si je přejmenuje po svém: papír, inkoust, tlumená, linka a akcent. Kdo si přebarví web, přebarvil i skin.

Na tomhle webu to jsou výchozí barvy enginu:

DenNoc
Papír#f5f8fa#111111
Inkoust#444a5a#ffffff
Tlumená#657784#6a7f8c
Linka#e1e8ed#263340
Akcent#1da1f2#4ab3f4

Šestý tón, deska, se nezadává, ale míchá: inkoust rozpuštěný na 4 % ve dne a na 7 % v noci. Leží pod blokem kódu a pod položkou menu, na kterou najedeš myší. Nic dalšího se nemíchá, až na čtyři stupně archivu, a ty jsou z akcentu.

Karta, menu i patička stojí na stejném papíru jako stránka. Žádná plocha není světlejší ani tmavší než jiná, takže stránku nečlení barva, ale linky.

Vzorník palety: pět tónů ve dne a pět v noci, každý s názvem, hodnotou a rolí.
Výchozí paleta enginu. Skin z ní nic neurčuje, jen ji čte.

Akcent

Pravidlo zní: akcent je pro to, s čím se dá něco udělat. Poctivý výčet je delší než jedna věta, tak ho sem píšu celý.

  • Odkaz v textu má barvu inkoustu a podtržení v akcentu, 1,5 px, odsazené 3 px. Text zůstává čitelný, barva jen říká „sem se dá kliknout“. Titulky a řádky ve sloupci dostanou totéž podtržení až pod myší.
  • Zmínka @někdo a hashtag v tootu jsou v akcentu celé, bez podtržení.
  • Fokus z klávesnice je obrys v akcentu.
  • Kurzor za názvem webu, blok, který bliká jednou za 1,1 s. Kdo má v systému omezený pohyb, tomu nebliká.
  • Hrana kódu: blok kódu je deska s 2px linkou v akcentu vlevo.
  • Znak citace >.
  • Připínáček u připnutého příspěvku.
  • Stupně archivu a obrys avataru autora v komentářích.
  • Podklad úvodníku, jediná velká plocha v akcentu na celém webu.
  • Ovládací prvky v závorkách pod myší, a kopírování kódu ve chvíli, kdy se povedlo.
  • Položka menu s kapitolou, ve které jsi, linka pole ve fokusu a počet u štítku se stovkou a více příspěvků.

Co akcent nemá: datum, ostatní počty, štítky, popisky, ikony v klidu. To je rozdíl proti Minimalu, kde akcent nese i data. Tady nese data tlumená a akcentu zbývá méně práce; když jím je navíc vyplněný celý úvodník, je to správná míra.

Písmo

Dvě písma, obě veze engine, takže skin je jeden soubor a nic se nestahuje navíc. Jsou to tatáž dvě jako v Minimalu, jen s jinak rozdělenou prací: tam mluví neproporcionální písmo za jméno stránky a za engine, tady za všechno kromě textu.

JetBrains Mono je hlas enginu. Název webu (30 px, tučně), nadpis výpisu (22 px), titulek příspěvku ve výpisu (18,5 px) i na vlastní stránce (23 až 28 px podle šířky okna), položky menu a tlačítka (13 px), datum, doba čtení, počty a štítky (12 px, tlumeně). Titulky mají prostrkání −0,02 em, aby neproporcionální písmo ve větší velikosti nepůsobilo řídce.

Open Sans je to, co někdo napsal. Odstavec příspěvku má 17 px a řádkování 1,7, na telefonu 16 px a 1,62. Úvod ve výpisu 16 px, řádek v postranním sloupci 14,5 px. Míra je nejvýš 65 znaků; do 860 px šířky, kdy se sloupec složí pod text, jde text příspěvku tak široko jako obrázky.

Hranice mezi hlasy je ostrá a dá se vyzkoušet otázkou: napsal to člověk, nebo to dopočítal engine? Titulek napsal člověk, ale na stránku ho sází engine jako jméno souboru, proto je mono. Jména mluvčích v rozhovoru napsal člověk a jsou součástí textu, proto zůstávají v sans. Tohle jsem si chvíli pletl.

Vzorník dvou písem: vlevo JetBrains Mono v pěti velikostech, vpravo Open Sans ve třech.
Vlevo, co říká engine. Vpravo, co je napsané.

Tvary a značky

Minimal má pilulky, klávesy a karty s rohem 14 px. Minimal Terminal má roh 3 px a to je všechno, co z tvarů zbylo; mají ho favicona, obrázky a avatary v komentářích. Co jinde řekne tvar, tady řekne znak.

  • [ slovo ] je tlačítko. Stránkování, přechod na další díl série, odpověď na Mastodonu, návrat na výpis. Mezi závorkou a slovem je nezlomitelná mezera, aby závorka nikdy nezůstala sama na dalším řádku. Jednou zůstala, proto to vím.
  • [ ikona ] je tlačítko, které engine kreslí obrázkem: sdílení, sítě v patičce, lupa, kopírování kódu, šipka nahoru, přepínač vzhledu [ ☀/☾ ] a jazyka [ en cs ]. Ikony jsou původní, ve sdílení a v patičce 16 px, jinde 14 px, jen přišly o kroužek a dostaly závorky.
  • # těsně před slovem je štítek. Žádná pilulka.
  • # s mezerou je popisek, zapsaný jako komentář ve skriptu: nadpis boxu v postranním sloupci, obsah článku, sdílení, copyright.
  • ## je nadpis uvnitř stránky, tak jak ho píše Markdown: mezititulek v textu (19 px), komentáře, měsíc v archivu, písmeno v seznamu štítků. Třetí úroveň má ###.
  • > v akcentu je citace, místo svislé čáry.
  • - je odrážka.
  • ~ je přibližně: doba čtení je ~3 min, ne ikona hodin.

Příloha je [ pdf ] v čárkovaném rámečku, jediném čárkovaném rámečku na webu vedle ukázek na stránce s taháčkem Markdownu. Titulek odkazového příspěvku není podtržený, protože odkazem je celý a podtržení by neřeklo nic.

Slovník znaků: dvanáct řádků, vlevo ukázka, vpravo význam.
Všechno, čím skin mluví, na jednom listu.

Inverze

Jediná výplň, kterou skin zná, je ta, kterou zná terminál: vybraný text. Písmo v barvě papíru na inkoustu, případně bílé na akcentu. Znamená to vždycky totéž, tady jsi, tohle hledáš nebo tady začni:

  • zvolená položka menu,
  • zvolený jazyk v přepínači,
  • měsíc archivu, ve kterém něco je,
  • nalezené slovo ve výsledcích hledání,
  • text, který označíš myší,
  • úvodník, první příspěvek titulky.

Kdyby se inverze použila ještě na cokoli jiného, třeba na tlačítko, přestala by znamenat polohu. Proto je tlačítko v závorkách a ne v bloku.

Linky a vzduch

Plná a čárkovaná, obě 1 px v barvě linky, a nezaměňují se.

Plná drží stránku: pod menu, pod hlavičkou příspěvku, nad patičkou, pod polem hledání. Čárkovaná odděluje věci stejného druhu: příspěvky ve výpisu, řádky postranního sloupce, komentáře, roky v archivu, výsledky hledání, a dva bloky na konci příspěvku. Vodorovná čára, kterou do textu napíše autor, je čárkovaná taky.

Stínů je nula. Karta nemá okraj ani podklad; že něco začíná, pozná se podle linky a podle vzduchu.

Titulka a výpis

Příspěvek ve výpisu jsou čtyři řádky pod sebou: datum, titulek, úvod nejvýš na tři řádky a to, co o příspěvku ví engine, tedy ~ s dobou čtení, počty ze sítě a štítky s #. Datum nestojí ve sloupci vedle, ale nad titulkem, a mezi příspěvky je čárkovaná linka.

Úvodník je největší inverze na webu. Příspěvek, kterým titulka začíná, stojí celý na akcentu a všechno v něm je bílé, včetně data, počtů a značek ~ a #; na takhle hlasitém podkladu by druhý tón byl jen šmouha. Je to připnutý příspěvek, a kde nic připnutého není, ten nejnovější. Který z nich to je, říká komentář nad datem: # pinned nebo # latest, na české stránce # připnuto a # nejnovější. Titulek má až 28 px místo 18,5 (na telefonu 22) a úvod smí mít pět řádků místo tří. Zkoušel jsem i jemnější podklady, akcent rozpuštěný v papíru a desku, jakou má kód. Oba fungovaly, ale byly by první barevnou plochou, která výběrem není. Plný akcent pravidlo neporušuje: úvodník je prostě příspěvek, který je vybraný. Platí jen na titulce, druhá strana výpisu už žádný nemá.

Titulní stránka ve světlém režimu: hlavička s faviconou a názvem, menu se zvolenou položkou inverzně, připnutý příspěvek jako úvodník na akcentu, pod ním výpis a vedle postranní sloupec.
Titulní stránka ve dne. Připnutý příspěvek je úvodník, zbytek jsou řádky.
Tatáž stránka v tmavém režimu.
A v noci. Favicona má vlasový obrys, aby se tmavá značka neztratila v tmavém papíru.

Příspěvek

Stránka příspěvku má stejné pořadí jako řádek výpisu, jen větší: datum, titulek v mono (23 až 28 px podle šířky okna), řádka enginu a pod plnou linkou text. Delší příspěvek má vedle úvodu obsah článku s popiskem po hashi, oddělený čárkovanou linkou. Na konci jdou za sebou tlačítko dalšího dílu série, štítky a sdílení pod jednou čárkovanou linkou a komentáře pod druhou.

Stránka příspěvku: datum, titulek v neproporcionálním písmu, pod ním doba čtení, plná linka a text.
Příspěvek. Plná linka pod hlavičkou drží stránku, text pod ní už patří autorovi.
Příspěvek v tmavém režimu: vedle úvodu obsah článku s popiskem po hashi, mezititulky se dvěma hashi a blok kódu s akcentovou hranou vlevo a kopírováním v závorkách.
Delší příspěvek v noci: obsah, mezititulky a kód.
Konec příspěvku: tlačítko dalšího dílu, štítek, sdílení s ikonami v závorkách a komentáře s vláknem.
Konec příspěvku. Čárkované linky ho dělí na dvě části, žádný box.

Stránky enginu

Tady se pravidlo o nekreslení dat rodilo nejdéle. Engine umí archiv jako mapu čtverečků podle hustoty a první verze skinu ji jen přebarvila. Vypadala jako z jiného webu. Sloupcový graf dopadl stejně. Skončilo to u toho, co by vypsal terminál: rok a za ním dvanáct měsíců, [ 1 ][ 2 ] až [ 12 ].

Prázdný měsíc je tlumený na 50 % a není odkaz. Měsíc s příspěvky má číslici inverzně a hustota je sytost podkladu ve čtyřech krocích: 22 %, 45 % a 72 % akcentu v papíru a nakonec akcent celý. Na prvních dvou stupních je číslice inkoustem, na dalších dvou bíle. Podklad leží jen pod číslicí, závorky zůstávají stranou. Legenda pod mapou je ve stejném zápisu, méně, pak čtyři stupně jako vzorky na dva znaky, [ ▒▒ ], a více.

Štítky nejsou mrak. Jsou to slova s #, a kolikrát byl štítek použit, říká písmo: štítek s jediným příspěvkem má 11,5 px a ani neukazuje počet, od deseti je v inkoustu a od stovky tučný s počtem v akcentu.

Hledání je pole s plnou linkou pod sebou a lupou v závorkách. Nalezené slovo je ve výsledcích inverzně.

Archiv: řádek roku 2026 s dvanácti měsíci v závorkách, pět plných měsíců inverzně v různé sytosti modré, pod ním legenda.
Archiv. Dvanáct závorek na rok, sytost říká kolik.
Seznam štítků podle abecedy, pod každým písmenem zvlášť; štítek s deseti a více příspěvky je v inkoustu.
Štítky. Kolik jich je, říká písmo.
Výsledky hledání s hledaným slovem zvýrazněným inverzně.
Hledání. Nalezené slovo je vybrané, jako v terminálu.

Stav a odezva

Odezva na myš má dvě podoby. Ovládací prvek v závorkách, od přepínače vzhledu po šipku nahoru, přejde pod kurzorem do akcentu. Slovo, které někam vede, tedy titulek, štítek nebo odkaz v textu postranního sloupce, dostane podtržení v akcentu a barvu si nechá. Řádek sloupce i položka menu pod kurzorem leží na desce, měsíc archivu se pod kurzorem vybere inkoustem.

Fokus z klávesnice je vždycky obrys v akcentu. Kurzor za názvem webu bliká po 1,1 s a při omezeném pohybu stojí. V noci dostane favicona vlasový obrys; jinak se den a noc liší jen barvami, které dodá blog.

Telefon

Na úzké obrazovce se nic nepřekresluje, jen se řadí pod sebe. Tři věci ale stály za vlastní pravidlo.

Menu je do 860 px jedna řada, která se posouvá do strany. Že pokračuje, říká zeslabení na okraji, a to na té straně, kde opravdu něco je: na začátku vpravo, uprostřed na obou, na konci vlevo. Stylesheet polohu zná, žádný skript k tomu není potřeba. Prohlížeč, který neumí svázat animaci s posunem, zeslabí jen pravý okraj.

Název webu se zmenší, když by narazil do přepínačů jazyka a vzhledu. Zhruba mezi 385 a 325 px klesá plynule z 30 na 19 px. Na webu s jedním jazykem jen klesne na 24 px při 360 px.

Archiv se musí vejít na šířku telefonu se všemi dvanácti měsíci, takže závorky stojí těsně u číslice a podklad je přesně pod ní.

Titulní stránka na telefonu ve světlém režimu.
Telefon ve dne. Menu pokračuje vpravo, proto tam slábne.
Titulní stránka na telefonu v tmavém režimu.
A v noci.

Rodina

Minimal Terminal je z rodiny Minimal, skinů nad ./blog.sh. 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í (Manual přidává jeden vlastní). Terminal je jediná varianta, která nestojí na souboru Minimalu.

Příbuznost je v kázni: málo tónů, jedna barva, každé písmo má svou práci. Všechno ostatní je jinak.

MinimalMinimal Terminal
Titulek příspěvkubezpatkové písmoneproporcionální
Rohy14 px, klávesy 8, pilulky kulaté3 px
Tlačítkopilulka nebo klávesa[ slovo ]
Filtr a odkazpilulkaslovo, zvolené inverzně
Akcent neseakce a údaje enginuodkazy, fokus, kurzor, hranu kódu, úvodník
Kartadeska s rohemnic, jen linky
Úvodníkakcent rozpuštěný v papíruinverze na plném akcentu
Archivklávesy s rohem 8 pxdvanáct závorek

Kontrolní seznam

Než do skinu cokoli přidám, projdu těchhle deset otázek.

  1. Je to hlas enginu, nebo text? Podle toho mono, nebo sans. Třetí písmo neexistuje.
  2. Má to roh větší než 3 px, kroužek, stín nebo vyplněnou plochu? Pak je to špatně.
  3. Je to tlačítko? Pak má hranaté závorky s nezlomitelnou mezerou.
  4. Je to štítek, popisek, nebo mezititulek? #, # , ##.
  5. Je výplň použitá jinak než jako inverzní výběr? Pak pryč.
  6. Dá se s tím, co je v akcentu, něco udělat? Jestli ne a není to hrana kódu, má to být tlumené.
  7. Dělí linka věci stejného druhu, nebo drží stránku? Čárkovaná, nebo plná.
  8. Kreslí se tu data? Přepsat na text.
  9. Je někde barva zapsaná číslem, kromě bílé na akcentu a černé za videem? Skin smí jen číst pět proměnných webu a míchat z nich.
  10. Vejde se to na 320 px bez posuvníku, ve dne i v noci?

Změny

Skin je od ./blog.sh 1.11 součástí enginu, obleče ho site.skin: minimal-terminal a nesahá na jedinou šablonu. Až se v něm něco změní, změní se nejdřív tady.

11. 10. 2026: přibyl úvodník, připnutý příspěvek titulky inverzně na akcentu, a průvodce dostal kostru společnou celé rodině.

13. 10. 2026: průvodce se přestěhoval sem, na web enginu. Minimal mezitím přestal být kabátem jednoho webu a stal se základem rodiny; úvod a srovnání s ním jsou podle toho přepsané.

14. 10. 2026: jedno jméno pro každou věc napříč průvodci rodiny; odkazy na průvodce Minimalem a na rodinu.

16. 10. 2026: skin je od ./blog.sh 1.11 součástí enginu a obleče ho site.skin: minimal-terminal; video nebo blok kódu na začátku karty se na telefonu drží šířky sloupce.

12. 11. 2026: srovnáno s ./blog.sh 1.11. Menu se posouvá a slábne do 860 px; název na telefonu; kapitola, ve které jsi, pole ve fokusu a štítek se stovkou příspěvků v akcentu; štítky inkoustem a váhou; konec příspěvku ve dvou blocích; text ke kraji sloupce na úzké obrazovce; ikony 16 a 14 px. Všechny snímky nové.

Komentáře