【踩坑日记 · 前端】为 Excalidraw 添加中文手写字体

文章目录

    • 前言
    • 中文手写字体
    • 步骤
      • 1. 下载源代码和中文字体
      • 2. 注册字体
      • 3. 预加载字体资源
      • 4. 增加字体枚举
      • 5. 添加字体切换按钮
    • 部署测试
    • 参考资料

前言

Excalidraw 是一款完全免费的手绘风格绘图在线应用,能快速画出漂亮的流程图、示意图和图表,地址: Excalidraw | Hand-drawn look & feel • Collaborative • Secure

【踩坑日记 · 前端】为 Excalidraw 添加中文手写字体_第1张图片
【踩坑日记 · 前端】为 Excalidraw 添加中文手写字体_第2张图片

但美中不足的是,Excalidraw 只支持英文手写字体,好在 Excalidraw 是开源软件,我们可以通过修改代码为其添加中文手写字体。

中文手写字体

在这里向大家推荐几款好看的中文手写字体,我个人比较喜欢 沐瑶软笔手写体,下面就以这款字体为例,演示如何为 Excalidraw 添加中文手写字体。

  • 字语青梅硬笔(商用需付费)

    • (
  • 沐瑶软笔手写体(免费商用)

    • 在这里插入图片描述
  • 沐瑶随心手写体(免费商用)

    • 在这里插入图片描述

步骤

1. 下载源代码和中文字体

下载 Excalidraw 源代码 到本地并解压,或者直接使用 Git 克隆项目:

git clone https://github.com/excalidraw/excalidraw

下载中文手写体,并将其复制到 public 目录下:

【踩坑日记 · 前端】为 Excalidraw 添加中文手写字体_第3张图片

注意:字体名不能含有中文或其他特殊符号,建议将字体名重命名为纯英文。在这里我选择的字体是 沐瑶软笔手写体,并重命名为 Muyao.ttf后续代码中的字体名一定要保持一致。

2. 注册字体

编辑 public/font.css,添加文手写体:

@font-face {
  font-family: "Muyao";
  src: url("Muyao.ttf");
  font-display: swap;
}

添加完成后代码如下:

【踩坑日记 · 前端】为 Excalidraw 添加中文手写字体_第4张图片

编辑 src/index-node.ts,添加下列代码注册中文手写字体:

registerFont("./public/Muyao.ttf", { family: "Muyao" });

添加完成后代码如下:

【踩坑日记 · 前端】为 Excalidraw 添加中文手写字体_第5张图片

3. 预加载字体资源

编辑 public/index.html,在其中加入字体预加载代码,可以提高应用启动时的速度:

<link
      rel="preload"
      href="Muyao.ttf"
      as="font"
      type="font/ttf"
      crossorigin="anonymous"
      />

添加完成后代码如下:

【踩坑日记 · 前端】为 Excalidraw 添加中文手写字体_第6张图片

4. 增加字体枚举

编辑 public/constant.ts,在 FONT_FAMILY 常量中加入字体的枚举:

【踩坑日记 · 前端】为 Excalidraw 添加中文手写字体_第7张图片

5. 添加字体切换按钮

最后,编辑 /src/actions/actionProperties.tsx,在 PanelComponent 的返回值数组中加入下列元素:

{
    value: FONT_FAMILY.Muyao,
    text: t("labels.handDrawn"),
    icon: FreedrawIcon,
}

添加完成后代码如下:

【踩坑日记 · 前端】为 Excalidraw 添加中文手写字体_第8张图片

部署测试

进入 excalidraw 源代码目录,在终端中执行下列代码:

# 安装依赖包
yarn

# 启动应用
yarn start

【踩坑日记 · 前端】为 Excalidraw 添加中文手写字体_第9张图片

出现上面的输出代表应用启动成功,用浏览器访问 http://localhost:3000

【踩坑日记 · 前端】为 Excalidraw 添加中文手写字体_第10张图片

在左侧的面板中可以看到刚才添加的手写字体,选择即可切换。

参考资料

[1] Excalidraw - 免费的手绘风格白板应用 - 知乎

[2] 送给大家的免费字体:沐瑶软笔手写体_春颜秋色-站酷ZCOOL

[3] 送给大家的字体2:沐瑶随心手写体_春颜秋色-站酷ZCOOL

[4] 字语青梅硬笔字体免费下载和在线预览-字体天下

[5] GitHub - excalidraw/excalidraw: Virtual whiteboard for sketching hand-drawn like diagrams

你可能感兴趣的:(踩坑日记,&,Bug收集箱,前端,前端,流程图,工具,绘图,drawio)