diff options
| author | EuAndreh <eu@euandre.org> | 2026-09-10 17:49:24 -0300 |
|---|---|---|
| committer | EuAndreh <eu@euandre.org> | 2026-09-10 17:49:24 -0300 |
| commit | 64215d873455967679fdd4bfe940ed23d0850eae (patch) | |
| tree | 2359039e2b73c5d51fa75265517609dfc830050c /doc | |
| parent | Carry the pages every repository carries (diff) | |
| download | euandre.org-64215d873455967679fdd4bfe940ed23d0850eae.tar.gz euandre.org-64215d873455967679fdd4bfe940ed23d0850eae.tar.xz | |
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) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015bWfjj7PP24iF5MqFHmdeC
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/euandre.org.en.0.adoc | 22 |
1 files changed, 11 insertions, 11 deletions
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 |