Přechod na Markdown

[VojtaStruhar]

Tyhle materiály jsou naprostý poklad. Nicméně, editovat asciidoc je trošičku vstupní bariéra (alespoň pro mě). Mám pocit, že by mohlo být přínosné překlopit poznámky do markdownu, který je zkrátka populárnější a víc lidí by mohlo lehce přispět svou troškou do mlýna. Nechám to na tobě, Adame, protože z dlouhodobého hlediska jsou to tvoje materiály a na tebe padá břímě údržby 😄

Udělal jsem proof of concept pro sekci SZMGR. Frontent dělá Astro s jejich vlastním templatem Starlight. Zprovoznit to byla rychlovka, proto jsem použil tu šablonu. Ale kdybych to měl udělat pro všechny, tak bych možná zvážil custom řešení. Stále Astro (skvělý build-time framework), ale možná ne Starlight. Asi i pro nějaký lepší rozcestník mezi tématy (SZMGR, SZBC atd).

Projektík na prázdniny možná :D

[cafour]

Děkuji. :D Souhlasím, že by bylo lepší všechny poznámky překlopit do Markdownu, aby se snížila bariéra pro nové přispěvatele. Díky za proof-of-concept. Co jsi použil na konverzi z AsciiDocu do Markdownu? Pandoc nebo něco jiného?

Jsem trochu méně entuziastický ohledně přechodu z Lume na Astro nebo jiný framework. Jednak se mi na Denu vyvíjí daleko pohodlněji než na Node a druhak udržuju další 4 statické weby postavené na Lume, mezi kterými části codebase sdílím. :D Opět ale souhlasím, že ta současná šablona chce vylepšit.

Hehe. Léto utíká nějak rychle. 😅

[VojtaStruhar]

Co jsi použil na konverzi z AsciiDocu do Markdownu? Pandoc nebo něco jiného?

Jmenuje se to downdoc. Bohužel javascript :D a nebylo to uplně 100%, třeba některé tabulky to rozbilo a musel jsem je opravit ručně. Ale migraci člověk udělá jen jednou.

Jsem trochu méně entuziastický ohledně přechodu z Lume na Astro nebo jiný framework. Jednak se mi na Denu vyvíjí daleko pohodlněji než na Node a druhak udržuju další 4 statické weby postavené na Lume, mezi kterými části codebase sdílím.

Naprosto chápu :)

Deno je mi taky sympatické. Tím, že umí použít NPM balíčky by zřejmě šlo vyvíjet i s ním - link. Ale nezkoušel jsem to.

Jenom jsem to chtěl nadhodit :) ale ta motivace je trochu slabá, to uznávám. Webovky fungujou dobře tak jak jsou.

[VojtaStruhar]

A nebo použít markdown v Lume? Takhle by se možná vlk nažral a koza zůstala celá 😄

[cafour]

Jmenuje se to downdoc. Bohužel javascript :D a nebylo to uplně 100%, třeba některé tabulky to rozbilo a musel jsem je opravit ručně. Ale migraci člověk udělá jen jednou.

Supr. Vypadá to velice použitelně. :D Je s tebou v pohodě, když použiju to, co už jsi překonvertoval?

Jenom jsem to chtěl nadhodit :) ale ta motivace je trochu slabá, to uznávám. Webovky fungujou dobře tak jak jsou.

V pohodě. Díky, žes to nad hodil. Nemám nic proti Astru. V minulosti už jsem na něj dokonce párkrát koukal. Jen v tomhle případě mi přijde udržovatelnější to nechat v Lume. Neříkám ale, že se to nikdy v budoucnosti nezmění.

A nebo použít markdown v Lume? Takhle by se možná vlk nažral a koza zůstala celá 😄

To je můj plán. :D

[VojtaStruhar]

Určitě použij to co už mám! Git by měl být veřejný. Jenom bacha, linky vypadají trochu jinak 😕 tys na to odkazoval slugem a já myslím že názvem souboru.

Některé věci jsem udělal python scriptem, abych o nich měl záznam a mohl je reprodukovat později. A je to satisfying. Ale některé jsou prostě jen seach & replace ve vscode. A tabulky ručně teda. Je to vždycky napsaně v commit message, když mrkneš na tu historii.

[cafour]

Zatím jsem udělal menší chirurgický zákrok na tvých commitech a přehrál tvoje commity nad tímhle repem. Výsledek je PRko #19, ve kterém opravím, co budu muset, aby to fungovalo s Lume a pak to nasadím na produkci.