From 9ec6794d8f04b7970e1401cae1d0d20321de3204 Mon Sep 17 00:00:00 2001 From: EuAndreh Date: Thu, 10 Sep 2026 12:00:04 -0300 Subject: Carry the pages every repository carries The eight English section pages were missing, and with them the root CHANGELOG.adoc and TODOs.adoc: what changed between two releases and what is known to be left are not things a reader can work out from the tree. 7README, 7CHANGELOG and 7TODOs are symlinks to the root documents, as they are everywhere else. 0 links the rest, 7tutorial writes one page start to finish, 7recipes has the tasks that come after that, and 7why says why the site is built this way. 3 is a reference page for a library, and a website has none; it says so, and exists because a reader who knows where to look in one repository should know where to look in all of them. README.adoc gains the manpage title and NAME section the 7README symlink needs to render, its prose unchanged. Co-Authored-By: Claude Opus 5 (1M context) Claude-Session: https://claude.ai/code/session_01KxLpaNQThKfMG3ecCJptP9 --- doc/euandre.org.en.0.adoc | 58 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 58 insertions(+) create mode 100644 doc/euandre.org.en.0.adoc (limited to 'doc/euandre.org.en.0.adoc') diff --git a/doc/euandre.org.en.0.adoc b/doc/euandre.org.en.0.adoc new file mode 100644 index 0000000..6d461c4 --- /dev/null +++ b/doc/euandre.org.en.0.adoc @@ -0,0 +1,58 @@ += euandre.org(0) + + + +== NAME + +euandre.org - a personal website in six languages, built from asciidoc + + + +== DESCRIPTION + +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*(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*(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. + +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 +only what is this site's --- its name, its languages, its port. For +the rules themselves see *mkwb*(1). + + + +== SEE ALSO + +*mkwb*(1), *adocg*(1), *po4a*(1), *eslaides*(1) + + + +== AUTHORS + +mailto:eu@euandre.org[EuAndreh] and contributors. + + + +== BUGS + +* Report bugs to the mailto:~euandreh/public-inbox@lists.sr.ht[mailing list]. + Use the subject "[euandre.org] BUG or TASK: ". +* Browse bugs https://euandre.org/git/euandre.org/TODOs.html[online]. +* https://euandre.org/git/euandre.org/[Homepage]. +* https://lists.sr.ht/~euandreh/public-inbox?search=%5Beuandre%2Eorg%5D[Comments and discussions]. -- cgit v1.3