From 64215d873455967679fdd4bfe940ed23d0850eae Mon Sep 17 00:00:00 2001 From: EuAndreh Date: Thu, 10 Sep 2026 17:49:24 -0300 Subject: Write definition lists the way adoc(5) does The page makes a definition list a term line --- ":: term" at the head of the line, like every other block construct --- and a mid-line "::" ordinary text. These pages were written in the trailing "term::" form, which is AsciiDoc's and which the page replaced to remove a footgun: prose reading "the a :: b thing" parsed as a definition. The rendering does not change, except where it was wrong. The trailing form folded an indented continuation into the term, so a term's bold ran on over its own definition and, in a few pages, the definition's first line came out after its second. Those read correctly now. Co-Authored-By: Claude Opus 5 (1M context) Claude-Session: https://claude.ai/code/session_015bWfjj7PP24iF5MqFHmdeC --- doc/euandre.org.en.0.adoc | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) (limited to 'doc') diff --git a/doc/euandre.org.en.0.adoc b/doc/euandre.org.en.0.adoc index 6d461c4..c13b114 100644 --- a/doc/euandre.org.en.0.adoc +++ b/doc/euandre.org.en.0.adoc @@ -14,21 +14,21 @@ The manual for the repository that builds https://euandre.org. It is a website, not a program: there is nothing here to install on a PATH, and what the pages describe is how the site is written and built. -*euandre.org*(7README):: - What the site is, what builds it, and the licences it carries. +:: *euandre.org*(7README) +What the site is, what builds it, and the licences it carries. -*euandre.org*(7tutorial):: - Adding a page, from the empty file to the built HTML. +:: *euandre.org*(7tutorial) +Adding a page, from the empty file to the built HTML. -*euandre.org*(7recipes):: - The tasks that come up once the shape is familiar: a translation, a - slide deck, a redirect, a deploy. +:: *euandre.org*(7recipes) +The tasks that come up once the shape is familiar: a translation, a +slide deck, a redirect, a deploy. -*euandre.org*(7why):: - Why the site is built this way rather than another. +:: *euandre.org*(7why) +Why the site is built this way rather than another. -*euandre.org*(7CHANGELOG), *euandre.org*(7TODOs):: - What has changed, and what is known to be left. +:: *euandre.org*(7CHANGELOG), *euandre.org*(7TODOs) +What has changed, and what is known to be left. The build rules are not this repository's own. `mkdeps.sh` ends with `mkwb rules`, which writes them into `deps.mk`; what is kept here is -- cgit v1.3