facett-manual/embedded/page-03.svg
<svg xmlns="http://www.w3.org/2000/svg" width="595" height="842" viewBox="0 0 595 842">
<rect x="0" y="0" width="595" height="842" fill="#ffffff"/>
<rect x="64" y="70" width="467" height="3" fill="#2f6f4f"/>
<text x="64" y="122" font-family="DejaVu Sans, sans-serif" font-size="26" font-weight="bold" fill="#1a1a1a">Why two variants</text>
<text x="64" y="186" font-family="DejaVu Sans, sans-serif" font-size="20" font-weight="bold" fill="#2f6f4f">The problem</text>
<text x="64" y="218" font-family="DejaVu Sans, sans-serif" font-size="14" fill="#222222">facett had two separate documentation paths: a Typst-authored SVG book</text>
<text x="64" y="240" font-family="DejaVu Sans, sans-serif" font-size="14" fill="#222222">rendered by resvg, and a continuous Markdown viewer. Users had to pick</text>
<text x="64" y="262" font-family="DejaVu Sans, sans-serif" font-size="14" fill="#222222">the crate up front, and neither embedded its own content.</text>
<text x="64" y="320" font-family="DejaVu Sans, sans-serif" font-size="20" font-weight="bold" fill="#2f6f4f">The decision</text>
<text x="64" y="352" font-family="DejaVu Sans, sans-serif" font-size="14" fill="#222222">Merge them. One Manual pane owns both an embedded typeset SVG book and</text>
<text x="64" y="374" font-family="DejaVu Sans, sans-serif" font-size="14" fill="#222222">an embedded set of Markdown sources. A variant enum selects which one</text>
<text x="64" y="396" font-family="DejaVu Sans, sans-serif" font-size="14" fill="#222222">renders; the default is Typeset (SVG), and a header toggle switches to</text>
<text x="64" y="418" font-family="DejaVu Sans, sans-serif" font-size="14" fill="#222222">Markdown. The Typeset variant delegates to the facett-docview engine.</text>
<text x="64" y="476" font-family="DejaVu Sans, sans-serif" font-size="20" font-weight="bold" fill="#2f6f4f">Why embed</text>
<text x="64" y="508" font-family="DejaVu Sans, sans-serif" font-size="14" fill="#222222">Embedding compiles the manual into the binary. There is no runtime disk</text>
<text x="64" y="530" font-family="DejaVu Sans, sans-serif" font-size="14" fill="#222222">dependency, so the manual ships regardless of docview and works on an</text>
<text x="64" y="552" font-family="DejaVu Sans, sans-serif" font-size="14" fill="#222222">airgapped machine with zero system fonts.</text>
<rect x="64" y="792" width="467" height="1" fill="#cccccc"/>
<text x="64" y="812" font-family="DejaVu Sans, sans-serif" font-size="11" fill="#888888">The Facett Manual</text>
<text x="531" y="812" text-anchor="end" font-family="DejaVu Sans, sans-serif" font-size="11" fill="#888888">Page 3</text>
</svg>