News for hackers. Stuff that matters.
Re:RIP Jekyll (The Genesis of the Jamstack) by cxr on Monday September 13, 2021 @08:49PM (#28518839)
Instead of a traditional static site generator, put some content at /colophon that lists the transformations that need to be applied to produce the desired output, and then have a machine perform those steps.
Re:RIP Jekyll (The Genesis of the Jamstack) by CRConrad on Wednesday September 15, 2021 @02:42PM (#28542722)
This "machine [that] perform[s] those steps" sounds exactly like it is a static site generator.
Re:RIP Jekyll (The Genesis of the Jamstack) by cxr on Wednesday September 15, 2021 @06:04PM (#28544979)
Yes, that is the intended meaning. This static site generator is non-traditional; it should live as first-class content on one of the pages of the site it outputs. This is not the way traditional static site generators work, although they should.
Re:RIP Jekyll (The Genesis of the Jamstack) by CRConrad on Thursday September 16, 2021 @05:11PM (#28557675)
Sounds like a fucking weird place to keep it, so I don't think they should.
Re:RIP Jekyll (The Genesis of the Jamstack) by cxr on Thursday September 16, 2021 @05:32PM (#28557952)
Not weird to suggest that an organization's website should serve as that organization's knowledge repository. Weird is the tradition of building out websites that are little more than Potemkin villages for the entity they represent. A Engelbart-style DKR <https://www.dougengelbart.org/content/view/190/> is certainly not bizarre as willingly participating in the inconvenience of relying on out-of-band documentation like a README that exists only in the source repository that lives on, say, GitHub, and a set of scripts/binaries that you have to download/install/configure separately and whose esoteric conventions you will have forgotten by the next time you try to update the site a year and a half later <https://corytheboyd.com/posts/2020-03-09>—or worse, you find those tools no longer work, even though you do remember how to use them.