Lady’s notes :⁠—

• [2023-05-01] This repository was originally imagined as a “template” that one would fork and then customize the scripting of as needed. You can definitely still do this, but I’ve found that it is also useful to pull and run the build script from e·g the raw U·R·L available here through Gitweb.

  • [2024-12-14] Don’t literally use the U·R·L for this Gitweb, tho, as it carries no uptime guarantees. Fork it and reference it from some·place you control.

• [2023-05-01] This needs a major refactor to make it easier to extend and customize. Probably what this will look like is defining some global hooks on globalThis which, if set, can transform the output (with an assumption of using it like

  globalThis.transformHook = (tree) => transformed(tree);
  
  // Use a dynamic import to ensure this loads *after* the hooks have
  // been set.
  await import("https://an.example/path/to/beorn/build.js");
  

  ). I do not particularly want this to turn into a fully‐featured static site generator plugin system (just use a real S·S·G if that’s what you need) so it will probably continue to be hacky and punk and terrible.

  • [2023-05-02] This is done.

• [2023-05-01] This also needs a bunch of documentation, but it’s really not a priority. Check out https://git.ladys.computer/Blog for an example blog which is built from this, and follow its lead.

• [2023-05-01] Pagination hasn’t been implemented for this yet, because I don’t have any blogs with enough posts for it to matter. But it will need to be at some point. There are two options :⁠—

  • Page‐based pagination with a set number of posts per page. Index pages count backwards (index-1.html, index-2.html…) while feed archive pages count forwards (archive+0.atom, archive+1.atom…).

  • Date‐based pagination (per‐month; 2023-04.html, 2023-04.atom…).

  Ideally both of these would be supported as they offer different strengths.