Repository navigation
./blog.sh 1.11
./blog.sh 1.11 — the release about how a site looks.
Until now a site's look was one stylesheet and seven colours. 1.11 splits it in two: the engine's rules, which every site shares, and a skin, which says how those rules look. site.skin: picks one; a site that says nothing gets classic and looks exactly as it did. Beside Classic ships a whole family — Minimal and five variants, each a different idea of what a blog page is. A series can now be a chapter of the menu, the wizards ask what only site.yml could, and the /write/ page is gone. Nothing to migrate — but the first deploy sends every page once.
Six skins in one family. Minimal is paper, ink and one colour, and the base the other five share without changing it. Literal sets one column in the middle in a book's serif and measure. Journal is a diary: a line of time down the left, the date as each entry's heading. Manual turns series into chapters down the side and numbers a page's sections. Pictorial is a wall of pictures three across, with the words as their caption. Terminal prints a page as a terminal would: two faces and square brackets. Each is one line, site.skin: minimal or minimal-<name>, and ./style.sh asks which.
A series is a chapter. A menu item can name a series with series: — it leads to the series' listing and lights up on every part of it, in every skin. { label: "…", group: true } heads the items under it. series_index: gives the page of every series a title, a description and an order, and layout.series_contents lists every part on each part's page, under "part N of M". Together that is enough to run a manual: manual.blogsh.app is one.
What a skin can pick up. A card carries the hour its post went out, hidden, and never an hour an importer made up. A gallery's card says how many pictures it holds and hands a skin its next three; Pictorial lays them out as a mosaic. A search result can carry the post's first picture. None of it shows in Classic; all of it is there for a skin that wants it.
Lighter, and never stale. The published stylesheet leaves its comments behind: 92 kB became 39, and 29 kB over the wire became 8. Every stylesheet and script link carries a fingerprint, ?v= and ten hex digits, so a changed file is a new address and no reader is ever left with yesterday's look from their cache.
The wizards ask the rest. ./style.sh asks the skin and the lead card, and with a series the contents and the index. ./setup.sh sets what used to mean opening site.yml by hand: the banner's picture, sharing, tag icons, comment approval, a Bluesky PDS, media and blocking AI crawlers. A draft can go straight on to its translation from the question after the editor. And the wizards themselves got stricter about what they touch: a value they did not change, a comment beside it, a hand-drawn icon_svg — each stays as written.
/write/ is gone. The writing page, everything the build published under it, and the SendPost shortcut are out, as 1.10 said they would be; doctor names a write: left in a site's config. What 1.10 announced along with them stays after all: scripts/receive.sh, with publish.txt and drafts.txt, is unchanged, and incoming/ still takes a picture from any SFTP client. The native apps for iOS and Android will come in through the door 1.10 opened.
Fixed. A link with no text lost its address on the first save. The cheat sheet showed a chat as code. 0 in the main menu closed ./blog.sh, and Esc in a pick among items took the first one — "which to remove?" removed it. Enter in the palette proposed a palette nobody asked for. ./setup.sh sent people to localhost:8000 as if the site were there, and rewrote env.sh lines it had not changed. A long address pushed a page sideways on a phone. on-this-day --date called any day "today", and its card showed a heading over nothing. pair --list now says when each device was last seen. Two review passes went over this release before the tag; what they found is fixed and pinned by a test that fails on the old code.
Upgrading — git pull, rebuild, deploy. Nothing to migrate, and a site that does not set site.skin looks as it did. Because every link now carries a fingerprint, the first deploy sends every page once — on sean.cz, 14,481 of its 20,529 files; the pictures stay where they are. A cold build costs within a few percent of 1.10's, and a cached rebuild what it did. If site.yml still says write:, delete the line. And if you ever go back to 1.10, docs/install.md says what a 1.11 config does to it — series_index: in a language file stops the build there.
Full notes in CHANGELOG.md.
MIT licensed. Documentation · blogsh.app