]>
description | 🧸📔 Bjørn: A minimal static‐site generator |
last change | Sat, 27 May 2023 00:02:43 +0000 (17:02 -0700) |
URL | https://git.ladys.computer/Beorn.git |
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.
[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-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.
15 months ago | 0.2.4 | Version 0.2.4 | tag | | commit | shortlog | log |
16 months ago | 0.2.3 | Version 0.2.3 | tag | | commit | shortlog | log |
16 months ago | 0.2.2 | Version 0.2.2 | tag | | commit | shortlog | log |
16 months ago | 0.2.1 | Version 0.2.1 | tag | | commit | shortlog | log |
16 months ago | 0.2.0 | Version 0.2.0 | tag | | commit | shortlog | log |
16 months ago | 0.1.0 | Version 0.1.0 | tag | | commit | shortlog | log |
15 months ago | current | shortlog | log | tree |