Series./blog.sh v1.1112

./blog.sh 1.11

./blog.sh v1.11 — part 1 of 12

./blog.sh 1.11 is out — release on GitHub.

The release about how a site looks. The look is now two things: the engine's rules, which every site shares, and a skin, which says how they look. site.skin picks one, and a site that says nothing stays Classic, exactly as it was. Beside Classic ships the Minimal family: Minimal itself — paper, ink and one colour — and five variants on it, Literal, Journal, Manual, Pictorial and Terminal. This site wears Terminal, and the manual wears Manual.

A series can now be a chapter of the menu: an item names it and lights up on every part of it, and a group heads the items under it. ./style.sh asks which skin, and ./setup.sh sets what used to mean opening site.yml by hand — the banner's picture, sharing, comment approval, media. Every stylesheet and script link carries a fingerprint, so no reader keeps yesterday's look from the cache.

The /write/ page and the SendPost shortcut are gone, as 1.10 said they would be. scripts/receive.sh stays, and the apps for iOS and Android will come in through the door 1.10 opened.

Read more

Where did /write/ go

./blog.sh v1.11 — part 2 of 12

As of 1.11 the /write/ page does not exist. 1.10 announced its leaving: the page you could write from a phone on, and the SendPost shortcut, are going, and the apps take their place. The Android app is out. The iPhone app is not yet, and that is what this post is mostly about.

What exactly went

The /write/ page went, with its editor, its preview and its row of marks, the files the build copied for it, its site.js and the answers under /write/r/. The SendPost shortcut went with it. The page was switched on with the line write: true; whoever never used it has nothing to look for.

Whoever switched it on does not have to rework anything. ./blog.sh doctor points out the write: key left behind and nothing else changes. The first deploy after the upgrade takes the page off the site, so links to it lead to a 404; ./blog.sh check names every such link (link_dead). Going back to 1.10, write: true takes effect again and the page is published once more.

Read more

A series is a chapter

./blog.sh v1.11 — part 3 of 12

The manual for this engine, kept at manual.blogsh.app, has 75 pages in ten chapters, and every chapter is a series of posts. Up to 1.10 that was a series the menu knew nothing about. A menu item could point at a tag, a page or an address. A series address could go in there, but it did not light up on the series' own parts, so a reader in the middle of a chapter could not tell they were in one.

1.11 mends that with four things that belong together and can each be switched on alone.

A series as a menu item

nav:
  - { label: "Home", url: "/" }
  - { label: "Photos", tag: "photos" }
  - { label: "First steps", series: "First steps" }
Read more

The wizards know the whole file

./blog.sh v1.11 — part 4 of 12

The example config/site.yml is made from has 706 lines, most of them comments. Nobody has to read it all, because there are two wizards for that: ./setup.sh asks what a site needs to stand at all, and ./style.sh asks how it looks. They write the file for you, with no tab where a space belongs, and they write nothing until you have seen the difference and confirmed it.

In 1.10 that was only part of the file, though. What the wizards did not ask, you had to find in the file and write by hand. 1.11 added keys that could be set only there, and the wizards have learned them.

The new questions

./style.sh now asks about:

Read more

Minimal: paper, ink and one colour

./blog.sh v1.11 — part 5 of 12

Minimal began as a coat for one site, sean.cz, and was meant to stay there. Then a family grew out of it: Minimal Terminal, Pictorial, Literal, Journal and Manual. Variants of something nobody can have make little sense. So Minimal is now the base of the family, and a skin any blog on ./blog.sh can wear.

Sean.cz keeps an edition of its own, with three typefaces, a cream paper and its orange; that one has its own manual. This guide describes Minimal as everybody gets it: the two faces the engine ships, and the colours of the blog it runs on. Every picture here is of this site in the engine's default palette. If you would rather not read all of it, there are ten questions at the end.

One sentence

Minimal is a page of paper and ink with one colour, which belongs only to what can be pressed and to what the engine knows. It is a single stylesheet over ./blog.sh, with no other file beside it, and the base four of the five other skins of the family stand on. Each of them has a guide of its own, with the same sections in the same order (Manual adds one of its own). From blog.sh 1.11 Minimal comes with the engine: site.skin: minimal in config/site.yml puts it on, as does ./style.sh under Layout, and ./blog.sh rebuild then applies it.

Read more

Minimal Terminal: two faces and square brackets

./blog.sh v1.11 — part 6 of 12

Minimal was made for a personal site, and it shows: a cream paper, pills, cards. When I tried it on a blog about an engine that is run from a terminal, it fitted, but it said nothing of what that site is. So Minimal Terminal came about: a variant that took Minimal's discipline and said everything else in its own way. A page in it looks the way a terminal would print it.

Decisions scattered through one stylesheet and my head are not enough, so this is a guide, not a story. What is how and why, with the numbers read out of the file, not rounded. If you would rather not read all of it, there are ten questions at the end.

One sentence

Minimal Terminal is a page the way a terminal would print it: two faces, brackets for buttons, marks for shapes, and a single fill, the inverse of a selection. It is a skin for blogs on ./blog.sh, the second of the Minimal family, and it takes its colours from the blog it runs on. From blog.sh 1.11 it comes with the engine: site.skin: minimal-terminal in config/site.yml puts it on, as does ./style.sh under Layout, and ./blog.sh rebuild then applies it. It sets the name and the claim as text, so banner.show_image: false suits it.

