快速入门：使用WeasyPrint和Python生成专业级的中文PDF文档

发布时间：2024-01-01 08:57:08

WeasyPrint是一个用于生成PDF文件的Python库，它使用HTML和CSS作为输入。它能够自动处理页面布局、分页、字体嵌入等复杂任务，可以帮助我们生成专业级的中文PDF文档。在本文中，我们将快速入门使用WeasyPrint和Python来创建中文PDF文档，并提供示例代码和说明。

安装和设置：

首先，我们需要安装WeasyPrint库。在命令行中运行下面的命令来安装：

pip install WeasyPrint

接下来，我们还需要安装一些依赖库。具体安装方法请参考WeasyPrint的官方文档。

生成PDF：

我们将以一个简单的例子开始，生成一个包含中文内容的PDF文档。首先，创建一个名为example.html的HTML文件，并将以下内容复制到文件中：

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>中文PDF示例</title>
</head>
<body>
    <h1>欢迎使用WeasyPrint！</h1>
    <p>这是一个生成中文PDF示例。</p>
    <p>中文显示正常吗？</p>
</body>
</html>

然后，我们可以使用下面的Python代码加载HTML文件并生成PDF：

from weasyprint import HTML

HTML('example.html').write_pdf('example.pdf')

以上代码将生成一个名为example.pdf的PDF文件，其中包含我们在HTML文件中定义的内容。使用浏览器打开这个文件，你会看到一个包含标题、段落和问题的PDF文档。

更高级的用法：

除了HTML文件，WeasyPrint还支持直接传递字符串和URL作为输入。这使得我们可以使用WeasyPrint从数据库或网络上动态生成PDF文档。

from weasyprint import HTML

# 直接传递字符串
html = '''
<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>中文PDF示例</title>
</head>
<body>
    <h1>欢迎使用WeasyPrint！</h1>
    <p>这是一个生成中文PDF示例。</p>
    <p>中文显示正常吗？</p>
</body>
</html>
'''

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

# 传递URL
HTML(url='http://example.com').write_pdf('example.pdf')

在这个示例中，我们可以使用HTML函数的string参数直接传递一个包含HTML代码的字符串。同样，我们也可以使用url参数传递一个URL地址，WeasyPrint将自动加载该URL的内容并生成PDF。

高级设置：

WeasyPrint还支持一些高级设置，例如设置页面大小、页眉页脚、字体样式等。以下是一些常用的高级选项：

from weasyprint import HTML, CSS

# 设置页面大小
HTML('example.html').write_pdf('example.pdf', 
    stylesheets=[CSS(string='@page { size: A4; }')])

# 设置页眉页脚
HTML('example.html').write_pdf('example.pdf',
    stylesheets=[CSS(string='@page { @top-left { content: "页眉"; }}')])

# 设置字体
HTML('example.html').write_pdf('example.pdf', 
    stylesheets=[CSS(string='.font { font-family: "微软雅黑"; }')])

# 设置打印选项
HTML('example.html').write_pdf('example.pdf', 
    stylesheets=[CSS(string='@media print { .no-print { display: none; } }')])

在这些示例中，我们可以使用CSS样式表来自定义PDF的外观。通过设置pages样式，我们可以调整页面的大小。通过使用@top-left样式，我们可以在页面的左上角添加一个简单的页眉。通过选择一个合适的字体，我们可以确保中文内容的正确显示。通过设置no-print类，我们可以隐藏在打印模式下不需要显示的内容。

总结：

在本文中，我们快速介绍了如何使用WeasyPrint和Python来生成专业级的中文PDF文档。我们了解了如何安装和设置WeasyPrint，如何使用HTML文件、字符串和URL作为输入，以及如何使用高级设置来自定义PDF的外观。通过这些示例，你可以开始使用WeasyPrint来生成自己的中文PDF文档，并根据需要进行定制。希望本文可以帮助到你！