WeasyPrint中文指南：快速掌握在Python中生成中文PDF文档的技巧

发布时间：2024-01-01 08:54:05

WeasyPrint是一个用于生成PDF文档的Python库。它具有简单易用的API，可以通过HTML和CSS来定义文档的样式和布局。本指南将帮助您了解如何在Python中使用WeasyPrint生成中文PDF文档，并提供一些使用示例。

一、安装WeasyPrint

要使用WeasyPrint生成PDF文档，您需要先安装WeasyPrint库。可以通过使用pip命令来安装它：

pip install WeasyPrint

二、基本用法

生成一个简单的中文PDF文档非常简单。首先，您需要导入WeasyPrint库，并定义一个HTML字符串来作为文档的内容。然后，您可以使用WeasyPrint提供的HTML类来创建一个Document对象，并将HTML字符串传递给它。最后，您可以使用write_pdf方法将文档保存为PDF文件。

下面是一个简单的示例，演示了如何生成一个包含中文内容的PDF文档：

from weasyprint import HTML

html = """
<html>
  <head>
    <meta charset="utf-8">
  </head>
  <body>
    <h1>欢迎使用WeasyPrint！</h1>
    <p>这是一个中文PDF文档的示例。</p>
  </body>
</html>
"""

doc = HTML(string=html)
doc.write_pdf('example.pdf')

在上面的示例中，我们首先使用<meta charset="utf-8">来指定HTML文档的字符编码为UTF-8，以支持中文字符。然后，我们定义了一个包含中文内容的HTML字符串。最后，我们使用WeasyPrint创建了一个HTML文档，将HTML字符串传递给HTML类的构造函数。最后，我们使用write_pdf方法将文档保存为名为example.pdf的PDF文件。

三、添加样式和布局

WeasyPrint允许通过CSS来定义文档的样式和布局。您可以使用以.css结尾的CSS文件，或将CSS字符串传递给WeasyPrint的HTML类的stylesheets参数。您可以在CSS中使用各种选择器、属性和值来定义文档的样式。下面是一个示例：

from weasyprint import HTML, CSS

html = """
<html>
  <head>
    <meta charset="utf-8">
    <style>
      h1 { color: red; }
      p { font-size: 14px; }
    </style>
  </head>
  <body>
    <h1>欢迎使用WeasyPrint！</h1>
    <p>这是一个中文PDF文档的示例。</p>
  </body>
</html>
"""

css = """
@font-face {
  font-family: '宋体';
  src: url('simsun.ttf');
}

body {
  font-family: '宋体';
}
"""

doc = HTML(string=html).write_pdf(stylesheets=[CSS(string=css)], font_config='/path/to/font/config')
doc.write_pdf('example.pdf')

在上面的示例中，我们使用<style>标签将CSS样式直接写在HTML文档中。我们定义了h1元素的颜色为红色，定义了p元素的字体大小为14像素。

此外，我们使用@font-face规则来定义了一个自定义字体。我们将一个TrueType字体文件simsun.ttf放在当前目录中，并将其路径作为url的值传递给src属性。然后，我们使用font-family属性将宋体作为字体应用到整个文档的body元素上。

最后，我们通过将CSS字符串传递给CSS类的构造函数，将CSS样式传递给WeasyPrint的HTML类的stylesheets参数。注意，我们还传递了一个font_config参数，用于指定字体配置文件的路径。这是WeasyPrint需要的一个字体配置，用于识别自定义字体。

四、导出中文字符

在生成PDF文档时，WeasyPrint可以正确处理中文字符。默认情况下，WeasyPrint将使用操作系统上已安装的字体来渲染中文字符。如果您希望使用自定义字体，您需要在CSS中进行相应的配置，就像上面的示例中所做的那样。

五、更多示例

使用WeasyPrint生成中文PDF文档的可能性是无限的。您可以在HTML中使用各种中文内容，包括文本、标题、段落、表格、图像等等。您可以使用CSS来定义各种样式和布局，包括颜色、字体、字号、边距、对齐方式等等。

以下是一些更具体的示例，以帮助您更好地了解WeasyPrint的功能和用法。

- 生成包含中文标题和段落的PDF文档：

from weasyprint import HTML

html = """
<html>
  <head>
    <meta charset="utf-8">
  </head>
  <body>
    <h1>欢迎使用WeasyPrint！</h1>
    <p>这是一个中文PDF文档的示例。</p>
  </body>
</html>
"""

doc = HTML(string=html)
doc.write_pdf('example.pdf')

- 生成包含中文表格的PDF文档：

from weasyprint import HTML

html = """
<html>
  <head>
    <meta charset="utf-8">
  </head>
  <body>
    <table>
      <tr>
        <th>姓名</th>
        <th>年龄</th>
      </tr>
      <tr>
        <td>张三</td>
        <td>25</td>
      </tr>
      <tr>
        <td>李四</td>
        <td>30</td>
      </tr>
    </table>
  </body>
</html>
"""

doc = HTML(string=html)
doc.write_pdf('example.pdf')

- 生成包含中文图像的PDF文档：

from weasyprint import HTML

html = """
<html>
  <head>
    <meta charset="utf-8">
  </head>
  <body>
    <h1>欢迎使用WeasyPrint！</h1>
    <img src="image.jpg">
  </body>
</html>
"""

doc = HTML(string=html)
doc.write_pdf('example.pdf')

在上面的示例中，我们使用<img>标签将名为image.jpg的图像嵌入到PDF文档中。

六、结论

通过本指南，您应该已经掌握了在Python中使用WeasyPrint生成中文PDF文档的基本技巧。您可以使用WeasyPrint生成包含各种中文内容的PDF文档，并使用CSS来定义文档的样式和布局。希望本指南对您有所帮助，祝您成功使用WeasyPrint生成中文PDF文档！