Build Pipeline

This is the build-time path through the reference. It pairs with Architecture at a Glance, which explains the broad build/runtime split, and Page Lifecycle, which follows a single page through the whole system.

Reading Path

Step	Page	Why it matters
1	Page Lifecycle	End-to-end walkthrough from Markdown source to browser runtime
2	sync.sh	Master orchestration script for build, generation, validation, and deployment
3	hakyll.hs	Hakyll entry point and Pandoc transform pipeline
4	bash.sh	Shared shell helpers used by the build scripts
5	test.hs	Validation and regression checks

Generated Content

Area	Start here
Directory pages	generateDirectory.hs
Link bibliographies	generateLinkBibliography.hs
Backlinks	generateBacklinks.hs
Similar links	generateSimilarLinks.hs

Adjacent Systems

• Templates define the HTML structure that Hakyll fills.
• PHP asset pipeline builds CSS, JavaScript, icons, and includes.
• Nginx configuration documents the production server layer.
• Annotation and Metadata covers the metadata inputs consumed during the build.
• Popup System covers the runtime layer that uses the generated annotation and transclusion data.