weasyprint，一个超酷的 Python 库！

Sitin涛哥

已于 2024-05-31 09:21:25 修改

阅读量2.5k

点赞数 10

分类专栏： Python 文章标签： python 开发语言

于 2024-05-29 22:30:00 首次发布

本文链接：https://blog.csdn.net/wuShiJingZuo/article/details/139317948

版权

Python 专栏收录该内容

1435 篇文章

订阅专栏

更多Python学习内容：ipengtao.com

大家好，今天为大家分享一个超酷的 Python 库 - weasyprint。

Github地址：https://github.com/Kozea/WeasyPrint/

在现代Web开发中，将HTML和CSS转换为PDF或图像文件是一项常见的需求。Python的WeasyPrint库是一种强大的工具，能够将HTML和CSS渲染为PDF和PNG文件。WeasyPrint基于现代Web标准，支持复杂的CSS布局和字体渲染，适用于生成高质量的打印和出版内容。本文将详细介绍WeasyPrint库，包括其安装方法、主要特性、基本和高级功能，以及实际应用场景，帮助大家全面了解并掌握该库的使用。

安装

要使用WeasyPrint库，首先需要安装它。可以通过pip工具方便地进行安装。

以下是安装步骤：

pip install WeasyPrint

此外，还需要安装一些系统依赖项，以确保WeasyPrint的正常运行。

以下是安装系统依赖项的命令（适用于Debian/Ubuntu系统）：

sudo apt-get install libpango1.0-dev libcairo2 libcairo2-dev

安装完成后，可以通过导入WeasyPrint库来验证是否安装成功：

import weasyprint
print("WeasyPrint库安装成功！")

特性

支持现代HTML和CSS：WeasyPrint支持大部分现代HTML和CSS特性，包括Flexbox、Grid布局、Web字体等。
高质量输出：能够生成高质量的PDF和PNG文件，适用于打印和出版。
易于使用：提供简单易用的API，方便开发者快速上手。
多平台支持：支持在Windows、MacOS和Linux平台上运行。
扩展性强：支持自定义样式和脚本，适用于复杂的渲染需求。

基本功能

生成PDF文件

使用WeasyPrint库，可以方便地将HTML和CSS渲染为PDF文件。

以下是一个简单的示例：

from weasyprint import HTML

# 定义HTML内容
html_content = """
<!DOCTYPE html>
<html>
<head>
    <title>WeasyPrint 示例</title>
    <style>
        body { font-family: Arial, sans-serif; }
        h1 { color: #333; }
    </style>
</head>
<body>
    <h1>WeasyPrint 示例</h1>
    <p>这是一个简单的HTML转换为PDF的示例。</p>
</body>
</html>
"""

# 渲染为PDF
html = HTML(string=html_content)
html.write_pdf("output.pdf")
print("PDF文件生成成功！")

生成PNG文件

WeasyPrint也支持将HTML渲染为PNG文件。

以下是一个示例：

from weasyprint import HTML

# 定义HTML内容
html_content = """
<!DOCTYPE html>
<html>
<head>
    <title>WeasyPrint 示例</title>
    <style>
        body { font-family: Arial, sans-serif; }
        h1 { color: #333; }
    </style>
</head>
<body>
    <h1>WeasyPrint 示例</h1>
    <p>这是一个简单的HTML转换为PNG的示例。</p>
</body>
</html>
"""

# 渲染为PNG
html = HTML(string=html_content)
html.write_png("output.png")
print("PNG文件生成成功！")

从文件生成PDF

WeasyPrint支持从HTML文件生成PDF文件。

以下是一个示例：

from weasyprint import HTML

# 从文件加载HTML并生成PDF
html = HTML('example.html')
html.write_pdf('output.pdf')
print("PDF文件生成成功！")

高级功能

自定义样式

WeasyPrint支持自定义CSS样式，可以在生成PDF或PNG时应用不同的样式。

以下是一个示例：

from weasyprint import HTML, CSS

