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:

  • skin, z těch, které engine nese (classic první, ostatní podle jména, a skin, který sis do webu přidal sám, podle názvu souboru),
  • úvodní kartu (layout.lead_card), hned vedle otázek na postranní panel a úvodní obrázek,
  • series_contents a series_index, ale jen na webu, který nějakou sérii má, protože jinde by to byly dvě další klávesy Enter v sekci o něčem, co web nemá,
  • obrázek v záhlaví: vypnutý je záhlaví jméno a popis jako text, což se hodí k Minimal Terminal,
  • sdílení: které sítě pod příspěvkem a v jakém pořadí,
  • ikony štítků, vlastní sekce,
  • položku menu pro sérii, tam, kde ji archiv má.

./setup.sh se ptá na:

  • které odpovědi se pod příspěvkem ukazují (comments.approval), a než si vybereš, řekne, co to stojí, když zůstanou jen ty oblíbené,
  • vlastní PDS u Bluesky, jen s adresou na https,
  • HEIC, přebalení videa a polohu v fotkách (media),
  • prosbu k robotům, kteří sbírají text pro AI (seo.block_ai_crawlers).

Poslední dvě skupiny stojí za jednou otázkou, kterou Enter přeskočí, aby první spuštění zůstalo stejně dlouhé jako dřív. A hodnota, kterou web už má, se nepřepisuje.

Co zůstává souboru

Zbylo málo a je to vzácné nebo je to kód: site.author_name, druhý jazyk (site.locales), ikona nakreslená jako SVG, barvy nadpisu a hesla v záhlaví, mastodon.toot_length a link_length, publishing.allow_partial, seo.robots_extra a deploy.keep. Říct, že průvodci znají celý soubor, tedy není úplně pravda. docs/install.md proto vyjmenuje, co kryje který z nich a co zbývá ruční úpravě.

Co jsi psal, to zůstane

Druhá půlka téhle změny není vidět na otázkách. Je vidět na rozdílu, který průvodce před zápisem ukáže.

Průvodce, který měnil jednu položku seznamu, napsal celý seznam znova. Když se na blogsh.app přidala jedna ikona štítku, každá ručně nakreslená icon_svg z jednoduchých uvozovek přešla na uvozovky dvojité s každou uvozovkou zpětně, menu z položek na jednom řádku se rozbalilo na bloky, komentáře mezi položkami zmizely a rozdíl ukázal dvanáct změněných řádků pro jednu novou položku. Hodnoty se četly stejně. Soubor a rozdíl ne.

Teď průvodce seznam rozebere tak, jak stojí: každou položku s jejími řádky, s komentáři a prázdnými řádky před ní a se sloupcem, ve kterém položky stojí. Položka, která se rovná té v souboru, přejde slovo od slova. Zapíše se jen nová nebo změněná. Na kopiích blogsh.app, sean.cz a manuálu teď rozdíl ukazuje přesně tu změnu: jedna ikona štítku jsou dva řádky, jedno místo ke sdílení jeden, jedna položka menu pryč jeden.

Výjimka je seznam, který se nedá rozebrat najisto, napsaný celý na jednom řádku (share: [mastodon, email]) nebo daný aliasem. Ten se zapíše znova, jako dřív. Seznam, který průvodce nezměnil, se nezapíše vůbec.

Zpátky znamená zpátky

Esc u otázky „kterou položku odebrat?“ vzal první z nabídky. Výběr mezi položkami nemá žádnou „současnou“, a tak spadl na první. Couvnout z odebírání tedy odebralo ručně nakreslenou ikonu štítku, kterou průvodce neumí vrátit. Esc u takového výběru teď nevybere nic a nic se nestane. Enter skrz celou sekci taky nic nezmění: classic na webu, který žádný skin nepojmenoval, a každý přepínač na hodnotě, kterou engine zná sám, se zapíše jako nic.

Dva jazyky, dva soubory

Jazykový soubor config/site.cs.yml pojmenovává menu položku po položce a musí vést na stejná místa jako seznam webu, jinak build jazyk odmítne. ./style.sh ale psal menu webu a jazykové seznamy nechal být. Na blogsh.app obyčejná změna menu nechala web, který nešel postavit v žádném jazyce, a průvodce k tomu nic neřekl.

Teď se každý jazyk, který web vydává a jehož soubor má seznam menu, tvaruje spolu s webem. Položka, která zůstala, si nechá slovo toho jazyka, nová se zapíše bez slova (build vezme slovo webu a check to řekne) a odebraná zmizí. Jazykové soubory se ukážou v rozdílu spolu se site.yml a zapíšou se až po tvém ano.

A když se jednou píšou dva soubory najednou, každý se nejdřív přečte v paměti. Odmítne-li jeden z nich poté, co už druhý byl uložen, uložený se vrátí zpátky. „Nic se nezměnilo“ pak opravdu znamená, že nic.

A env.sh

Průvodce ./setup.sh zapisuje i tajemství, tedy env.sh. Řádek, který už hodnotu dává, nechá tak, jak je napsaný (holý, v uvozovkách, s komentářem). Řádek, kterému nerozumí najisto, přepíše. Řádek, který přiřazuje dvě jména, nechá celý, i když se mění první z nich, a novou hodnotu napíše pod něj. A rozdíl před zápisem zakryje tajnou hodnotu kdekoli na řádku, ne jen na začátku.

Co z toho plyne

Úprava souboru rukou je s tímhle enginem plnohodnotná cesta, ne nouzovka, a pro ./blog.sh doctor platí totéž co dřív: přečte, co jsi napsal, a ohlásí všechno najednou. Průvodce ale dnes umí víc než „nabídnout základ“. Dá se spustit nad souborem, který máš rok vlastnoručně upravený, a změní jen to, o co jsi požádal. Kdyby se přece jen něco nepovedlo, zbyde po něm config/site.yml.bak, kterým se běh vrátí zpátky.

Komentáře