# xpdf

**Repository Path**: geyouwen/xpdf

## Basic Information

- **Project Name**: xpdf
- **Description**: 一个将url、html、excel转pdf的服务，另包含在pdf上添加图片的功能, 利用mkhtmltopdf实现。
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-04-19
- **Last Updated**: 2024-05-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: mkhtmltopdf, excel转pdf, url转pdf, html转PDF

## README

### 简介
    一个提供excel转pdf，url转pdf、html转pdf的简单服务，另外包含在pdf上添加图片的功能。
### 依赖
    需要现在服务器上安装 wkhtmltopdf、中文字体

#### Centos中文字体安装
    yum -y install fontconfig

    mkdir /usr/share/fonts/chinese

    # Windows中存在部分字体库可直接复制到/usr/share/fonts/chinese中

### 安装依赖
    pip install -r requirements.txt

### 体验地址
<http://115.159.31.107:6200/>

### 功能介绍
    excel转pdf
    1、[POST] /excel2pdf 
    参数：
        file //上传的excel文件

    html转pdf
    2、[POST] /str2pdf 
    参数：
        str_content
    
    url转pdf
    3、[POST] /url2pdf 
    参数：
        url

    添加图片
    4、[POST] /add/images 
    参数：
        file //上传的pdf文件
        image_list[0][path] //要添加的网络图片路径
        image_list[0][x] // 定位x轴信息
        image_list[0][y] // 定位y轴信息
        image_list[0][w] //图片宽
        image_list[0][h] //图片高
        image_list[0][rotate] //图片旋转角度 0 - 360
        image_list[0][transpose] //图片反转方向 FLIP_TOP_BOTTOM 、 FLIP_LEFT_RIGHT
        image_list[0][page] //要插入图片的pdf页码

    下载文件
    5、[POST] /download
    参数：
        file_id

    多个html转pdf合并成一个pdf文件
    6、[POST] /multi/str2pdf
    参数：
        str_list 列表
    
    根据文本位置添加图片
    7、[POST] /add/imagesbytext 
    参数：
        file //上传的pdf文件
        image_list[0][path] //要添加的网络图片路径
        image_list[0][x] // x轴信息（偏移量）防止因搜索到的文本位置不精确，人工介入加入纠正偏移量
        image_list[0][y] // y轴信息（偏移量）防止因搜索到的文本位置不精确，人工介入加入纠正偏移量
        image_list[0][w] //图片宽
        image_list[0][h] //图片高
        image_list[0][rotate] //图片旋转角度 0 - 360
        image_list[0][transpose] //图片反转方向 FLIP_TOP_BOTTOM 、 FLIP_LEFT_RIGHT
        image_list[0][page] //要插入图片的pdf页码
        image_list[0][text] //要搜索的文本
        image_list[0][text_idx] //防止一页中存在多个要搜索的文本，需要指定文本索引位置，起始位置（默认）是0

#### 常见问题
    1、html转pdf需要保证网页内的静态资源可访问，图片可以用网络地址或者base64编码数据代替
    2、js渲染的网页目前无法保存pdf
    3、url转pdf少数网页无法保证样式一摸一样,如需精确样式，建议生成本地html，