# 编辑器与全局样式

> 适合谁看：想在块编辑器或全局样式里选用文派字库字体的站长。

自 **2.0.0-rc.4** 起，文派字库把已启用的文风字体包、以及目录里已确认可用的文风云字体脸，登记进 WordPress **字体库**；块检查器里也开始有一块名为「文派字库」的面板。自 **2.0.0-rc.5** 起，这些字体还会**自动写入用户全局样式**（`wp_global_styles`），可在 **外观 → 编辑器 → 样式 → 排版** 里看见，不必再到字体库里手动「安装」一遍。

正式版以发版说明为准；下文描述的是当前 **`2.0.0-rc.17`** 构建上的行为（兼容 rc.8 命名对齐、rc.12 显示名、rc.13 变体折叠、rc.16–rc.17 样张分流）。

## 字体库与全局样式（rc.4–rc.17）

| 版本 | 行为 |
|---|---|
| **2.0.0-rc.4** | 已启用的文风字体包装进字体库集合「文风字体」（Windfonts）；目录已确认脸以「文风云」登记；字体库安装写入用户全局样式路径 |
| **2.0.0-rc.5** | 启用包、以及已确认的文风云脸，会**自动复制进用户全局样式**；在 **外观 → 编辑器 → 样式 → 排版** 可见 |
| **2.0.0-rc.6** | 块检查器面板「文派字库」**现网可见**（侧栏可见性修复） |
| **2.0.0-rc.7** | 可保存**多张**已确认文风云脸（字体库「文风云」与侧栏「文派字库」都会列出）；系统语种四勾选；帮助文案写清侧栏 vs 排版；包健康提示；工具导出/导入 |
| **2.0.0-rc.8** | 安装文风字体包时，能识别的族名对齐为 `wenfeng-*`；字体库 / 全局样式 slug 用该短名（不再套 `wpfonts-pkg-`）；写入的 `local.css` 同步改写；已装旧包不改目录 |
| **2.0.0-rc.10** | 设置可指定中文回退 / 正文 / 标题，便于全站中文排版选用 |
| **2.0.0-rc.11** | 管理界面：简单/高级；本站包优先的工具首屏；装包预览族名来自 local.css；页脚版本与反馈 |
| **2.0.0-rc.12** | 文风字体包在字体库中的显示名优先「文风·{原名}」；family / slug 仍为 `wenfeng-*`（**现网已是**） |
| **2.0.0-rc.13** | 字体库按字重折叠变体：每个字重只显示一条，不再一长串同名 Normal |
| **2.0.0-rc.14–rc.15** | 字体库样张可走 CDN `preview.webp`；短码别名修正裂图 |
| **2.0.0-rc.16** | 装包页用 card 长条；字体库继续用 preview |
| **2.0.0-rc.17** | 中文回退空态人话；选用字体卡片；装包页字形预览接 fontPreview（缺图文字回退） |

要点：

- **不修改主题文件**。站长自有的字体、颜色等全局样式条目不受影响。
- 系统字体栈（**系统 · 中文 / 英文 / 日文 / 韩文**）默认证入字体库；在设置里取消某语种勾选后，该语种**不再登记**。
- 前台访客请求**不会**写入全局样式 post。
- 选用时请用 `wenfeng-*` 这类 `fontFamily`（本站包在 **rc.8** 起尽量与此一致），不要只抄显示名。
- 字体库里看到的「文风·…」是显示名；真正写入样式的仍是 `wenfeng-*` 族名。两者不要混用。
- 字体库列表里的样张图是 **preview**；装包管理页的长条是 **card**——分流属预期。

## 两条路径请分清（帮助说明）

自 **2.0.0-rc.7** 起，插件帮助区写死这两条：

1. **块侧栏「文派字库」**：只作用于**当前块**的字族选择；不会拉整站目录去改主题。
2. **已启用的文风字体包** + **已确认的文风云脸** → 进入**全站**用户全局样式 → 再到 **外观 → 编辑器 → 样式 → 排版** 选用。

两者互补，不要混成「侧栏等于全站排版」。

## 块侧栏「文派字库」

rc.4 起，块检查器里增加了名为 **「文派字库」** 的面板；rc.6 起现网可见。自 **rc.7** 起，面板会列出：

- 已启用的文风字体包（组名「文风字体」）
- **每一张**已确认的文风云脸（组名「文风云」）

选中后只改当前块的 typography 字族。

## 生命周期：停用、删除、卸载

| 操作 | 对全局样式的影响 |
|---|---|
| 停用或删除文风字体包 | **只移除本插件为该包写入的条目**；其它全局样式保留 |
| 从已确认列表里去掉一张文风云脸 | **只移除本插件为该脸写入的条目**；其它云脸与其它 GS 保留 |
| 卸载插件 | 清设置项、目录快照等插件数据；**不删除**用户全局样式（`wp_global_styles`） |

若卸载后排版里还指着已卸掉的字体，需要自己在站点编辑器里改回。

## 现在若看不到

1. **排版里没有自动同步的字体**：请升到含 **2.0.0-rc.5**（含）以上的构建，并确认文风字体包已启用，或至少有一张文风云脸已确认可用。
2. **字体库里没有集合**：至少需要含 **rc.4** 的构建，且包已启用 / 脸已确认；系统栈则看语种勾选是否仍开启。
3. **块侧栏没有「文派字库」面板**：请升到含 **2.0.0-rc.6** 的构建。多脸列表需要 **rc.7**。
4. **本站包装完仍是 `WF-*` / zip 名、对不上云字**：请升到 **2.0.0-rc.8** 后**重新安装**该 zip；已装旧包不会自动改目录。详见[《文风字体包》](https://docs.cocobook.com/books/wpfonts/page/wpfonts-packages)。
5. 字体库列表只有短码、没有「文风·…」：请升到 **rc.12** 或更新，并对该包重新安装 zip。
6. 字体库同一款字出现一长串同名 Normal：请升到 **rc.13** 或更新（按字重折叠）。
7. 装包页长条裂图、字体库样张 404：请升到 **rc.15** 或更新；仍缺图时多为 CDN 尚未覆盖该资产（装包页字形预览缺 `fontPreview` 时会文字回退，属预期）。