@docx-editor.dev/fonts-cjk (英语)
这个软件包为中,日,韩文本提供Noto Sans CJK JP. 这个 @docx-editor.dev/docx-to-pdf 软件包将它用作可选倒计时器,编辑器通过 cjkFonts() 解决者。 字体文件大约为16 MB,所以它分开发行.
安装
使用节点.js ^20.16.0 || >=22.3.0。用 PDF 转换器及其所需的引擎端口安装软件包:
npm install @docx-editor.dev/docx-to-pdf @docx-editor.dev/core @docx-editor.dev/fonts-cjk
转换器声明 @docx-editor.dev/fonts-cjk 作为一种可选的同伴依赖。 使用满足转换器对等依赖范围的版本. PDF导出找不到配置软件包,并从磁盘上读取其字体. 它不对该字体进行网络请求.
字体选择
PDF 导出在早期来源缺少所请求的CJK家族或字符时使用此字体. fonts,启用的系统字体、包装替代物,以及 fallbackFonts 资源优先。 此字体在文档嵌入字体和 lastResortFonts。关于完整顺序,见 配置 PDF 字体。 。 。 .
默认的glyph倒置列表包括了这个字体. 如果你提供 glyphFallbacks,您列表将替换默认值。 对于这个倒计时,请添加一个条目: family: NOTO_SANS_CJK_JP_FAMILY, (中文(简体) ), weight: 400,以及 style: 'normal'。 。 。 .
您可以在安装或提供的字体覆盖您的 CJK 文本时省略此软件包 。 安装了SimSun、Batang和MS Gothic等字体,在 useSystemFonts 实值 true。如果没有字体覆盖 CJK 字符,导出报告 a missing-glyph 诊断。 当这个包没有的时候,诊断器会命名它. 严格的导出失败 .
部署软件包
将软件包添加到您的生产依赖中。 保留在服务器捆绑的外部, 这样Node.js就可以在运行时解决它. 保留其 dist/ 财务报告和审定财务报表 assets/ 软件包位置的目录 。 在分发软件包时包含其许可证文件 .
缺少或无法读取字体资产报告的已安装软件包 font-origin-failed检查 result.fontResolution.originFailures 寻找原因 设置 fontPolicy: 'strict' 拒绝这些源失败.
部署实例见 整合 PDF 转换。 。 。 .
使用编辑器中的字体
对于浏览器编辑器,请在您现有的编辑器依赖性旁边安装此软件包 :
npm install @docx-editor.dev/fonts-cjk
这个 @docx-editor.dev/fonts-cjk/browser 进口 cjkFonts(),字体解析器,形状与 packagedFonts() 财务报告和审定财务报表 googleFonts() 从 @docx-editor.dev/fonts。放在您喜欢的字体来源之后:
import { packagedFonts } from '@docx-editor.dev/fonts';
import { googleFonts } from '@docx-editor.dev/fonts/google';
import { cjkFonts } from '@docx-editor.dev/fonts-cjk/browser';
const fonts = [packagedFonts(), googleFonts(), cjkFonts()];
第一幅画不等待下载。 编辑器将文档用其他字体来作画,再等这个字体到来后再铺出. 要用其他字体安装, 请通过 cjkFonts({ loading: 'wait' })。接收此解析器的文档导出总是等待字体.
如果你能从第三方装入字体, googleFonts({ cjk: true }) 从 @docx-editor.dev/fonts/google 是一种选择。 它为文档使用的每种语言装入一个较小的区域面. 不要合并 cjk: true 与 cjkFonts():两个字体都会被下载,列出的出处会先被涂上.
解析器只当文档名称为 CJK_SUBSTITUTED_FAMILIES,或其中一个本地化名称在 LOCALIZED_CJK_FAMILIES您的捆绑者将字体文件作为资产释放, 解析器从那里获取 。 不向第三方提出要求。 浏览器条目仅为 ECMAScript 模块,因为它通过 import.meta.url。 。 。 .
下载失败的调用 onFailure 选项,或写控制台警告。 然后文档保留了其他字体.
直接使用字体
节点.js条目有这些公共出口:
| 导出 | 类型 | 数值 |
|---|---|---|
NOTO_SANS_CJK_JP_FAMILY | 字符串字义 | 'Noto Sans CJK JP' |
NOTO_SANS_CJK_JP_URL | URL | A 类 file: URL 为 assets/NotoSansCJKjp-Regular.otf。 。 。 . |
CJK_SUBSTITUTED_FAMILIES | readonly string[] | 字体代表的东亚家族. |
LOCALIZED_CJK_FAMILIES | ReadonlyMap<string, string> | 本地化的姓氏,被绘制为他们的英文名. |
使用导出的 URL 不构建软件包路径而读取字体 :
import { readFile } from 'node:fs/promises';
import { NOTO_SANS_CJK_JP_FAMILY, NOTO_SANS_CJK_JP_URL } from '@docx-editor.dev/fonts-cjk';
const bytes = await readFile(NOTO_SANS_CJK_JP_URL);
console.log(NOTO_SANS_CJK_JP_FAMILY, bytes.byteLength);
Node.js条目没有将字体捆绑入JavaScript或安装浏览器字体.
范围和限制
- 该套件包括一个OpenType字体并有CFF大纲:Noto Sans CJK JP Regular.
- 它的重量是
400,其风格是'normal'。 。 。 . - 它供应了日本的区域面相,没有单独的中国或韩国的区域面相.
- PDF导出能从这个正则面上合成出粗体和斜体.
- 替换此字体可以更改glyph表单,换行符和分页计数.
- 字体覆盖范围以外的字符仍需要另一个字体.
通过转换器提供自己的字体 fonts 当您需要特定区域面相或设计样式时.
许可证
包代码使用Apache许可证2.0. 更多信息见 LICENSE。PDF转换器使用单独的 EigenPal Pro 许可证。 。 。 .
该字体使用SIL开放字体许可证,版本1.1. 许可证文本在 licenses/NotoSansCJK-OFL.txt。 。 。 .
- 字体:Noto Sans CJK JP正版,2.004版.
- 版权:© 2014-2021 Adobe (中文(简体) )http://www.adobe.com/ (中文(简体) )) (中文(简体) ).
- 商标:Noto是Google Inc的商标.
- 资料来源:
notofonts/noto-cjk。 。 。 .
字体文件是未修改的上游二进制. assets/sources.json 记录它的源 URL 和 SHA-256 散列。 PDF 导出时只嵌入文档使用的格子.