编辑器与全局样式

---

• 字体库与全局样式（rc.4–rc.17）
• 两条路径请分清（帮助说明）
• 块侧栏「文派字库」
• 生命周期：停用、删除、卸载
• 现在若看不到

---

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

自 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；已装旧包不会自动改目录。详见《文风字体包》。
5. 字体库列表只有短码、没有「文风·…」：请升到 rc.12 或更新，并对该包重新安装 zip。
6. 字体库同一款字出现一长串同名 Normal：请升到 rc.13 或更新（按字重折叠）。
7. 装包页长条裂图、字体库样张 404：请升到 rc.15 或更新；仍缺图时多为 CDN 尚未覆盖该资产（装包页字形预览缺 fontPreview 时会文字回退，属预期）。