Série./blog.sh v1.1112

./blog.sh 1.11

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

./blog.sh 1.11 je venku — vydání na GitHubu.

Vydání o tom, jak web vypadá. Vzhled jsou teď dvě věci: pravidla enginu, která sdílí každý web, a skin, který říká, jak vypadají. Vybírá ho site.skin a web, který nic neřekne, zůstane v Classicu přesně takový, jaký byl. Vedle Classicu přichází rodina Minimal: samotný Minimal — papír, inkoust a jedna barva — a pět variant na něj, Literal, Journal, Manual, Pictorial a Terminal. Tenhle web nosí Terminal a příručka Manual.

Série teď může být kapitolou menu: položka ji pojmenuje a svítí na každém jejím dílu a skupina dává nadpis položkám pod sebou. ./style.sh se zeptá na skin a ./setup.sh nastaví, co dřív znamenalo otevřít site.yml ručně — obrázek v banneru, sdílení, schvalování komentářů, média. Každý odkaz na styl a skript nese otisk, takže žádnému čtenáři nezůstane včerejší vzhled z mezipaměti.

Stránka /write/ a zkratka SendPost skončily, jak 1.10 ohlásila. scripts/receive.sh zůstává a appky pro iOS a Android přijdou dveřmi, které otevřela 1.10.

Nic se nepřevádí — git pull, sestavení, nasazení. Kvůli otiskům pošle první nasazení jednou všechny stránky; běžný den publikování stojí, co stál. Pokud site.yml ještě obsahuje write:, řádek smaž. Celé poznámky →

Kam odešel /write/

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

Od 1.11 stránka /write/ neexistuje. Její odchod ohlásila už 1.10: stránka, ze které se dalo psát z telefonu, i zkratka SendPost mizí a nahrazují je appky. Android appka je venku. Appka pro iPhone zatím ne, a hlavně o tom tenhle příspěvek je.

Co přesně zmizelo

Zmizela stránka /write/ s editorem, náhledem a řadou značek, soubory, které pro ni build kopíroval, její site.js a odpovědi pod /write/r/. Zmizela také zkratka SendPost. Stránka se zapínala řádkem write: true; kdo ho nikdy nepoužil, nemá si čeho všímat.

Kdo ji zapnul, nic předělávat nemusí. ./blog.sh doctor upozorní na zbylý klíč write: a nic dalšího se nezmění. První nasazení po aktualizaci stránku z webu sundá, takže odkazy na ni povedou na chybu 404; ./blog.sh check každý takový odkaz vyjmenuje (link_dead). Při návratu na 1.10 se write: true projeví znovu a stránka se zase zveřejní.

Číst dál

Série je kapitola

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

Příručka k tomuhle enginu, kterou drží manual.blogsh.app, má 75 stránek v deseti kapitolách, a každá kapitola je jedna série příspěvků. Do 1.10 to byla série, o které menu nevědělo. Do menu šel štítek, stránka nebo adresa. Adresu série tam dát šlo, jenže na jejích dílech se nerozsvítila, takže čtenář uprostřed kapitoly nepoznal, že v kapitole je.

1.11 tohle spravuje čtyřmi věcmi, které k sobě patří a dají se zapnout každá zvlášť.

Série jako položka menu

nav:
  - { label: "Úvod", url: "/" }
  - { label: "Fotky", tag: "foto" }
  - { label: "První kroky", series: "První kroky" }

Položka series: bere jméno série tak, jak ho píšou příspěvky, nebo její slug, a vede na její výpis. Na každém jejím dílu se rozsvítí, ale jinak než na samotném výpisu: výpis je stránka, na které jsi, díl je kapitola, ve které jsi. Čtečka obrazovky dostane dvě různé hodnoty aria-current, "page" a "true", skin dva selektory, a každý skin, který engine nese, je kreslí odlišně.

Číst dál

Průvodci znají celý soubor

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

Soubor config/site.yml má v příkladu, ze kterého se zakládá, 706 řádků, většinu z nich komentář. Nikdo ho nemusí číst celý, protože na to jsou dva průvodci: ./setup.sh se ptá na to, co web potřebuje, aby vůbec stál, a ./style.sh na to, jak vypadá. Zapíšou soubor za tebe, bez tabulátoru tam, kde patří mezera, a nic nezapíšou, dokud jsi neviděl rozdíl a nepotvrdil ho.

V 1.10 to ale byla jen část souboru. Co se průvodci nezeptali, to se muselo hledat v souboru a psát rukou. 1.11 přidala klíče, které šlo nastavit jen tam, a průvodci se je teď naučili.

Nové otázky

./style.sh se teď ptá na:

Číst dál

Minimal: papír, inkoust a jedna barva

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

Minimal vznikl jako kabát pro sean.cz a měl tam zůstat. Jenže z něj mezitím vyrostla rodina: Minimal Terminal, Pictorial, Literal, Journal a Manual. A varianty něčeho, co si nikdo nemůže vzít, nedávají smysl. Minimal je proto od teď základ rodiny a skin, který si může obléct kterýkoli blog na ./blog.sh.

Sean.cz si nechává svou edici se třemi vlastními písmy, krémovým papírem a oranžovou; ta má vlastní manuál. Tenhle průvodce popisuje Minimal tak, jak ho dostane každý: dvě písma, která veze engine, a barvy blogu, na kterém běží. Všechny ukázky jsou z tohohle webu ve výchozí paletě enginu. Kdo nechce číst všechno, najde na konci deset otázek kontrolního seznamu.

