A Khosra Demo

Readings from a rain gauge on a roof

Menu

First Light

Contents

This post exists in two languages, so the footer’s language links go somewhere and hreflang has something to point at. Its Bengali twin is index.bn.md beside this file.

It also owns a picture, which only a directory publication can do:

First Light, Grey-GreenDescribed by its sidecar, not by the line that shows it — howDrawn, not photographedFUJIFILM X-T4 · XF35mmF1.4 R · f/2.8 · 1/250 · ISO 400

Its line says {bleed full-frame}: the width of the window, as the bleed further down is, but whole — a full frame is a print of the whole negative, where a bleed is cut to a band.

The picture above is served from this publication’s own directory, and the srcset on it names generated widths. It carries no alt or caption on the line itself: both come from _cover.jpg.yaml beside it, along with the film and developer, which reach the theme as metadata the engine keeps no vocabulary for (ADR-0253).

The grey line under it is the exposure placard, from that sidecar’s exif: block — normally written by khosra add, which puts it there after taking it out of the picture (ADR-0259). It repeats on this page, and that is this page’s fault rather than the rule’s: one drawn file stands in for five photographs here, so five layouts show one exposure. An essay of twelve frames has twelve different ones, which is exactly why an exposure is printed where film — the same on all twelve — is not.

That one carries plain as well, which leaves its furniture out: the paragraph beside it already says what a runaround is, so a caption repeating it would be the third time. Two words share one attribute line — one places the picture, the other switches its caption off. A picture used twice on a page usually wants its caption once.

A runaround needs text to run around, which is what this paragraph is for: the picture above is floated left by an attribute line and these words flow past it. A heading would not — every heading clears a float, deliberately, because a heading beside a picture reads as its caption. So a runaround wants a paragraph or two after it, and the demonstration of that is this paragraph existing at all. Below 30rem the float is dropped and the picture becomes full-measure, since there is no room beside the text on a phone.

The width ladder

A picture takes one rung of it, written as an attribute line under the image. The words are a printer’s: a plate is an illustration printed wider than the text block, a bleed runs past the trim edge, a marginal figure sits in the margin, and a runaround is text flowing around one (khosra ADR-0253, khata’s ladder). No word at all is the measure, which is the default because it is what most pictures want.

A plate reaches exactly as far as a marginal note does on the other side, which is what makes the two read as one system rather than two guesses. Its caption stays on the measure: a caption set to the plate’s width reads as a second column of prose.

First Light, Grey-GreenA plate, with its caption on the measureDrawn, not photographedFUJIFILM X-T4 · XF35mmF1.4 R · f/2.8 · 1/250 · ISO 400

A marginal figure lines up with ::aside{.side}, sharing the rung and the offset — so a small picture and a side note sit on the same line rather than nearly on it. Below 55rem there is no margin to sit in and it returns to the flow.

First Light, Grey-GreenA marginal figureDrawn, not photographedFUJIFILM X-T4 · XF35mmF1.4 R · f/2.8 · 1/250 · ISO 400

A picture with no caption and no credit is not wrapped in a <figure> at all — it is a bare <img>, and the rung lands on the image itself. That is half the ladder’s markup and every picture on this site had a caption, so it was going unshown until an audit of the stylesheet noticed nothing on any page matched a bare image’s runaround. The gauge below is that case, and it comes from the shared pool rather than this publication’s own directory.

Two things are true of it at once: the placement is on the <img> because there is no caption to wrap, and the reference is /assets/… because the picture belongs to no single publication (ADR-0151). Neither changes the other.

Below is a bleed, which ignores the page’s margins entirely. It is the one rung that costs something to use badly: a picture with no detail at the edges is the only kind that survives being cropped to a band.

First Light, Grey-GreenA bleed, cropped to a bandDrawn, not photographedFUJIFILM X-T4 · XF35mmF1.4 R · f/2.8 · 1/250 · ISO 400
First Light, Grey-GreenThe live area: a bleed held off the window’s edgesDrawn, not photographedFUJIFILM X-T4 · XF35mmF1.4 R · f/2.8 · 1/250 · ISO 400

{live-area} is the printer’s other wide rung: everything inside the trim’s safety margin. The same band as a bleed, held off the window’s edges by a slight margin that grows with the window — for a picture that wants the width but not the very edge.

An attribute line, {runaround-left}, puts the picture beside this paragraph and lets the text wrap around it, which is where a photograph in an essay usually wants to be. The word is the author’s and the theme’s: the engine hands it to the picture’s fragment as a switch and holds no list of placements, so the six the theme names are the ones it answers and anything else is a picture in the flow. A class on the same line, {.mine}, is yours alone. Under 30rem there is no room beside the text, so the float is dropped and the picture is full width — a decision the stylesheet makes, not the engine.

The paragraph after a float has to clear it or the next heading reads as a caption, which is why the reference theme clears headings and rules. That is layout knowledge, and it lives with the layout.

Relative links are written the way the files sit on disk, so they resolve in an editor preview and on the site alike — and they survive a slug rename, because they go through the key rather than the address (ADR-0087). This links a sibling post, a piece in another section, and the renamed one, whose address is not its filename.

Material

1 fileThe whole folder

Choose a file to see it here.

khosra · khata f417e573 · content 7c489ae1 · 228 publications, 4256671 bytes · built in 1.469531857s