Publish for different readers

GraphArch publishes final HTML, CSS, and PDF artifacts directly from the documentation graph. A project can provide an authoritative reference, explanatory companion site, and review document with different arrangements of shared content.

See the renderer catalogue for the implemented renderer modes and their output artifacts.

Publication styles

StyleUseful when readers needOutput
Companion websiteGuides, stories, examples, and topic navigationStatic pages with breadcrumbs, page contents, and previous/next links.
SpecificationA familiar standards document with publication metadata and numbered sectionsStandards-style HTML with a paired PDF download.
Paginated specificationA large reference that is impractical as one HTML documentSmaller linked specification pages and shared navigation/search.
BookshelfA large ontology family organised into declared modulesA catalogue of module books, each with its own specification and PDF.
Independent PDFAn explicitly arranged review or approval documentA PDF and its editable Typst source.
Single-document HTMLA compact document with a contents listOne HTML document and CSS.

The HTML feature guide describes static hosting and navigation. The PDF feature guide describes document presentation.

One content model, independent publications

Each target has its own scope, order, renderer, and output directory. A PDF need not reproduce a website's page boundaries. A companion article need not appear in the specification. Deliberate reuse keeps shared definitions connected to the same source revision while allowing a different reading order.

The specification style supports configurable publisher branding, status, version links, editors, authors, legal notices, references, and appendices. Required-content profiles can block a release until its required sections and publisher-assigned metadata exist. A standards-like appearance does not imply approval by the named authority.

Explore the available layouts

Search documentation

Enter words to search this site.