Dnes som vynaložil značné úsilie na opravu mnohých drobných chýb na blogu, ktoré sa časom nahromadili — buď preto, že blog bol prevedený zo Sapper na Zola, čo prirodzene spracováva niektoré drobnosti Markdownu inak, alebo kvôli preklepy v slovách. Rozoberme najdôležitejšie zmeny.

Úplne som odstránil poznámky pod čiarou #

Experimentoval som s poznámkami pod čiarou v Markdowne. Hoci boli predtým väčšinou bez problémov podporované, ich podpora v Zola nie je dokonalá. To však nie je problém. Aj tak som ich používal prevažne len na hypertextové odkazy, čo je v každom webovom kontexte vrátane Markdownu plne pokryté. Nenašiel som žiadny iný blog, ktorý by poznámky pod čiarou hojne využíval, a ich použitie výrazne znižuje prenosnosť.

Existoval článok o zobrazovaní výzvy na odomknutie SSH pomocou KeePassXC, ktorý používal poznámky pod čiarou pre skutočné bloky textu. Tu by boli poznámky pod čiarou celkom namieste, keby to bola súčasť nejakej e-knihy. Keďže ich Zola nevykreslilo, jednoducho som ich presunul do závoriek.

Opravil som množstvo tagov #

Publikovanie príspevku denne popri iných úlohách si vybralo svoju daň na kvalite a množstve tagov použitých v príspevkoch. Táto revízia sa zamerala na chýbajúce alebo nesprávne tagy. Sú teraz dostupné aj na Tagoch. Keby som len našiel spôsob, ako zmeniť ich poradie, a prípadne ich trochu upraviť vizuálne. Aspoň sú prístupné.

Opravil som pretekanie bloku kódu #

Kód v blokoch kódu pretekalo doprava. Ak téma zvýraznila text jasnou farbou, bol takmer neviditeľný na podobne sfarbenom pozadí. Oprava bola v súbore SCSS:

pre code {
  white-space: pre-wrap;
}

Uvedený úryvok je len holé minimum, ale to bolo všetko, čo bolo treba. Stále si nie som istý, či je to kompatibilné naprieč väčšinou prehliadačov a či je to vôbec správny spôsob, ale zatiaľ to plní účel — kód teraz zodpovedá ohraničeniu bloku kódu, je ľahké ho skopírovať a takmer rovnako ľahké čítať, aj keď niekedy nie je úplne zrejmé, čo je nový riadok a čo len zalomenie.

Kontrola pravopisu každého príspevku #

Toto je objem práce, ktorý šiel do masívneho commitu so 123 zmenenými súbormi, 1043 vloženiami(+) a 807 zmazaniami(-), ktorý vyzerá takto:

Výstup git diff --stat commitu opráv preklepov.

Gitea dokonca odmietla zobraziť celý commit kvôli obrovskému množstvu zmenených súborov. Na kontrolu pravopisu som sa nesústredil hneď od začiatku, ale keďže som prechádzal súbor po súbore, tu menil tag, tam konvertoval poznámku pod čiarou, rozhodol som sa úlohy skombinovať.

Najprv automatizovaná práca #

Najprv som použil nástroj typos na automatickú kontrolu väčšiny preklepov.

typos -w

Toto výrazne zjednodušilo manuálnu prácu a je dosť presné. Problém, ktorý som objavil, je, že sa pokúša opravovať aj URL adresy. Ak platný koncový bod URL obsahuje preklep, opraví ho a URL sa pravdepodobne stane 404. Toto treba mať na pamäti pred použitím. Vyriešil som to nastavením správnych záznamov pod [default.extend-words] v _typos.toml.

Potom manuálna práca #

Hoci typos je celkom výkonný nástroj, opravil len zlomok preklepov, ktoré som urobil za rok blogovania. Použil som vim spell, ale štandardný anglický slovník nemal veľa slov, najmä mená, takže som ich musel pridávať do lokálneho slovníka. Chcel som blog urobiť prenositeľnejším, preto som sa rozhodol pre slovník na úrovni projektu pomocou pluginu vim-dialect. V čase písania nebol aktualizovaný viac ako 4 roky, ale napriek tomu splnil účel skvele.

Celý manuálny postup kontroly pravopisu trval asi 7 hodín písania, ale teraz všetky príspevky obsahujú oveľa menej preklepov, nesprávnych tagov, nesprávne vykreslených poznámok pod čiarou alebo pretekajúcich blokov kódu — takže to stálo za to. Zostaňte naladení na ďalšie.