# 定义HTML内容
html_content = """
<!DOCTYPE html>
<html>
<head>
    <title>WeasyPrint 示例</title>
</head>
<body>
    <h1>WeasyPrint 示例</h1>
    <p>这是一个自定义样式的示例。</p>
</body>
</html>
"""

# 定义自定义CSS
css_content = """
body { font-family: Arial, sans-serif; }
h1 { color: #007BFF; }
p { font-size: 14px; }
"""

# 渲染为PDF并应用自定义CSS
html = HTML(string=html_content)
css = CSS(string=css_content)
html.write_pdf('output.pdf', stylesheets=[css])
print("应用自定义样式的PDF文件生成成功！")

使用模板引擎

WeasyPrint可以与模板引擎（如Jinja2）结合使用，生成动态内容的PDF。

以下是一个示例：

from jinja2 import Template
from weasyprint import HTML

# 定义模板
template = Template("""
<!DOCTYPE html>
<html>
<head>
    <title>WeasyPrint 示例</title>
    <style>
        body { font-family: Arial, sans-serif; }
        h1 { color: #333; }
    </style>
</head>
<body>
    <h1>{{ title }}</h1>
    <p>{{ content }}</p>
</body>
</html>
""")

# 渲染模板
html_content = template.render(title="WeasyPrint 示例", content="这是一个使用Jinja2模板生成的PDF示例。")

# 渲染为PDF
html = HTML(string=html_content)
html.write_pdf("output.pdf")
print("使用模板引擎生成的PDF文件生成成功！")

使用外部CSS文件

WeasyPrint支持使用外部CSS文件。

以下是一个示例：

from weasyprint import HTML

# 定义HTML内容
html_content = """
<!DOCTYPE html>
<html>
<head>
    <title>WeasyPrint 示例</title>
    <link rel="stylesheet" type="text/css" href="styles.css">
</head>
<body>
    <h1>WeasyPrint 示例</h1>
    <p>这是一个使用外部CSS文件的示例。</p>
</body>
</html>
"""

# 渲染为PDF
html = HTML(string=html_content, base_url='.')
html.write_pdf('output.pdf')
print("使用外部CSS文件的PDF文件生成成功！")

添加页眉和页脚

WeasyPrint支持在生成的PDF中添加页眉和页脚。

以下是一个示例：

from weasyprint import HTML, CSS

# 定义HTML内容
html_content = """
<!DOCTYPE html>
<html>
<head>
    <title>WeasyPrint 示例</title>
</head>
<body>
    <h1>WeasyPrint 示例</h1>
    <p>这是一个添加页眉和页脚的示例。</p>
</body>
</html>
"""

# 定义页眉和页脚的CSS
css_content = """
@page {
    size: A4;
    margin: 1in;
    @top-center {
        content: "页眉示例";
    }
    @bottom-center {
        content: "页脚示例 - 第 " counter(page) " 页";
    }
}
"""

# 渲染为PDF并添加页眉和页脚
html = HTML(string=html_content)
css = CSS(string=css_content)
html.write_pdf('output.pdf', stylesheets=[css])
print("添加页眉和页脚的PDF文件生成成功！")

总结

WeasyPrint库是一个功能强大且易于使用的工具，能够将HTML和CSS渲染为高质量的PDF和PNG文件。通过支持现代HTML和CSS特性、高质量输出、灵活的请求配置和丰富的响应处理方法，WeasyPrint库能够满足各种生成文档和图像的需求。本文详细介绍了WeasyPrint库的安装方法、主要特性、基本和高级功能，以及实际应用场景。希望本文能帮助大家全面掌握WeasyPrint库的使用，并在实际项目中发挥其优势。

如果你觉得文章还不错，请大家点赞、分享、留言下，因为这将是我持续输出更多优质文章的最强动力！

如果想要系统学习Python、Python问题咨询，或者考虑做一些工作以外的副业，都可以扫描二维码添加微信，围观朋友圈一起交流学习。