Chapel Technology website

The public site combines two modern static build steps into one GitHub Pages artifact:

• Astro builds the main site into dist/.
• asgard/upstream/ is an exact copy of the tracked OSKT repository.
• Asciidoctor renders the original .doc and .toc sources into dist/asgard/.
• mandoc renders every original man page as semantic HTML and PDF at the legacy filenames.
• Astro wraps the HTML fragments in the preserved OSKT layout; a structured rehype pass links only manuals present in OSKT and leaves other manual references as plain text.
• The original OSKT CSS, JavaScript, image, and release archives are copied unchanged. asgard/mandoc-modern.css adds responsive, troff-inspired rules for mandoc's semantic HTML classes.
• The production checks reject broken/empty links and mdoc errors that risk information loss; historical style-level lint remains available for gradual source cleanup.

Local development

Install Node.js 22 or newer, npm, and mandoc, then run:

npm install
npm run build
npm run check
npm run preview

For work on only the Astro landing page, use npm run dev.

The production site is configured for https://chapeltech.uk/; the Antora documentation is published beneath /asgard/, and package repository setup instructions are published at https://chapeltech.uk/packages.html.