Iosevka 字体定制全流程

# ==================== 1. 终端字体（Ghostty）：term 严格等宽 · Oblique 几何斜 ====================
[buildPlans.IosevkaTerminal]
family = "Iosevka Terminal"
spacing = "term"                  # 任何符号都压进单倍宽度，杜绝光标漂移
serifs = "sans"                   # 无衬线，小字号不粘连
noCvSs = false
exportGlyphNames = true           # 保留字形名：Kitty 连字依赖

# 不让终端字体抢占 Emoji，交给系统彩色 Emoji 字体渲染
[buildPlans.IosevkaTerminal.subset.exclude]
textFile = "private-emoji-exclude.txt"

# ---- 字形定制：消灭盲区字符 ----
[buildPlans.IosevkaTerminal.variants.design]
zero = "dotted"                   # 0 带点，区分大写 O
a = "single-storey-serifless"     # 单层闭环 a

# ---- 字重：只留 400/700 两个系统锚点 ----
[buildPlans.IosevkaTerminal.weights.Regular]
shape = 400
menu = 400
css = 400

[buildPlans.IosevkaTerminal.weights.Bold]
shape = 700
menu = 700
css = 700

# ---- 字宽：500，中英文 2:1 对齐的唯一正解 ----
[buildPlans.IosevkaTerminal.widths.Normal]
shape = 500
menu = 5
css = "normal"

# ---- 斜体：终端小字号下几何斜不粘连 ----
[buildPlans.IosevkaTerminal.slopes.Upright]
angle = 0
shape = "upright"
menu = "upright"
css = "normal"

[buildPlans.IosevkaTerminal.slopes.Oblique]
angle = 9.4
shape = "oblique"
menu = "oblique"
css = "oblique"

# ==================== 2. 编辑器字体（VS Code）：normal 等宽 · Italic 手写斜 · 无连字 ====================
[buildPlans.IosevkaCode]
family = "Iosevka Code"
spacing = "normal"                # 全角符号允许占 2 格，语法高亮更自然
serifs = "sans"
noCvSs = false
exportGlyphNames = true
noLigation = true                 # 关闭连字：`==` 就是 `==`，排错一眼数清

# 与终端、网页版本共用同一份 Emoji 排除列表
[buildPlans.IosevkaCode.subset.exclude]
textFile = "private-emoji-exclude.txt"

# ---- 字形定制：消灭盲区字符 ----
[buildPlans.IosevkaCode.variants.design]
zero = "dotted"                   # 0 带点，区分大写 O
a = "single-storey-serifless"     # 单层闭环 a

# ---- 字重：只留 400/700 两个系统锚点 ----
[buildPlans.IosevkaCode.weights.Regular]
shape = 400
menu = 400
css = 400

[buildPlans.IosevkaCode.weights.Bold]
shape = 700
menu = 700
css = 700

# ---- 字宽：500，中英文 2:1 对齐的唯一正解 ----
[buildPlans.IosevkaCode.widths.Normal]
shape = 500
menu = 5
css = "normal"

# ---- 斜体：编辑器大字号下手写斜优雅 ----
[buildPlans.IosevkaCode.slopes.Upright]
angle = 0
shape = "upright"
menu = "upright"
css = "normal"

[buildPlans.IosevkaCode.slopes.Italic]
angle = 9.4
shape = "italic"
menu = "italic"
css = "italic"

# ==================== 3. 网页正文（博客文章）：quasi-proportional 比例字体 ====================
[buildPlans.IosevkaWeb]
family = "Iosevka Web"
spacing = "quasi-proportional"    # 打破等宽，m 宽 i 窄，读起来像书
serifs = "sans"
noCvSs = true                     # 导出全关，把 woff2 体积压到几十 KB
exportGlyphNames = false

# 不让网页字体抢占 Emoji，交给系统彩色 Emoji 字体渲染
[buildPlans.IosevkaWeb.subset.exclude]
textFile = "private-emoji-exclude.txt"

# ---- 字形定制：消灭盲区字符 ----
[buildPlans.IosevkaWeb.variants.design]
zero = "dotted"                   # 0 带点，区分大写 O
a = "single-storey-serifless"     # 单层闭环 a

# ---- 字重：网页正文只留常规体 ----
[buildPlans.IosevkaWeb.weights.Regular]
shape = 400
menu = 400
css = 400

# ---- 字宽：500 ----
[buildPlans.IosevkaWeb.widths.Normal]
shape = 500
menu = 5
css = "normal"

# ---- 斜体：只留直立 ----
[buildPlans.IosevkaWeb.slopes.Upright]
angle = 0
shape = "upright"
menu = "upright"
css = "normal"

# ==================== 4. 网页代码块（博客高亮）：等宽 · 默认连字 ====================
[buildPlans.IosevkaWebCode]
family = "Iosevka Web Code"
spacing = "normal"                # 代码块必须是老实等宽
serifs = "sans"
noCvSs = true
exportGlyphNames = false          # 网页端不需要 Kitty 字形名
# 不写 ligations 块 = 默认开启全套连字（网页展示代码连字是加分项）

