# 文风字体包

> 适合谁看：想把字体文件放在自己站点上、不从文风远程加载的站长。

把文风已经准备好的字体包 zip 装到本站，由本站托管。启用后可在全站样式与字体库里选用。集合名是「文风字体」。

切片包 / **即用字库**请到文风领取（开源目录、字体页，或 [wpcy.com/fonts](https://wpcy.com/fonts) 资料口），不要把 CDN 分片当自托管源。主题里整夹引入 `fonts.css` 的做法见文风《用法》；本页只讲插件「字体包」装到本站。

## 怎么装

1. 打开 **设置 → 文派字库 → 字体包**。
2. 拖入（或选择）含样式与 woff2 的 zip。
3. 安装后按需 **启用**。未启用的包不会进前台。

装不上时：换一份含可用样式（如 `result.css` / `local.css`）和 woff2 的 zip 再试。

文件落在：

```
wp-content/uploads/wpfonts/packages/
```

## 即用字库 zip 怎么认（简要）

文风对外主包约定名为 **`wenfeng-{短码}.zip`**（短码小写，与目录 / CDN 一致）。解压根目录同名；内含 `meta.json`、`fonts.css`（或 `result.css`）与 woff2，可直接拖进本插件。

部分款另有可选次包 **`wenfeng-{短码}-full.zip`**（完整字库档；与主包可并存，族名为 `wenfeng-{短码}-full`）。主包已是全量时通常不再提供次包。

领取与命名细节以文风发盘说明 / [wpcy.com/fonts](https://wpcy.com/fonts) 为准；本页不展开内部清单。

## 样张：装包页 vs 字体库（rc.14–rc.17）

| 位置 | 用哪张图 | 说明 |
|---|---|---|
| **字体包**页卡片 | **card** 长条（约 1200×280） | 自 **rc.16**；有 CDN 图时不再叠活字 |
| **字体库**列表 | **preview**（约 720×400） | 字重行样张 |
| 装包页「字形预览」 | **fontPreview** 长样（兰亭起句一类） | 自 **rc.17** 插件已接；CDN 随发盘上线。缺图时回退为文字预览，属预期 |

样张通常来自文风 CDN（`preview.webp` / `card.webp` / `fontPreview.webp` 等）。个别历史包 id 与 CDN 目录短码不一致时，自 **rc.15** 起插件会做路径别名，**不必改你已装的包 id**。

## 预览（rc.11 起，rc.16–rc.17 分流）

字体包页会按该包样式里的 `font-family` 做样本；有 CDN card / fontPreview 时优先出图。停用的包在本页仍可预览。若缺少可用样式，提示「预览暂时不可用」，并参见下方包健康说明。

## 安装时的命名（rc.8 起）

装包时要分清两样东西：

| 用途 | 长什么样 | 用在哪 |
| --- | --- | --- |
| **CSS / 字体库 family** | `wenfeng-{short}`（小写短码） | `local.css`、排版选用、与文风云对齐 |
| **显示名**（给人看） | 收录名，约定写成 **「文风·」+ 原名**，例如「文风·玄宗体」 | 字体库列表、字体包页、工具页卡片 |

短码是技术 id；显示名不要写成短码本身。自 **rc.12** 起，现网构建已按「文风·{原名}」显示。

### family 怎么定（rc.8）

插件会尽量把包内族名对齐成 `wenfeng-{short}`：

1. 先读包内 `meta.json` / `metadata.json` / `font.json` 的 `fontFamily`（或 `font_family`）
2. 若没有可用目录名，再读解压后 `result.css` 里第一条 `@font-face` 的 `font-family`

| 包内写法 | 登记结果（示例） |
| --- | --- |
| `WF-Fzss` | `wenfeng-fzss` |
| `windfonts-ibmps` | `wenfeng-ibmps` |
| 已是 `wenfeng-*` | 保持，仅规范为小写 |
| 两边都认不出 | 回退为 zip 文件名（如 `fzss-zhcommon.zip` → `fzss-zhcommon`） |

对齐成功时：包 id、字体库 slug、全局样式 slug 都用这个 `wenfeng-*`；写入的 `local.css` 会改 `@font-face` 的 `font-family`；`url()` 里的 woff2 **不改名**。

认不出、只能走 zip 名回退时：字体库 slug 可能仍带原来的 `wpfonts-pkg-` 前缀。

**已经装好的旧包目录不会被改写**；要得到 `wenfeng-*` 登记，请在含 rc.8 及以上的构建里重新安装该 zip。

### 显示名怎么定

约定对外显示为 **「文风·{原名}」**（中间用间隔号「·」）。原名来自包元数据或样式注释里的中文名；缺元数据时不应把 `wenfeng-xxxx` 短码直接当列表标题。

若你当前构建的字体库里仍只看到短码，请升级到 **rc.12** 或更新后，对受影响的包 **重新安装** 一次 zip（旧登记不会自动改名）。

### 短码以本机为准

目录收录名、演示站旧包、以及某次 zip 文件名，偶尔会对不齐同一短码。排查时以本站 **已登记** 的 `font-family` / 包 id 为准；不要手编短码去「对齐」别处看到的写法。

## 启用之后

启用文风字体包后（`2.0.0-rc.4` 起；命名对齐自 **rc.8**；变体折叠自 **rc.13**）：

1. 字体进入 WordPress **字体库**，集合名是「**文风字体**」（Windfonts）。列表里应能区分显示名与 `wenfeng-*` 族名；同一字重只显示一条变体。选用排版时用族名，不要只抄显示文字。
2. 自 **2.0.0-rc.5** 起，还会**自动同步进用户全局样式**，可在 **外观 → 编辑器 → 样式 → 排版** 选用。