Everything else in 1.11
./blog.sh v1.11 — part 9 of 12
The main changes of 1.11 have posts of their own: a series is a chapter, the wizards know the whole file and where did /write/ go. The skins of the Minimal family have guides: Minimal, Terminal, Literal , Journal, Manual and Pictorial. This is the rest, in the order whoever runs a site will run into it. Most of it was found by the release checks on copies of three real sites, and the rest was reported by readers.
The first deploy and what it costs
Every link to a stylesheet and to a script now ends with a fingerprint of its content: ?v= and the first ten characters of the SHA-256 of the published file. The reason is simple. The host lets a browser keep a stylesheet for up to an hour and a page not at all, and every page asked for /assets/css/site.css at the same address. After a change of look, a reader got the new page with the old stylesheet. That is exactly what happened to manual.blogsh.app when it moved from extra_css to site.skin: minimal-manual: for an hour it looked like classic. And 1.11 is the release in which sites will make just that move.
It is not free. The links had no fingerprint on purpose, so that editing site.css rewrote no page. Now a change to the stylesheet means building and deploying every page: on a large archive, 47 seconds for one line with a colour. And the first deploy after the move to 1.11 sends every page to the server again.
The stylesheet itself, on the other hand, got smaller. The published file no longer carries the comments only whoever edits it needs. It is 39 kB instead of 92, and in transfer, when the server sends it compressed, 8 kB instead of 29.
The terminal and the wizards
The main menu of ./blog.sh closes only with Esc, as the hint under it says. Zero used to close it just as q did (#64); now neither does. The question after a draft is written, the one offering to keep, edit, publish, schedule or delete it, did not know about the site's other languages. On a site in more than one it now also offers [t] translate: Deutsch, or just [t] translate with a choice of language when there are several. It opens the editor for the translation and, once saved, prints the preview address (#66). translate prints that address only when a page will really be made. A translation with a title and no text is saved, but the build makes no page of it, so the address used to lead to "nothing here" (#67).
A link with no text lost its address on the first save. Now it becomes the bare address, example.com say (#65). And ./setup.sh ended by claiming the site was at http://localhost:8000/. That holds only while the preview runs, and on a site another server serves, nothing answered there. Now it says that address is the preview on this computer, for as long as you leave it running, and names separately the address where the site really is.
The macOS instructions in docs/install.md count on the Ruby Homebrew gives today, that is 4.0. Homebrew puts it where the shell looks for it by itself. The PATH line by hand is needed only where ruby -v still says the system's 2.6 after the install.
Paired devices
./blog.sh pair --list shows when each device was last seen (#59). The engine notes the time on every request a device makes, a delivered post included, and in --json returns it as last_seen, in UTC, or null. When you remove a device, its note goes too. It is an empty file in tmp/pairing/seen, so it never holds up a request.
And on a Mac: if the blog lies in Documents, on the Desktop or in iCloud Drive, turning on Remote Login is not enough. Remote users also need Full Disk Access, or the system refuses everything the app asks for. pair says so before it shows the code. For an app on the same Mac the documentation recommends --host 127.0.0.1, an address that does not change with the Wi-Fi.
The page
A post's card now carries, hidden, the hour it went out and, for a gallery, how many pictures it has (data-photos, from two up) and up to three more pictures a skin can take. Pictorial builds its mosaic from them. A search result can carry the post's first picture, but it shows only in a skin that displays it.
The lead image, the lead card and a photo post's card now take the first picture that has a file. The engine used to choose the first picture and only then ask for its file, so one image block without a file hid every picture after it.
The "On this day" card used to show its heading over an empty space. Now it is hidden and appears once it has something to show (#62). on-this-day --date no longer says "today" about every day, it names the day you ask about (#61). The cheat sheet showed a chat as code; now it shows the chat fence and under it the dialogue it makes (#63).
A long address or a run of code in the text, wider than the column, pushed the page sideways on a phone. The /type/video/ page on sean.cz was 548 px wide in classic on a screen 390 px wide, and in search results it happened in every skin. The engine now breaks such a word, and nothing that fitted the column moves. The last menu item in Manual and Terminal never lit up as current, because a stronger selector outweighed it. And search results in Pictorial lost their padding and dividing line and ran together into one block.
Then there is the hour an importer made up. b2evolution saved a day as midnight in winter time, but in the archive the summer days lie as 01:00+02:00, the same instant written in the site's zone. Sixteen posts on sean.cz therefore carried a made-up one in the morning on their card, and the first fix did not catch them. Now, for an imported post, midnight in the zone's standard time is no hour at all. Nothing changes for posts written in the engine: one in the morning there is the real time somebody wrote.
Menus and language files
When series: and url: to the same listing stand side by side in a menu, only series: lights up on a part of the series. url: used to light up as well. A menu in a language file now compares series: by its slug, so "Stavba domu" in site.yml and "stavba-domu" in site.en.yml are the same place and the build does not refuse the language. When it does refuse one, the message is wholly in the site's language, not half in Czech and half in English. And in an install whose folder has square brackets in its name (blog [1]), check and doctor no longer miss the language files.
The cost
The first deploy after the move to 1.11 sends every page again, for the reason given at the start. Going back to 1.10 is git checkout <tag> and a new build. Before that, though, series_index: has to come out of every config/site.<language>.yml, or the build stops and nothing is deployed. Menu items with series: and group: 1.10 leaves out, writes a line about it in the build, and doctor reports them as an error. site.skin, layout.series_contents and series_index: in site.yml 1.10 passes over in silence. The details are in docs/install.md.
The full list of changes is in CHANGELOG.md under 1.11.
Comments