Read more

Minimal Literal: one column and a serif

./blog.sh v1.11 — part 7 of 12

Minimal is built for short things: a listing, three lines of an opening, a sidebar where something is always going on. It will carry a longer text, but the text is read the way a newspaper is, among everything else. Minimal Literal is the variant for blogs where the text is the point and the pieces are long. In it, the page is a book's setting.

This text is a guide, not a story: what is how and why, with the numbers read out of the file. Whatever is not here is the same as in Minimal and is in its guide. Every picture here is of this site in the engine's default palette. If you would rather not read all of it, there are ten questions at the end.

One sentence

Minimal Literal is a page set like a book: one column in the middle, a serif at a size that can be read for a long time, and nothing around the text that talks into it. It is a skin for blogs on ./blog.sh, of the Minimal family, and it takes its colours from the blog it runs on. From blog.sh 1.11 it comes with the engine: site.skin: minimal-literal in config/site.yml puts it on, as does ./style.sh under Layout, and ./blog.sh rebuild then applies it.

Principles

Read more

Minimal Journal: a line of time

./blog.sh v1.11 — part 8 of 12

Minimal orders a listing by titles: a title, three lines of an opening, and the date small in the margin. A diary has it the other way round. First comes the day, then what happened in it, and many entries have no title at all. Minimal Journal is the variant for such blogs. In it, the page is a diary and time leads it.

This text is a guide, not a story: what is how and why, with the numbers read out of the file. Whatever is not here is the same as in Minimal and is in its guide. Every picture here is of this site in the engine's default palette. If you would rather not read all of it, there are ten questions at the end.

One sentence

Minimal Journal is a diary: a line of time runs down the left edge of a listing, every entry hangs on it by its date, and an entry is read whole. It is a skin for blogs on ./blog.sh, of the Minimal family, and it takes its colours from the blog it runs on. From blog.sh 1.11 it comes with the engine: site.skin: minimal-journal in config/site.yml puts it on, as does ./style.sh under Layout, and ./blog.sh rebuild then applies it.

Principles

Read more

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.

Read more

Minimal Manual: chapters, sections and numbers

./blog.sh v1.11 — part 10 of 12

Minimal is built for a blog: the newest on top, a post reached from a listing, and on you go when you have read it. A manual is not read; a manual is looked things up in. You want to know where you are, what is around you and how to get one chapter over. Minimal Manual is the variant for sites that hold documentation. In it, the page is a handbook.

This text is a guide, not a story: what is how and why, with the numbers read out of the file. Whatever is not here is the same as in Minimal and is in its guide. The pictures are of a copy of the live example, ./blog.sh manual, the engine's own documentation set in this skin, in the engine's default palette. If you would rather not read all of it, there are ten questions at the end.

One sentence

Minimal Manual is a handbook: the chapters on the left, in the middle a page with numbered sections, and on the right its contents, which stay in sight. It is a skin for sites on ./blog.sh, of the Minimal family, and it takes its colours from the site it runs on. From blog.sh 1.11 it comes with the engine: site.skin: minimal-manual in config/site.yml puts it on, as does ./style.sh under Layout, and ./blog.sh rebuild then applies it. This guide describes it as of 1.11.1, which evened out its last edges.

Read more

Minimal Pictorial: a wall of photographs

./blog.sh v1.11 — part 11 of 12

Minimal assumes that a post begins with words: a title, three lines of an opening, and a picture, if there is one, only inside the post. A photoblog has it the other way round. The photograph is the post and the words are its caption, sometimes only a date. Minimal Pictorial is the variant for such blogs. In it, the page is a wall of photographs.

This text is a guide, not a story: what is how and why, with the numbers read out of the file. Whatever is not here is the same as in Minimal and is in its guide. The pictures are from a test blog in the engine's default palette. If you would rather not read all of it, there are ten questions at the end.

One sentence

Minimal Pictorial is a wall of photographs: the picture is the first thing you see, and the words are a caption under it. It is a skin for blogs on ./blog.sh, of the Minimal family, and it takes its colours from the blog it runs on. From blog.sh 1.11 it comes with the engine: site.skin: minimal-pictorial in config/site.yml puts it on; layout.lead_card: true and a page of nine or twelve posts suit it, and ./style.sh sets the skin and the lead card too. This guide describes it as of 1.11.1.

Read more

./blog.sh 1.11.1

./blog.sh v1.11 — part 12 of 12

./blog.sh 1.11.1 is out — release on GitHub.

A fix release. Most of it answers five reports filed on GitHub (#70 to #74) by somebody who writes with the engine every day, and the rest came out of the release checks run over it afterwards. Nothing new to learn; a few things now do what you already expected of them.

Keys. A capital letter is the same key as a small one in every screen of ./blog.sh, the archive browser included, so Caps Lock no longer turns a menu deaf (#70). A terminal that sends a letter like "č" in Latin-2 gets "not understood" instead of a crash.

The queue. When you schedule a post, the line under the slot it offers says what Enter accepts: that slot (#74). A scheduled post you open again is asked about as a scheduled one, keep it, publish it now or move it, and one whose time has passed is called overdue (#71).

Read more