V současné době je proces publikování newsletteru Česko.Digital neefektivní a zahrnuje velké množství manuálních činností. Diskutovali jsme situaci se @zoul, a navrhujeme následující změny ve workflow:

• Vzhledem k tomu, že obsah pro newsletter je identický s obsahem, který se publikuje v příslušném příspěvku na blogu (newsletter, blog), navrhujeme úplně zrušit repositář cesko-digital/newsletter, a jako výchozí obsah pro newsletter použít repositář cesko-digital/blog.

• Tím odstraníme nutnost obsah připravovat dvakrát — jednou ve formátu mjml pro newsletter, jednou v Markdownu pro blog. Jediným zdrojem bude Markdown. Z hlediska formátování přijdeme pouze o dvousloupcový layout v sekci „To nejlepší z našich projektů“, což nám přijde přiměřená cena za tak radikální snížení objemu manuální práce.

• Finální výstupy z Markdown obsahu jsou dva: a) HTML pro blog, b) HTML pro newsletter. V případě blogu se technicky nic měnit nebude. V případě newsletteru implementujeme post-processing, který z Markdown nejdřív vyrobí mjml, z něhož pak vyrobí (komplikované a ulítlé) HTML pro newsletter.

• Post-processing implementujeme pomocí Github Actions pro a) pull requesty, b) push/merge do hlavní větve. Pull requesty pak budou sloužit k náhledu blogu i newsletteru před publikací.

• Pro získání finálního HTML pro newsletter (copy & paste do Ecomail) chceme implementovat ovládací panel, ve výchozím zobrazení skrytý, který umožní vložení finálního HTML přímo do stránky.

Finální workflow pak bude vypadat takto:

1. Obsah pro newsletter je připravován v Markdown, v repositáři cesko-digital/blog (příklad), pomocí Netlify CMS (nebo v editoru).

2. Pro každou úpravu se se vytvoří pull request (příklad). Vercel automaticky nasadí preview (příklad), které umožní zkontrolovat obsah vizuálně.

3. Na preview stránce je k dispozici ovládací panel s tlačítkem Kopírovat HTML pro newsletter, které do schránky vloží specifické HTML, připravené k přímému použití v rozhraní Ecomail, a tedy k rozesílání. Je tudíž možné získat HTML pro newsletter ještě před následnou publikací newsletteru na blog.cesko.digital, k němuž dojde zamergováním pull requestu.

Odstraňujeme tak časově náročnou práci spojenou s konverzí textu newsletteru do mjml formátu.

Technické poznámky:

• Workflow pro publikaci HTML na webu blog.cesko.digital se nijak nemění.
• Pro získání HTML pro newsletter potřebujeme z Markdownu vygenerovat mjml XML, a z něho následně HTML (viz stávající skript).
• Výsledné HTML pro newsletter uložíme jako .html v sestaveném webu (pro zkopírování do stránky nebo přímé načtení v prohlížeči)
• Zrušíme repositář zoul/cist.digital, který není používán.
• Zavedeme automatické přesměrování na aktuální vydání na titulní stránce blog.cesko.digital. Nadále tedy nebude potřeba provádět manuální úpravy v souboru now.json (příklad).