4teamwork/pdflatex

pdflatex

概述

pdflatex是一个Docker化的Web服务，用于从LaTeX文件生成PDF。它基于TeXLive发行版实现PDF创建功能，通过Python的aiohttp Web服务器构建，暴露HTTP端点以接收上传的.tex主文件及其他必要的附加文件。

核心功能与特性

• PDF生成能力：使用TeXLive发行版提供专业的LaTeX到PDF转换支持
• 文件上传支持：通过HTTP端点接收multipart/form-data格式的文件上传，包括主.tex文件和附加资源
• 轻量级Web服务：基于aiohttp框架构建，高效处理文件上传请求
• 多文件支持：允许上传主.tex文件及附加文件（如图像、样式文件等）

使用场景

适用于需要通过Web服务自动化将LaTeX文档转换为PDF的场景，例如：

• 学术写作中快速生成包含图片等资源的PDF文档
• 技术文档系统集成，实现LaTeX源文件到PDF的自动转换
• 开发者工具链中，作为LaTeX编译的服务化组件

使用方法

启动服务

通过docker-compose启动Web服务：

bash
docker-compose up

服务启动后默认监听本地3000端口。

上传文件生成PDF

需通过multipart/form-data格式上传文件，具体要求：

• 主LaTeX文件（.tex）必须在名为latex的表单部分中上传
• 附加文件（如图像、样式文件等）需在名称以file.为前缀的表单部分中上传（例如file.image表示图片文件）

示例：使用curl上传文件

以下命令上传主文件tests/image.tex和附加图片tests/image.jpg，并将生成的PDF保存为image.pdf：

bash
curl -F "latex=@tests/image.tex" -F "file.image=@tests/image.jpg" http://localhost:3000 -o image.pdf

测试

环境要求

执行测试需满足：

• Python 3.8环境
• 安装pytest和requests库

测试环境准备

1. 创建并激活虚拟环境：

   bash
   python3.8 -m venv venv
   ./venv bin/activate
   

2. 安装依赖：

   bash
   pip install pytest requests
   

运行测试

在激活虚拟环境后，通过pytest执行测试：

bash
pytest