2025-07-24 –, Main Room 2
Documenter.jl is the primary documentation engine for Julia, and powers backends ranging from native HTML and LaTeX to the spiffy DocumenterVitepress.jl. In this talk, we'll explore the structure of a Documenter.jl "document", and how to modify it and hook into Documenter.jl to your own (evil) ends!
We'll explore how Documenter's abstractions are structured, the build and extension pipelines, as well as how to define and implement a custom Documenter block.
Packages like DocumenterCitations, DocumenterMermaid, and others do excellent work. But how do they actually work, and how can you do something similar for your own work?
Documenter has some nice abstractions that allow the user to hook in to any stage of the pipeline, and this talk will show you how to do it! Starting from the structure of the document, pages, and the Markdown syntax tree representation, we'll hook in to Documenter build stages, mess with the contents of the document, and see how to render our custom blocks in each backend!
JuliaGeo collaborator and author of GeoMakie.jl, and contributor to DocumenterVitepress.jl!