这个工具是一个用于将多种文件格式(如 PDF、Word、Excel、PPT 等)转换为长图片的工具。通过该工具,你可以上传一个文件,工具会自动将其转换为 PDF 并生成一张合并后的长图。这个项目使用 Streamlit 作为前端展示界面,使用 pdf2image 进行 PDF 到图片的转换,并使用 Pillow 来处理图片的合并。
- 支持多种文件格式:PDF、Word、Excel、PPT 等。
- 将文件转换为 PDF 并自动转换为图片。
- 合并多张图片为长图,便于查看和分享。
- 可设置图片的 DPI(PPI)以调整输出图片的质量。
要运行此项目,请确保已安装以下依赖:
- Streamlit:用于构建交互式 Web 应用程序。
- pdf2image:将 PDF 转换为图像的库。
- Pillow:图像处理库。
- poppler-utils:用于支持 PDF 转换的工具。
-
克隆项目到本地:
git clone https://github.com/你的用户名/文件转长图工具.git cd 文件转长图工具 -
安装所需的 Python 库:
pip install -r requirements.txt
-
安装 Poppler:
- Windows: 下载 Poppler for Windows,并将其路径添加到系统环境变量,或者在
config.py中设置POPPLER_PATH。 - macOS: 使用 Homebrew 安装:
并在
brew install poppler
config.py中设置POPPLER_PATH,如/usr/local/bin。 - Linux: 使用包管理器安装(以 Ubuntu 为例):
并在
sudo apt-get install poppler-utils
config.py中设置POPPLER_PATH,如/usr/bin。
- Windows: 下载 Poppler for Windows,并将其路径添加到系统环境变量,或者在
-
安装 LibreOffice(如果需要转换非 PDF 文件,如 Word、Excel、PPT):
- Windows: 下载并安装 LibreOffice,并在
config.py中设置LIBREOFFICE_PATH。 - Linux/ macOS:
并在
sudo apt install libreoffice
config.py中设置LIBREOFFICE_PATH,如/usr/bin/libreoffice。
- Windows: 下载并安装 LibreOffice,并在
-
配置文件
- 编辑
config.py文件,设置以下参数:OUTPUT_DIR: 输出目录的路径。POPPLER_PATH: Poppler 的安装路径。LIBREOFFICE_PATH: LibreOffice 的安装路径。
- 编辑
-
在项目目录下运行以下命令启动应用:
streamlit run main.py
-
打开浏览器并访问
http://localhost:8501,即可看到应用界面。 -
上传需要转换的文件,并设置图片 DPI。等待文件转换完成后,页面将展示合并后的长图。
main.py: 主程序文件,处理文件上传、格式转换和图像合并等功能。requirements.txt: 项目所需的依赖库清单。config.py: 配置文件,包含所有的目录配置。run_app.py: 运行此py文件可直接运行程序TKGUI.py: 使用tkinter重新构建的程序,不通过网页运行,更方便打包和本地使用。
- 系统支持:目前仅在windows下进行过测试,其他系统环境可能需要自行适配
- 文件大小:请注意上传文件的大小,因为转换和合并较大的文件可能会耗费较长时间。
- 格式支持:该工具依赖 LibreOffice 进行非 PDF 文件的转换,因此确保安装了正确版本的 LibreOffice。
- 图片质量:通过调整 DPI 来控制输出图片的质量,DPI 越高,图片越清晰,但文件大小也会增大。
该项目基于 MIT 开源许可进行分发。详情请查看 LICENSE。