build: experiment: create static html from markdown #1

Closed

liketechnik wants to merge 1 commit from ci/gen-static-html into main

liketechnik commented

2024-05-10 21:06:07 +00:00

(Migrated from github.com)

Ref: "the wiki requires JS to work" https://forum.aux.computer/t/the-auxolotl-wiki-is-up/463/42?u=liketechnik

An idea I couldn't quite get out of my head and relatively quickly got working: use pandoc to convert the markdown into static html pages.

Not sure if we want this, because:

infra side of this is unclear (does this need maintenance, how is it published, etc)
has some rough edges (the links between wiki pages use absolute urls like /getting-started, which causes issues, i.e. even when served with python3 -m http.server the urls cannot be resolved, since in that case the .html is missing)

Ref: "the wiki requires JS to work" https://forum.aux.computer/t/the-auxolotl-wiki-is-up/463/42?u=liketechnik An idea I couldn't quite get out of my head and relatively quickly got working: use pandoc to convert the markdown into static html pages. Not sure if we want this, because: - infra side of this is unclear (does this need maintenance, how is it published, etc) - has some rough edges (the links between wiki pages use absolute urls like `/getting-started`, which causes issues, i.e. even when served with `python3 -m http.server` the urls cannot be resolved, since in that case the .html is missing)