= euandre.org(7tutorial) == NAME euandre.org - a personal website in six languages, built from asciidoc == DESCRIPTION Writing one article, from nothing to a page on disk. It assumes the tools are installed and `make` runs; everything else is here. == A first article Articles live under a collection, dated: .... src/content/en/blog/2026/09/10/a-first-article.adoc .... The path is the URL, and the three levels below the collection are the date. Nothing registers the file anywhere --- `mkdeps.sh` finds it with `find`, so creating it is the whole of adding it. The file opens with its title and then says what it says: [source,asciidoc] .... = A first article The first paragraph is the summary the indexes and the feed quote, so write it as one. == A section Prose, `code`, and the rest of *adocg*(7). .... == Building it The rules are generated, so regenerate them, then build: .... $ sh mkdeps.sh > deps.mk $ make .... The page lands beside its source as `src/content/en/blog/2026/09/10/a-first-article.html`, and the collection index, the feed and the sitemap pick it up because the rules that build them were regenerated too. Read it before publishing it: .... $ make install $ make run .... == Where the other languages come from They are not written; they are translated. The English file is the master, and `po/` holds one catalogue per language: .... $ make i18n .... writes the translated masters under `src/content//`, which the next `sh mkdeps.sh > deps.mk` then finds like any other page. A change to the English source propagates rather than drifting, which is the point of keeping them as catalogues rather than as copies. == SEE ALSO *euandre.org*(7recipes), *euandre.org*(0), *mkwbg*(1), *adocg*(7), *po4a*(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].