@guidewire/web-font-builder

中文文档
0.0.1-alpha.10发布于 2024/01/25MIT近 30 天下载 5126

鹅卵石图标字体构建工具

中文使用文档
文档目录6 节
  1. 图标
  2. 在 PCF( 最常见) 中使用已有图标 glyph
  3. 使用 SASS (Less Community) 中已有的图标
  4. 添加新图标
  5. 添加对 FontAwesome5 Pro 的支持
  6. 打印和图标

保险套件应用指南线图标字体构建器

此软件包应通过 nvm @guidewire/web-font-builder 从您的保险套件应用程序的网络资源目录中 只有当您添加了新的图标,或者修改了现有的图标时,才需要这个工具.

图标

图标字体来自SVG文件的文件夹.

将 svg 文件放入 gw 文件夹或 fa5 文件夹, 然后运行字体构建进程将更新各种字体文件, 以及 SASS 映射

在 PCF( 最常见) 中使用已有图标 glyph

  1. 在 PCF 中,将图标名称字段设置为 svg 文件的名称
  2. 将图标类型设定为正确的设置。 svgFile用于标准gw字体,gwFontGlyph用于(目前设置为Font Cousne 5 Free),或者客户选项,如果您添加了全新的字体面.

使用 SASS (Less Community) 中已有的图标

  1. 通过 SASS 定义的客户端中几乎所有图标都将有一个全局可主题变量
  • 意思是,如果它是北面板中的图标,而不是通过 PCF 定义,那么查看 NorthPanel_themeable.scss 你会找到类似的东西 gw-NorthPanel--unsaved-work-icon-glyph: "bookmark" !default;
  • 覆盖您主题文件中的变量以指向另一个图标 glyph 。 如果是gw图标,只需使用glyph名称,如果是FontAwesome glyph,则使用正则名-固态名-固态名-固态名-固态名-固态名-固态名-固态名-固态名-固态名-固态名-固态名-固态名-固态名-平态名-平态名-平态名-平态名-平态名-平态名-平态名-平态名-平态名-平态名-平态名-平态名-平态名-平态名-平相-平态名-平态名-平态名-平态名-平态名-平态名-平态名-平态名-平态名-平态名-平态名-平态名-平态名-平态名-平态名-平态名-平态名-平态名-平态名-平态名-平态名-平态名-平相-平态名-平态名-平态名-平态名-平态名-平态名-

添加新图标

  • 将图标. svg 文件添加到 gw 图标文件夹
  1. 本地安装节点JS
  2. 通过命令行导航您的保险套件应用程序的网络资源文件夹
  3. 执行 npx @guidewire/web-font-builder
  4. 这将生成新的字体文件、 ass 文件以及 sass 映射
  5. 这些新文件需要检查 。 目前,这将造成雪猫升级出错,而字体.css等被修改的文件会被覆盖,这项工作正在进行中

添加对 FontAwesome5 Pro 的支持

  • 从 FontAwesome 为 Pro 字体购买许可证
  1. 从 FontAwesome 下载 svg 文件
  2. 把它们添加到 fa5 文件夹
  3. 运行“ 添加新图标” 指令

打印和图标

  1. 如果新图标被添加或修改,并且也作为自定义内部应用程序PDF打印过程的一部分使用(NOTE:这不是标准浏览器打印),且图标需要使用 显示在最后 PDF( 很少做) 中, 然后需要将 png 文件显示在 webresources/ img/app/ print- png 中 遵循print.svgFileName. [icon name here].png的命名模式 -我们提供了export-png.js,作为将现有的 svg 文件转换为 png 文件的手段,但是有许多免费的,更好的在线替代方案

版本与发布记录

@guidewire/web-font-builder 共发布 9 个版本,首次发布于 2023/09/01;过去 12 个月发布了 0 个版本。

版本发布日期距今
0.0.1-alpha.10latest2024/01/252 年前
0.0.1-alpha.92023/10/213 年前
0.0.1-alpha.72023/10/213 年前
0.0.1-alpha.62023/10/213 年前
0.0.1-alpha.42023/10/213 年前
0.0.1-alpha.32023/09/023 年前

其他发布通道:alpha → 0.0.1-alpha.2。

关于 @guidewire/web-font-builder 的常见问题

@guidewire/web-font-builder 是什么?

鹅卵石图标字体构建工具

如何安装 @guidewire/web-font-builder?

在项目目录运行 npm install @guidewire/web-font-builder,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 web-font-builder,可以用 npx web-font-builder 直接运行。

@guidewire/web-font-builder 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/guidewire__web-font-builder 是否存在。

@guidewire/web-font-builder 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=16.15.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@guidewire/web-font-builder 可以商用吗?

@guidewire/web-font-builder 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@guidewire/web-font-builder 的下载量有多少?

根据 npm 官方下载统计,@guidewire/web-font-builder 在 2026/10/17 – 2026/11/15 这 30 天内被下载 5,126 次,日均约 171 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@guidewire/web-font-builder 还在维护吗?

最新版本 0.0.1-alpha.10 发布于 2024/01/25(2 年前);至今共发布 9 个版本,其中过去 12 个月发布了 0 个;首次发布于 2023/09/01。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。