# 与正文共用同一份 Emoji 排除列表
[buildPlans.IosevkaWebCode.subset.exclude]
textFile = "private-emoji-exclude.txt"

# ---- 字形定制：消灭盲区字符 ----
[buildPlans.IosevkaWebCode.variants.design]
zero = "dotted"                   # 0 带点，区分大写 O
a = "single-storey-serifless"     # 单层闭环 a

# ---- 字重：常规 + 粗体，供关键字高亮 ----
[buildPlans.IosevkaWebCode.weights.Regular]
shape = 400
menu = 400
css = 400

[buildPlans.IosevkaWebCode.weights.Bold]
shape = 700
menu = 700
css = 700

# ---- 字宽：500 ----
[buildPlans.IosevkaWebCode.widths.Normal]
shape = 500
menu = 5
css = "normal"

# ---- 斜体：直立 + 手写斜，供代码注释高亮 ----
[buildPlans.IosevkaWebCode.slopes.Upright]
angle = 0
shape = "upright"
menu = "upright"
css = "normal"

[buildPlans.IosevkaWebCode.slopes.Italic]
angle = 9.4
shape = "italic"
menu = "italic"
css = "italic"

# 所有 build plan 都引用同一份列表；TOML 本身不能把一个 subset 表定义为全局别名。
[buildPlans.IosevkaTerminal.subset.exclude]
textFile = "private-emoji-exclude.txt"

font-family = Iosevka Terminal
font-family = Apple Color Emoji
font-family = MonaspiceRn Nerd Font Mono
font-family = Maple Mono NF CN

font-family: "Iosevka Web", "Apple Color Emoji", "InputMono", monospace;
font-family: "Iosevka Web Code", "Apple Color Emoji", "Noto Sans SC", monospace;

# 1. 获取源码（可选用国内镜像，全套 Releases 体积巨大）
git clone --depth 1 https://github.com/be5invis/Iosevka.git
cd Iosevka

# 2. 放入定制配置（仓库根目录）
#    把上面这份 private-build-plans.toml 放进来

# 3. 安装依赖（首次必须，否则报 verda: command not found）
bun install

# 4. 构建
bun run build -- ttf::IosevkaTerminal
bun run build -- ttf::IosevkaCode
bun run build -- contents::IosevkaWeb
bun run build -- contents::IosevkaWebCode

iosevka-custom/
├── IosevkaTerminal/TTF/          # → 安装到 ~/Library/Fonts/
│   ├── IosevkaTerminal-Regular.ttf
│   ├── IosevkaTerminal-Bold.ttf
│   ├── IosevkaTerminal-Oblique.ttf
│   └── IosevkaTerminal-BoldOblique.ttf
├── IosevkaCode/TTF/              # → 安装到 ~/Library/Fonts/
│   ├── IosevkaCode-Regular.ttf
│   ├── IosevkaCode-Bold.ttf
│   ├── IosevkaCode-Italic.ttf
│   └── IosevkaCode-BoldItalic.ttf
├── IosevkaWeb/                   # → 部署到博客 /fonts/
│   ├── IosevkaWeb.css
│   └── WOFF2/
│       └── IosevkaWeb-Regular.woff2
└── IosevkaWebCode/               # → 部署到博客 /fonts/
    ├── IosevkaWebCode.css
    └── WOFF2/
        ├── IosevkaWebCode-Regular.woff2
        ├── IosevkaWebCode-Bold.woff2
        ├── IosevkaWebCode-Italic.woff2
        └── IosevkaWebCode-BoldItalic.woff2

# brew install --cask font-maple-mono-nf-cn
# brew install --cask font-monaspice-nerd-font
font-family = Iosevka Terminal
font-family = Apple Color Emoji
font-family = MonaspiceRn Nerd Font Mono
font-family = Maple Mono NF CN
font-size = 22

{
  "editor.fontLigatures": true,
  "editor.fontFamily": "Iosevka Code, 'Input Mono', Menlo, Monaco, 'Courier New', monospace",
  "editor.fontSize": 15,
  "editor.lineHeight": 1.7
}

{
  "editor.tokenColorCustomizations": {
    "textMateRules": [
      {
        "scope": ["comment", "punctuation.definition.comment"],
        "settings": { "fontStyle": "italic" }
      }
    ]
  }
}

# test.sh —— 4 行同时触发 正常/粗/斜/粗斜，检查 2:1 对齐与字形特征
echo -e "正常体: a g i l o 0 O | const val = 0; 中英文 2:1 黄金对齐" && \
echo -e "\033[1m纯粗体: a g i l o 0 O | const val = 0; 汉字加粗清晰测试\033[0m" && \
echo -e "\033[3m纯斜体: a g i l o 0 O | const val = 0; 手写弧度跨族调用\033[0m" && \
echo -e "\033[1;3m粗斜体: a g i l o 0 O | const val = 0; 终极复合无缝渲染\033[0m"