使用WeasyPrint inside docker (FastAPI)导出的PDF中的字体

WeasyPrint 是一个用于将 HTML 转换为 PDF 的 Python 库，它依赖于 WebKit 渲染引擎。在使用 WeasyPrint 在 Docker 容器中通过 FastAPI 导出 PDF 时，可能会遇到字体问题，因为容器内部可能没有安装所需的字体，或者字体路径没有被正确配置。

基础概念

WeasyPrint: 一个 Python 库，用于将 HTML 和 CSS 转换为 PDF 文档。
Docker: 一种容器化平台，用于自动化应用程序的部署。
FastAPI: 一个现代、快速（高性能）的 web 框架，用于构建 API。

类型与应用场景

类型: WeasyPrint 主要用于 HTML 到 PDF 的转换。
应用场景: 报告生成、电子发票、合同文档等需要将网页内容转换为 PDF 的场合。

遇到的问题及原因

在使用 WeasyPrint 时，可能会遇到字体缺失的问题，这通常是因为 Docker 容器内部没有安装相应的字体，或者 WeasyPrint 无法找到这些字体文件。

解决方法

安装字体: 在 Dockerfile 中安装所需的字体。例如，如果你需要 Arial 字体，可以在 Dockerfile 中添加以下命令：
安装字体: 在 Dockerfile 中安装所需的字体。例如，如果你需要 Arial 字体，可以在 Dockerfile 中添加以下命令：
复制字体到容器: 将所需的字体文件复制到 Docker 容器中的适当位置。例如：
复制字体到容器: 将所需的字体文件复制到 Docker 容器中的适当位置。例如：
配置 WeasyPrint 字体路径: 在代码中指定字体路径，确保 WeasyPrint 能够找到并使用这些字体。例如：
配置 WeasyPrint 字体路径: 在代码中指定字体路径，确保 WeasyPrint 能够找到并使用这些字体。例如：

示例代码

以下是一个完整的 FastAPI 应用示例，它使用 WeasyPrint 在 Docker 容器中导出 PDF，并确保字体正确加载：

from fastapi import FastAPI
from weasyprint import HTML, CSS
import os

app = FastAPI()

@app.get("/export-pdf")
async def export_pdf():
    css = CSS(string='''
        @font-face {
            font-family: 'MyFont';
            src: url('/usr/share/fonts/truetype/my_fonts/MyFont.ttf');
        }
        body {
            font-family: 'MyFont', sans-serif;
        }
    ''')

    html_content = '''
    <html>
    <head><title>Sample PDF</title></head>
    <body>
        <h1>Hello, World!</h1>
        <p>This is a sample PDF generated with WeasyPrint.</p>
    </body>
    </html>
    '''

    HTML(string=html_content).write_pdf('output.pdf', stylesheets=[css])
    
    # Return the PDF file as a response
    return FileResponse('output.pdf', media_type='application/pdf')

确保在 Dockerfile 中安装了字体，并且字体文件路径正确无误。

通过以上步骤，你应该能够在 Docker 容器中使用 WeasyPrint 导出包含自定义字体的 PDF 文件。