Generate site in a sane way #4

New Issue

ktyl · 2022-09-28T02:50:10+02:00

ktyl commented

2022-09-28 02:50:10 +02:00

The site is currently generated using a bizarre conglomeration of Make and Python with a home-grown templating system.

While fun, this approach has its downsides:

Build system development needs to lead content
No documentation
Make is fun but deranged
Local builds take ages due to repeated invocation of Python runtime
Blog-via-submodule setup is complex and not particular detached
Custom templating system is brittle and featureless

1, 2, 4 and 6 are directly addressed by using an off-the-shelf site builder instead of this custom thing. 3 would be mitigated somewhat: Make is still useful for shell integration, but would no longer need to fill the role of managing a build system. 5 would likely be ameliorated too, since converting a dated folder hierarchy is not a new problem.

To pick a new site builder, some requirements should be outlined to compare possible options against:

Write generic content in Markdown
Also write more custom content in HTML
Templating at least on par with ppp.py

Current options under consideration:

kiln

Of these, kiln looks to be the simplest, but is Gemini-focused and in "low maintenance" mode. Though it mentions templates, it is not clear how they are intended to work.

The site is currently generated using a bizarre conglomeration of Make and Python with a home-grown templating system. While fun, this approach has its downsides: 1. Build system development needs to lead content 2. No documentation 3. Make is fun but deranged 4. Local builds take ages due to repeated invocation of Python runtime 5. Blog-via-submodule setup is complex and not particular detached 6. Custom templating system is brittle and featureless 1, 2, 4 and 6 are directly addressed by using an off-the-shelf site builder instead of this custom thing. 3 would be mitigated somewhat: Make is still useful for shell integration, but would no longer need to fill the role of managing a build system. 5 would likely be ameliorated too, since converting a dated folder hierarchy is not a new problem. --- To pick a new site builder, some requirements should be outlined to compare possible options against: 1. Write generic content in Markdown 2. Also write more custom content in HTML 3. Templating at least on par with ppp.py --- Current options under consideration: * [kiln](https://kiln.adnano.co/02-setup/) Of these, kiln looks to be the simplest, but is Gemini-focused and in "low maintenance" mode. Though it mentions templates, it is not clear how they are intended to work. * [pelican](https://getpelican.com/) * [Hugo](https://gohugo.io/) * [zola](https://www.getzola.org/)

ktyl changed title from ~~look into pelican for static site generation~~ to use a more standard static site generator

2023-03-14 01:29:29 +01:00

ktyl changed title from ~~use a more standard static site generator~~ to sensible static site generation

2023-03-14 01:30:42 +01:00

ktyl changed title from ~~sensible static site generation~~ to Generate site in a sane way

2024-06-05 23:52:18 +02:00

ktyl added the

enhancement

label 2024-06-06 00:11:18 +02:00

ktyl self-assigned this 2024-06-06 00:12:01 +02:00

ktyl commented

2024-06-08 17:42:42 +02:00