Jedna věta

Minimal je stránka z papíru a inkoustu s jednou barvou, která patří jen tomu, co jde stisknout, a tomu, co ví engine. Je to jeden stylesheet nad ./blog.sh, bez jediného dalšího souboru, a základ, na kterém stojí čtyři z pěti dalších skinů rodiny. Každý z nich má vlastní průvodce se stejnými oddíly ve stejném pořadí (Manual přidává jeden vlastní). Od ./blog.sh 1.11 je Minimal součástí enginu a oblékneš ho řádkem site.skin: minimal v config/site.yml, stejně jako v ./style.sh v části Layout; projeví se po ./blog.sh rebuild.

Číst dál

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.

Číst dál

Minimal Literal: jeden sloupec a patkové písmo

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

Minimal je stavěný na krátké věci: výpis, úvod na tři řádky, postranní sloupec, ve kterém se pořád něco děje. Na delší text to stačí, ale čte se v něm jako v novinách, mezi vším ostatním. Minimal Literal je varianta pro blogy, kde je text to hlavní a kde se čtou delší kusy. Stránka je v něm sazba knihy.

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. Všechny ukázky jsou z tohohle webu ve výchozí paletě enginu. Kdo nechce číst všechno, najde na konci deset otázek kontrolního seznamu.

Jedna věta

Minimal Literal je stránka jako sazba knihy: jeden sloupec uprostřed, patkové písmo ve velikosti, ve které se dá číst dlouho, a kolem textu nic, co by do něj mluvilo. Je to skin pro blogy na ./blog.sh, 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-literal v config/site.yml, stejně jako v ./style.sh v části Layout; projeví se po ./blog.sh rebuild.

Pravidla

Číst dál

Minimal Journal: linka času

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

Minimal řadí výpis podle titulků: titulek, tři řádky úvodu a datum drobně na okraji. Deník to má obráceně. Nejdřív je den, pak to, co se v něm stalo, a spousta záznamů žádný titulek nemá. Minimal Journal je varianta pro takové blogy. Stránka je v něm deník a řídí ji čas.

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. Všechny ukázky jsou z tohohle webu ve výchozí paletě enginu. Kdo nechce číst všechno, najde na konci deset otázek kontrolního seznamu.

Jedna věta

Minimal Journal je deník: po levém kraji výpisu běží linka času, každý záznam na ní visí svým datem a čte se celý. Je to skin pro blogy na ./blog.sh, 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-journal v config/site.yml, stejně jako v ./style.sh v části Layout; projeví se po ./blog.sh rebuild.

Pravidla

Pět vět, kterými se liší od Minimalu. Jeho vlastních pět platí dál.

Číst dál

Všechno ostatní v 1.11

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

Hlavní změny 1.11 mají vlastní příspěvky: série je kapitola, průvodci znají celý soubor a kam odešel /write/. Skiny rodiny Minimal mají průvodce: Minimal, Terminal, Literal , Journal, Manual a Pictorial. Tady je zbytek, seřazený tak, jak na něj narazí ten, kdo web provozuje. Většinu z toho našly kontroly vydání na kopiích tří skutečných webů a zbytek nahlásili čtenáři.

Číst dál

Minimal Manual: kapitoly, oddíly a čísla

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

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

Číst dál

Minimal Pictorial: stěna s fotkami

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

Minimal počítá s tím, že příspěvek začíná slovy: titulek, úvod na tři řádky, a obrázek, pokud nějaký je, až v příspěvku. Fotoblog to má obráceně. Fotka je příspěvek a slova jsou popisek, někdy jen datum. Minimal Pictorial je varianta pro takové blogy. Stránka je v něm stěna s fotkami.

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 ze zkušebního blogu ve výchozí paletě enginu. Kdo nechce číst všechno, najde na konci deset otázek kontrolního seznamu.

Jedna věta

Minimal Pictorial je stěna s fotkami: obrázek je to první, co vidíš, a slova jsou popisek pod ním. Je to skin pro blogy na ./blog.sh, 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-pictorial v config/site.yml; hodí se k němu layout.lead_card: true a stránka o devíti nebo dvanácti příspěvcích, skin i úvodník nastaví také ./style.sh. Průvodce ho popisuje ve stavu 1.11.1.

Pravidla

Číst dál

./blog.sh 1.11.1

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

./blog.sh 1.11.1 je venku — vydání na GitHubu.

Opravné vydání. Většina z něj odpovídá na pět hlášení na GitHubu (#70 až #74) od někoho, kdo v enginu píše každý den, a zbytek vzešel z kontrol vydání, které nad ním proběhly potom. Nic nového se učit nemusíš; pár věcí teď dělá to, co se od nich čekalo odjakživa.

Klávesy. Velké písmeno je ve všech obrazovkách ./blog.sh stejná klávesa jako malé, prohlížeče archivu nevyjímaje, takže zapnutý Caps Lock už nabídku neohluší (#70). Terminál, který posílá písmena jako „č“ v Latin-2, dostane „nerozumím“ místo pádu.

Fronta. Když příspěvek plánuješ, řádek pod nabízeným slotem říká, co Enter přijme: právě ten slot (#74). Naplánovaný příspěvek, který znovu otevřeš, se ptá jako naplánovaný, nechat, publikovat hned, nebo přesunout, a ten, jehož čas už minul, se ohlásí jako zpožděný (#71).

Číst dál