【图片】第三方库使用心得之xhtml2pdf【python吧】

xhtml2pdf 是一个 Python 库，用于将 HTML 和 CSS 文件转换为 PDF。它主要用于生成包含复杂布局和样式的 PDF 文档。

在图里的函数中，pisa.CreatePDF正是这个库的核心函数，其中“html”是源 HTML 内容，可以是html文件或字符串，参数“dest=result_file”是目标文件，可以是文件对象或路径字符串，参数“encoding="utf-8"”则为html文件的编码格式。

为什么lz会使用到它？
lz之前为nonebot开发了一个机器人插件，目的是想便捷地把markdown内容给可视化转化为图片，其中一个步骤是将markdown转化为html后，再将html转化为pdf（为什么不用html2image库？因为这种类似的库需要手动安装第三方工具或浏览器，我认为这种对于运行在服务器上的插件来说配置及其不方便），最后再将pdf文件通过fitz库转化为图片由机器人发送给客户端。所以xhtml2pdf就显得很重要。

下面细琐lz在使用学习这个库的一些心得体会，以及为吧u分享在使用一些小众冷门库但是网上资料又很少的时候该怎么做

发出来了吗

来了来了！！

xthml2pdf的使用方法很简单，仅需在css样式中指定好纸张的尺寸、页边距等参数，pisa.CreatePDF函数即可自动识别并转化为指定的纸张大小，比如：
@page{
size: A4 portrait;
}
这个样式就指定了转化后的pdf尺寸是A4纸的大小

然后便是lz在开发时遇到的第一个问题：中文乱码。

这个库对于第三方语言的支持比较糟糕，一开始lz导出的pdf文件中文全是方块■，网上查找以及询问ai给出的答案均是让我们在css样式中指定字体文件目录，比如：
body{
font: url;
}
可是即使是这样设置了之后，导出依旧是乱码，字体文件并没有起作用。

lz一开始一直以为是字体问题，就一直不停更换字体文件，从宋体一直到微软雅黑全试过了，方块依旧是那个方块

快给我整红温了都。
就在lz一筹莫展之际，lz突然想到，为什么不去看看官方文档呢？

果然，在官方文档里清清楚楚地写着Fonts这一个大板块

点进去一看，问题迎刃而解

不止简体中文，日文韩文都有对应的内部支持

并且下方还有示例：

按照它的示例使用之后，问题就解决了。

（为什么图中的文字带有格式？是因为html源字符串已经是格式化过后的了）
这也告诉了我们，一定一定要去看一下文档！！很多你可能会遇到的问题库的开发者已经在文档中写好了告诉你了，不要太过依赖搜索或者ai

接下来就是lz在开发过程中遇到的第二个问题：中文换行

这个问题即使是查遍文档也没有结论，文档中只提到了使用css常规换行样式“break-wrod”就行，比如：
word-wrap: break-word;
white-space: pre-wrap;
overflow-wrap: break-word;
可是正如上文所说，由于其对中文的比较糟糕的支持，即使是应用了它内置的中文字体，也没办法通过改变css样式来支持中文换行