Expand description
Turning a parsed folio into a self-contained HTML document.
Structs§
- Colophon
- The generation metadata recorded in every folio’s plaque.
- Labour
- What a render cost: how long the scribe took, and how large the folio came
out. Neither can be known while the markup is being written, so the plaque
carries a placeholder for each and
inscribefills them in afterwards. - Scribe
- Renders folios, carrying the decisions a render depends on: how markdown becomes HTML, how code gets highlighted, which zone timestamps read in, which cut of the embedded faces to carry, and how the folio will reach its reader.
Enums§
- Delivery
- How a folio reaches its reader, which decides whether it can gain a message
under them.
servere-reads the session and re-renders on every load, so a served folio grows as the session is written; a written one is a fixed artifact, and the file it was rendered from could be a year old. - Fonts
- Which cut of the embedded faces a folio should carry.
Constants§
- DROPPED
- Codepoints an embedded face carries whole but not cut, as sorted,
disjoint, inclusive ranges. Generated by
build.rsfromsrc/fonts/cut/dropped.txt.
Functions§
- beyond_
cut - The characters in
textthat an embedded face carries whole but not cut, tallied by how often each occurs. - elapsed
- A duration in the coarsest unit that still says something: whole milliseconds under a second, then seconds to one decimal place.
- inscribe
- Fills a finished folio’s own cost into its plaque.
- size
- A byte count as a size a reader can hold in mind, in the decimal units file sizes are quoted in.