不涉及业务，讲一下技术方面PDF生成服务的心得

文档指北：

puppeteer(https://github.com/puppeteer/puppeteer)

Puppeteer is a Node library which provides a high-level API to control Chrome or Chromium over the DevTools Protocol. Puppeteer runs headless by default, but can be configured to run full (non-headless) Chrome or Chromium.

应用场景：

页面截图服务
PDF生成服务
自动化测试
服务端渲染内容抓取

try:https://try-puppeteer.appspot.com/

就几乎碰到的问题，文档上面都能找到，所以文档和生态还是比较完备的
https://github.com/puppeteer/puppeteer/blob/main/docs/api.md

也有troubleShooting的文档：
https://github.com/puppeteer/puppeteer/blob/main/docs/troubleshooting.md

基于 - DevTools Protocol

History

几次技术改造

downloadCenter
从接口获取模版渲染数据 -> 从mongodb获取
XX_report 进度状态原先由接口返回 -> 返回到mq
node服务本身 - 配合修改+日志+调试配置开关

部署和CI优化

底层脚本

pm2配置

```

#### Jenkins可视化集成


## 项目代码分析

### module本身使用代码风格不是很清晰明确
- https://github.com/chemdemo/chemdemo.github.io/issues/2
- exports.xxx | module.exports = xxx

### process
- beforeExit
- 

## 字体相关

### 字体的一些基础知识
#### Windows
- https://docs.microsoft.com/en-us/typography/
 -https://en.wikipedia.org/wiki/List_of_typefaces_included_with_Microsoft_Windows
- 微软雅黑-vista开始提供的，win8之后，加入了light,默认win平台可以设置这个，效果最好；
- Arial | Tahoma 等无衬线字体，西文选择
#### Mac
- https://en.wikipedia.org/wiki/List_of_typefaces_included_with_macOS
---------旧一点
- 华文黑体，华文细黑 10.6之前简体中文默认系统字体
- 黑体 10.6之后
- 冬青黑体 - 专业印刷字体，小字号清晰
- Time New Roman - 西文衬线，Safari默认
- Helvetica，Helvetica Neue - 可以看看history，有意思，苹果重金购买（在根号这个字符的渲染上，这个接近微软雅黑的，没有横线）
--------- 新一点
- PingFang SC - 苹果为中文用户提供的 - 极细｜。。。｜中粗 - 6个
- San Francisco - Capitan 上最新发布的
- 可以看看苹果官网针对不同地区设置的字体

#### linux
- 文泉驿微米黑 - 简体中文
- 思源黑体，（在根号这个字符的渲染上，这个接近Helvetica的，没有横线）


### 默认声明
- 尽量用英文，中文也写保险一点
- 英文放在中文前面，这样不影响中文
- `font-family: Helvetica, Tahoma, Arial;` 
- `font-family: "PingFang SC", "Hiragino Sans GB", "Heiti SC", "Microsoft YaHei", "WenQuanYi Micro Hei";`
- `font-family: Helvetica, Tahoma, Arial, "Heiti SC", "Microsoft YaHei", "WenQuanYi Micro Hei";`
- `font-family: Helvetica, Tahoma, Arial, "PingFang SC", "Hiragino Sans GB", "Heiti SC", "Microsoft YaHei", "WenQuanYi Micro Hei";`
- `font-family: Helvetica, Tahoma, Arial, "PingFang SC", "Hiragino Sans GB", "Heiti SC", "Microsoft YaHei", "WenQuanYi Micro Hei", sans-serif;` - 补充字体族
- 可以参考各个类型网站的写法
- 如果字体名称中间有空格，或者中文的，加上引号
- 版权问题 - 思源黑体，我们打印就用的这个

### 一些参考
- https://github.com/zenozeng/fonts.css
- https://github.com/sofish/typo.css - 好久以前的，可以看一眼
### 页眉页脚中文字体
- https://www.npmjs.com/package/pdf-lib#embed-font-and-measure-text
- https://github.com/Hopding/pdf-lib/issues/430
- 额外引入一些特殊的中文字体，如果直接用pdf-lib，@pdf-lib/fontkit（旧版本） ，则需配合font-carrier进行字体精简
- https://www.npmjs.com/package/pdfkit， pdfkit则不用，默认精简
- @pdf-lib/fontkit - https://github.com/Hopding/fontkit , https://github.com/foliojs/fontkit

font-carrier

案例三
对中文字体精简

var fontCarrier = require(‘font-carrier’)
var transFont = fontCarrier.transfer(‘./test/test.ttf’)
// 会自动根据当前的输入的文字过滤精简字体
transFont.min(‘我是精简后的字体，我可以重复’)
transFont.output({
path: ‘./min’
})

```
const fontkit = require('@pdf-lib/fontkit');
doc.registerFontkit(fontkit); // 注册字体
# 如果直接用的话，则默认无裁剪，会导致生成的PDF文件过大
# 可以利用font-carrier解决
const fontCarrier = require('font-carrier');
const transFont = fontCarrier.transfer(`${dir}/font/pingfang.ttf`);
transFont.min(headerFooter.title.join('') + extra + '.');
const fontMinResult = transFont.output({
    types:['ttf']
  });
  // 加载自定义字体
const customFont = doc.embedFont(fontMinResult.ttf);

# 基于font subsetting来做
const fontBytes = fs.readFileSync('./font/pingfang.ttf')
const pdfDoc = await PDFDocument.create()
pdfDoc.registerFontkit(fontkit)
const font = await pdfDoc.embedFont(fontBytes, { subset: true });
# 这个目前版本会有问题，出来的文件除了adobe能正常读取，其余软件显示乱码

# 较新版本支持subset
const subset = font.createSubset();
run.glyphs.forEach(function(glyph) {
  subset.includeGlyph(glyph);
});

subset.encodeStream()
      .pipe(fs.createWriteStream('subset.ttf'));
# 但是sub

割字问题

保证内容里面不想被切割的，为块装结构

echarts部分图丢失

升级puppteer

开源字体

思源 - 是由Google和Adobe合作开发的。Google将其命名为Noto SansCJK，作为Google的Noto字体家族的成员。Adobe则命名为Source Han Sans，作为Adobe的Source字体家族的一员。Adobe拥有字体设计的版权。发布的字体文件则可以不受限制的免费使用。
打印用的字体就是思源，跑在linux机器上
这个属于 sans-serif
黑体字属于“无衬线体”（Sans-serif），而宋体字属于“有衬线体”（Serif）
ttf2woff2 (dep by font-carrier)
https://www.npmjs.com/package/ttf2woff2
This is a NodeJS wrapper for the Google WOFF2 project. If the C++ wrapper compilation fail, it fallbacks to an Emscripten build.
Convert TTF files to WOFF2 ones.

truetype | type1

TrueType是苹果和微软联合提出的一种新型数学字形描述，既可以作打印字体，又可以用作屏幕显示
OpenType，封装格式和truetype兼容，轮廓格式是Postscript
Type1 ,在Opentype出现前，Adobe的印刷字体封装格式，使用PS曲线
Type0. Postscript里的复合字体
字体构成
- 轮廓格式（TT/PS） —— 记载字符的形状（矢量）
- 封装格式（SFNT/Type 1）—— 封装成一个文件的方法
- 编码方式（Unicode/CID） —— 决定字体里字符的内部编号、Unicode 以及轮廓的对应关系
书本推荐：Fonts & Encodings - 作者: Yannis Haralambous

C端下载文件

web端

https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Headers/Content-Disposition
我们文件制作完成会上传腾讯云CDN
C端下载的话，注意content-disposition （看下response里面这部分的值）

腾讯云支持query传参设定response里面的content-disposition的值

https://cloud.tencent.com/document/product/436/57420
获取对象访问 URL
功能说明
查询对象访问的 URL，该接口不会判断对象是否真实存在。

说明：
如何使生成的对象URL在浏览器中打开是预览，而不是下载：在获取的url后拼接参数 response-content-disposition=inline
如何使生成的对象URL在浏览器中打开是下载，而不是预览：在获取的url后拼接参数 response-content-disposition=attachment

–no-sandbox

如果服务端root权限下运行
running as root without –no-sandbox is not supported
linux 里面使用Chrome也是这个道理，都会有这个权限问题

iframe

等待加载完成 - page.waitFor(提供各种模式)

1	It's generally recommended to not wait for a number of seconds, but instead use Page.waitForSelector(), Page.waitForXPath() or Page.waitForFunction() to wait for exactly the conditions you want.

chromium下载

https://storage.googleapis.com/chromium-browser-snapshots/
extract-zip

Others

如果需要打印PPT呢？

模拟翻页操作
每次翻页之后，获取需要打印的DOM - this.page.evaluate(domStr => document.body.innerHTML = domStr, content);
https://pptr.dev/api/puppeteer.page.evaluate/
后台打印可用超管账号（增加中间件）

TTF, OTF, WOFF, EOT & SVG

WOFF 最小，最适合web
SVG Safari低版本支持
TTF 苹果微软，兼容性最好
OTF Adobe微软
EOT 微软

WOFF (Web Open Font Format)

本质上是 metadata + 基于 SFNT 的字体（如 TTF、OTF 或其他开放字体格式）
由 Mozilla 基金会、微软和 Opera 软件公司合作推出
WOFF 字体均经过 WOFF 的编码工具压缩，文件大小一般比 TTF 小 40%，加载速度更快，以更好的嵌入网页中
metadata 允许在字体文件中包含许可数据，以解决版权问题
WOFF2 格式在原有的基础上提升了 30% 的压缩率