George Lambert
0efe762a23
- Add fonts/READY-PACKAGE.md: exact woff2/ttf names, OFL license steps, pixel-match checklist vs verae-2026-design CERT-01.html/png - Cross-link README, LICENSE-FONTS, fetch-fonts.example.sh status - certificate.html residual points at READY-PACKAGE (ops drop-in) Software path unchanged; go test pdfcert + statuslang PASS. Binaries remain operator deploy-host only (not committed).
162 lines
7.1 KiB
Markdown
162 lines
7.1 KiB
Markdown
# CERT self-host fonts (printit.verae.ai)
|
|
|
|
[](https://github.com/RichardLitt/standard-readme)
|
|
|
|
Drop-in woff2 directory for the CERT-01 web viewer (`../certificate.html`).
|
|
|
|
`certificate.html` probes this folder at load time. If any planned `.woff2`
|
|
validates (woff2 magic `wOF2`), it injects local `@font-face` and **skips**
|
|
the Google Fonts CDN. If none are present, it loads CDN Fraunces + JetBrains
|
|
Mono. Binaries are **not** committed — only `.gitkeep` keeps the path in git.
|
|
Do **not** download or commit proprietary fonts.
|
|
Operators place OFL Fraunces themselves — see [`LICENSE-FONTS.md`](./LICENSE-FONTS.md).
|
|
|
|
## Table of Contents
|
|
|
|
- [Install](#install)
|
|
- [Usage](#usage)
|
|
- [Background](#background)
|
|
- [Planned filenames](#planned-filenames)
|
|
- [READY package](#ready-package)
|
|
- [Fetch scaffold](#fetch-scaffold)
|
|
- [Out of scope](#out-of-scope)
|
|
- [Status](#status)
|
|
- [Contributing](#contributing)
|
|
- [License](#license)
|
|
|
|
## Install
|
|
|
|
Place OFL-licensed files next to this README (no proprietary fonts):
|
|
|
|
```sh
|
|
# From this directory (site/printit.verae.ai/fonts/)
|
|
cp /path/to/fraunces-opsz-wght-700.woff2 .
|
|
cp /path/to/fraunces-opsz-wght-600.woff2 . # optional weight 600
|
|
cp /path/to/jetbrains-mono-500.woff2 . # optional mono
|
|
cp /path/to/OFL.txt . # required beside binaries
|
|
|
|
./fetch-fonts.example.sh --check # exit 0 when required set present
|
|
```
|
|
|
|
Deploy with the static site (`rsync` to `/var/www/printit.verae.ai/` — see
|
|
parent `README.md`). No HTML edit is required: the viewer auto-selects local
|
|
vs CDN.
|
|
|
|
## Usage
|
|
|
|
```sh
|
|
# No woff2 yet → certificate.html uses Google Fonts CDN Fraunces
|
|
open ../certificate.html
|
|
|
|
# After drop-in → local @font-face only (CDN not requested)
|
|
./fetch-fonts.example.sh --check && open ../certificate.html
|
|
# Smoke offline: block fonts.googleapis.com / fonts.gstatic.com;
|
|
# title must still render Fraunces from local woff2 (or Georgia if missing).
|
|
```
|
|
|
|
How drop-in works:
|
|
|
|
1. Obtain **OFL-licensed** Fraunces (and optional JetBrains Mono) as woff2
|
|
from upstream or a subsetted build (title glyphs only is enough for CERT).
|
|
2. Name files exactly as in [Planned filenames](#planned-filenames).
|
|
3. Commit `OFL.txt` / `LICENSE` next to the binaries (keep copyright notices).
|
|
4. Open `certificate.html` — head script HEADs each candidate, checks woff2
|
|
magic (avoids Caddy `try_files` HTML false-positives), injects
|
|
`@font-face` for hits, otherwise appends the CDN `<link>`.
|
|
5. Keep the Georgia / Times New Roman / serif stack as final fallback in CSS.
|
|
|
|
Do **not** uncomment network fetches in `fetch-fonts.example.sh` until license
|
|
review. This tree must not ship proprietary font files.
|
|
|
|
## Background
|
|
|
|
| Surface | Fonts today | Offline fallback |
|
|
|---------|-------------|------------------|
|
|
| `certificate.html` title | Local `fonts/*.woff2` if present, else **Fraunces** CDN | Georgia / Times New Roman / serif |
|
|
| Mono digests | Local mono woff2 if present, else **JetBrains Mono** CDN | ui-monospace / SF Mono / Menlo |
|
|
| UI kit (`verae-ui-kit.css`) | Inter + Material Symbols Rounded CDN | system stacks in `brand/tokens.css` |
|
|
| Issued PDF (`internal/pdfcert`) | Core Times/Helvetica; **`EmbedBrandFonts` default false** (env `VERAE_EMBED_BRAND_FONTS`); opt-in gofpdf `AddUTF8FontFromBytes` for `.ttf`/`.otf` under `VERAE_BRAND_FONTS_DIR` or this dir | Times on fail / no face (logged no-op) |
|
|
|
|
Design source of truth: `verae-2026-design/ui-designs/src/html/CERT-01.html`
|
|
(tokens `--font-serif: 'Fraunces'`; design-kit `src/fonts/` ships Cantarell +
|
|
Material Symbols TTF only — **no Fraunces binary in-repo yet**).
|
|
|
|
**READY package claims:** exact filenames, license steps, pixel checklist.
|
|
**Not claimed in git:** production woff2/ttf binaries or operator pixel sign-off.
|
|
|
|
## Planned filenames
|
|
|
|
```
|
|
fonts/
|
|
README.md (this file)
|
|
.gitkeep
|
|
fetch-fonts.example.sh # curl placeholders; no download until uncommented
|
|
fraunces-opsz-wght-600.woff2 # variable or static; opsz + weight 600
|
|
fraunces-opsz-wght-700.woff2 # weight 700 (title)
|
|
jetbrains-mono-500.woff2 # optional; digests already have mono stack
|
|
OFL.txt / LICENSE # required license text beside binaries
|
|
```
|
|
|
|
Exact names must stay stable once wired so deploys and the head probe match.
|
|
|
|
## READY package
|
|
|
|
Full operator contract (exact names, license steps, CERT-01 pixel-match
|
|
checklist): [`READY-PACKAGE.md`](./READY-PACKAGE.md).
|
|
|
|
Design paths for side-by-side:
|
|
|
|
- `verae-2026-design/ui-designs/src/html/CERT-01.html`
|
|
- `verae-2026-design/ui-designs/pngs/CERT-01.png`
|
|
- `verae-2026-design/ui-designs/pngs-annotated/CERT-01.png`
|
|
|
|
## Fetch scaffold
|
|
|
|
[`fetch-fonts.example.sh`](./fetch-fonts.example.sh) — **example only**.
|
|
Comment-only upstream URLs (google/fonts OFL trees). Does not curl until an
|
|
operator uncomments a pinned-commit block after license review.
|
|
|
|
```sh
|
|
./fetch-fonts.example.sh # prints instructions; no network
|
|
./fetch-fonts.example.sh --check # exit 1 until woff2 + OFL.txt present
|
|
```
|
|
|
|
## Out of scope
|
|
|
|
| Item | Owner / later |
|
|
|------|----------------|
|
|
| PDF CERT Fraunces embed | **EmbedBrandFonts default false**; when on, gofpdf registers first `.ttf`/`.otf` in `VERAE_BRAND_FONTS_DIR` or this dir (fail → log + Times). Node `build.mjs` stays core faces |
|
|
| Inter / Material Symbols self-host for whole site | optional; CERT title is OPEN-ISSUES #7 residual |
|
|
| Cantarell from design-kit TTFs | GNOME mock only; not required for CERT-01 web title |
|
|
| Pixel-perfect CERT-01.html match | Operator sign-off via [READY-PACKAGE.md](./READY-PACKAGE.md) checklist |
|
|
|
|
## Status
|
|
|
|
| Step | State |
|
|
|------|-------|
|
|
| Placeholder dir + this plan | **Done** |
|
|
| `fetch-fonts.example.sh` placeholders | **Done** — no binaries fetched by default |
|
|
| Web cert spacing toward CERT-01 | **Done** — CERT-01-ish geometry (see READY checklist) |
|
|
| Local-first `@font-face` else CDN | **Done** — `certificate.html` probes `fonts/*.woff2` |
|
|
| Drop-in docs (this README) | **Done** |
|
|
| READY package (names + license + pixel checklist) | **Done** — [`READY-PACKAGE.md`](./READY-PACKAGE.md) |
|
|
| woff2 binaries + OFL in git | **Operator** — not committed; deploy-host drop-in only |
|
|
| `EmbedBrandFonts` default false | **Done** — opt-in env/option |
|
|
| PDF gofpdf ttf/otf register attempt | **Done** — opt-in; no-op + log when missing/unsupported |
|
|
| Operator pixel sign-off vs CERT-01.png | **Checklist ready** — sign-off on deploy host |
|
|
|
|
## Contributing
|
|
|
|
Questions: Verae eng / printit site owners. PRs that add **OFL** woff2 +
|
|
`OFL.txt` with stable planned names are welcome. PRs that vendor proprietary
|
|
fonts or strip copyright notices will be rejected. Do not enable the example
|
|
fetch script in CI.
|
|
|
|
## License
|
|
|
|
Documentation in this directory: UNLICENSED © Verae LLC.
|
|
|
|
Font binaries are **not** shipped. Operators place OFL Fraunces themselves —
|
|
see [`LICENSE-FONTS.md`](./LICENSE-FONTS.md). When added, binaries remain under
|
|
upstream licenses (typically SIL OFL 1.1). Ship upstream `OFL.txt` beside any
|
|
binary. This directory does not re-license font files.
|