常见问题¶
上传文档时报「doc文件暂不支持」¶
.doc 是老式的 Word 格式,后端不认识。把它另存为 .docx 再上传。
支持的格式是 .docx、.pdf、.txt、.rtf。文件选择框里能看到 .doc,
但选了会被服务端拒绝。
上传了自己的字体,但生成出来还是原来的字¶
上传后会自动选中该字体;如果后来切换过字体,请在下拉框中重新选择上传文件的名字。
支持 .ttf、.otf 和 .ttc;请确认文件是有效的字体。
生成一直没反应¶
多半是在排队。看两个地方:
- 工作台状态 —— 查看任务是否仍在排队或处理中。
- 预览区 —— 查看进度;队列满时会显示重试倒计时。
后端同时处理的任务数有限,人多时需要等待。失败时结合提示检查后端是否可访问。
生成到一半被截断了¶
先确认是否只生成了默认的单页预览;勾选「预览全部页面」或导出 ZIP / PDF。 应用没有固定的 10 页截断。 长文本仍受机器内存、代理超时和服务端限制影响。
宽度高度和背景图片不能同时设置¶
两者是互斥的:给了宽高就自动生成稿纸,传了背景图就用你的图当底。 想换过来,先把另一个清掉(背景图右上角有个 ✕)。
生成出来的纸上有横线,我不想要¶
取消勾选**「添加横线」**。自动生成的稿纸也看这个开关;背景图片自带的线条不会因此移除。
字挤在一起 / 看起来太乱¶
看参数详解最后一节的「调参建议」。最常见的两种情况:
- 字叠在一起 → 加大行间距(要大于字体大小)。
- 太潦草 → 降低笔画旋转偏移,它对手写观感的影响最大。
书信排版之后我的空行都没了¶
这是设计如此 —— 书信排版会去掉所有空行,按段首空两格重新排。 点「撤销排版」可以还原。细节见中文书信排版。
可以商用吗¶
代码是 MIT 许可,见仓库里的 LICENSE。 分发时保留原作者及贡献者的许可和版权声明。
字体是另一回事:仓库自带的字体和上传的字体各有各的授权,能不能商用取决于那个字体本身。
ttf_files/ 里的字体请自行确认授权,别默认它们跟着代码一起是 MIT。
有问题去哪问¶
- 本 fork 的 GitHub Issue:https://github.com/SXP-Simon/handwriting-web/issues。请附版本、复现步骤和相关日志,避免公开个人正文。