WeasyPrint 技术文档

1. 安装指南

1.1 系统要求

WeasyPrint 支持 Python 3.9 及以上版本，建议使用 CPython 或 PyPy 解释器。

1.2 安装步骤

1. 使用 pip 安装：

   pip install WeasyPrint
   

2. 使用 Conda 安装：

   conda install -c conda-forge weasyprint
   

3. 手动安装：

   • 下载源码包并解压。
   • 进入解压后的目录，运行以下命令：

     python setup.py install
     

1.3 依赖库

WeasyPrint 依赖于以下库：

• Cairo
• Pango
• GDK-Pixbuf
• cairocffi
• cssselect2
• html5lib
• tinycss2

确保这些依赖库已正确安装。

2. 项目使用说明

2.1 基本用法

WeasyPrint 可以将 HTML 和 CSS 文件转换为 PDF 文档。以下是一个简单的示例：

from weasyprint import HTML

# 将 HTML 文件转换为 PDF
HTML('input.html').write_pdf('output.pdf')

2.2 高级用法

WeasyPrint 支持自定义样式、分页、页眉页脚等功能。可以通过 CSS 文件或内联样式来实现。

from weasyprint import HTML, CSS

# 加载 HTML 和 CSS 文件
html = HTML('input.html')
css = CSS('style.css')

# 将 HTML 和 CSS 转换为 PDF
html.write_pdf('output.pdf', stylesheets=[css])

3. 项目 API 使用文档

3.1 HTML 类

• HTML(url_or_file)：加载 HTML 文件或 URL。
• render(stylesheets=None)：渲染 HTML 为文档对象。
• write_pdf(target=None, stylesheets=None)：将 HTML 渲染为 PDF 文件。

3.2 CSS 类

• CSS(url_or_file)：加载 CSS 文件或 URL。

3.3 Document 类

• copy()：复制文档对象。
• fonts：获取文档中的字体信息。
• make_bookmark_tree()：生成书签树。
• metadata：获取文档元数据。
• pages：获取文档的页面列表。
• url_fetcher：设置 URL 获取器。
• write_pdf(target=None)：将文档写入 PDF 文件。

4. 项目安装方式

4.1 通过 pip 安装

pip install WeasyPrint

4.2 通过 Conda 安装

conda install -c conda-forge weasyprint

4.3 手动安装

1. 下载源码包并解压。
2. 进入解压后的目录，运行以下命令：

   python setup.py install
   

通过以上步骤，您可以顺利安装并使用 WeasyPrint 项目，将其应用于 HTML 到 PDF 的转换任务中。