# 品牌字体（不入库，构建前拉取）

iOS App 的字体栈对齐 web（见 `web/src/styles/fonts.css`）：

| 角色 | 字体 | 落地 | 来源 |
|---|---|---|---|
| Sans（正文 / 界面） | **Orbit Gothic CJK SC**（Regular 400 + SemiBold 600） | `Sources/Fonts/OrbitGothicCJKsc-*.woff2` | 私有 CDN `orbit-gothic.cdn.commilitia.net` |
| Mono（等宽） | **Maple Mono**（Regular） | `Sources/Fonts/MapleMono-Regular.woff2` | 私有 CDN `maple-mono.cdn.commilitia.net`（OFL） |
| 字标（Wordmark） | **Fredoka SemiBold** | `Shared/Fonts/Fredoka-SemiBold.ttf` | Google Fonts 变量字体实例化（OFL） |

## 为什么不提交进仓库

- **Orbit Gothic 是专有 / 定制字体**——公开仓库（见根 README 的双 remote 发布）不应分发它。web 端同样不入库、
  改从私有 CDN 拉。
- Maple Mono / Fredoka 虽开源（OFL），也统一走拉取，保持仓库精简（Orbit 两变体 woff2 合计 ~20MB）。

字体文件经 `.gitignore` 排除（`Sources/Fonts/*.woff2,*.ttf`、`Shared/Fonts/*`）；本 README 入库作说明。

## 如何备齐

```sh
just ios-fonts
```

幂等（已存在则跳过）。`just ios-device` / `just ios-sim-build` 构建前已自动 chain 本步，正常无需手动跑。

**前置**：`curl`；造 Fredoka 静态实例需 `python3` + `fonttools`（`python3 -m pip install --user fonttools`）。
CDN 不可达时构建会失败——离线则手动把上述文件放到对应目录即可。

## 接入方式（代码）

字体以 **woff2** 内嵌（体积约 TTF 的 1/3；iOS 13+ Core Text 原生支持 woff/woff2）。`UIAppFonts`（Info.plist）
历史上只认 ttf/otf，故 woff2 走**运行期注册** `CTFontManagerRegisterFontsForURL`——见 `Sources/BrandFonts.swift`
的 `BrandFonts.register()`（`AppDelegate` 启动调用）。Fredoka 字标是 ttf，经 `UIAppFonts` 注册。

仅**主 app** 接入 Orbit / Maple（CJK 字体大，不进 Share / 控件扩展——它们保持系统字 + 仅 Fredoka 字标）。
生僻字超出 Orbit Gothic 字汇时由 iOS 字体级联自动回退系统苹方，不出豆腐块。

字体助手见 `Sources/BrandFonts.swift`：`Font.oBody/.oHeadline/...`（Orbit，对位 SF 语义样式）、`Font.maple(...)`
（Maple Mono）；导航 / 标签栏标题经 UIKit appearance 代理换 Orbit。