Skip to content
flitwangPublic

About

a simple tool to merge and/or split .pdf files (vibe coding with Gemini Pro)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 

Repository files navigation

PDF 合併與分割工具 (PDF Tool)

這是一個輕量、離線且開源的 PDF 處理小工具。支援「拖曳上傳」、「拖曳排序」、「自訂頁碼分割」及「低解析度縮圖預覽」等功能。

系統需求

  • 作業系統:Windows / macOS / Linux
  • 環境需求:需安裝 Python 3.8 或更新版本。

步驟 1:安裝必要的 Python 套件

本程式依賴幾個國際開源套件來處理介面與 PDF 解析。請開啟你的終端機 (Terminal) 或 命令提示字元 (cmd),並輸入以下指令安裝套件:

pip install tkinterdnd2 PyMuPDF Pillow

如果直接呼叫 pip 系統不認識,我們可以改為「請 python 幫我們呼叫 pip」。 請在你的終端機(或命令提示字元)中,將原本的指令替換成下面這行,然後按 Enter:

python -m pip install tkinterdnd2 PyMuPDF Pillow

如果系統顯示 'python' 不是內部或外部命令...,請改試試這行(Windows 專用的啟動器指令):

py -m pip install tkinterdnd2 PyMuPDF Pillow

如果這招成功開始跑安裝進度條,恭喜你,問題已經解決了!下次要安裝任何套件,只要在前面加上 python -m 即可。

  • 套件說明 (皆無中資背景):

    • tkinterdnd2 :讓 Python 內建介面支援滑鼠拖曳檔案 (Drag & Drop) 的開源庫。

    • PyMuPDF (安裝名稱,程式內匯入為 fitz):由 Artifex Software 開發的極速 PDF 解析與渲染引擎。

    • Pillow:Python 著名的影像處理開源函式庫,負責處理縮圖顯示。

步驟 2:執行程式

確保你已經將上方的程式碼存成名為 pdf_tool.py 的檔案。接著在終端機中,切換到該檔案所在的資料夾,然後輸入:

python pdf_tool.py

步驟 3:使用指南

  1. 首頁:將要處理的 PDF 檔案直接拖曳進大方框中。接著勾選你需要的功能(合併、分割),按下「下一步」。

  2. 介面 1 (合併排序):若有勾選合併,可以在此清單中按住檔案名稱「上下拖曳」來調整合併順序。

  3. 介面 2 (分割與頁數設定):

  • 畫面會顯示每一頁的縮圖,你可以直接點擊縮圖並拖曳到另一個縮圖上來交換它們的位置。

  • 下方可以輸入你要匯出的頁碼。格式支援單頁 (2)、連續頁 (5-8) 以及不連續頁的組合 (1,3,5-8)。

  • 點擊 + 增加一行匯出 可以一次產出多個不同的 PDF 檔案。

  1. 匯出:點擊匯出並選擇目標資料夾後,程式會自動依照你的設定產出檔案。
這個版本直接將防呆機制(錯誤時彈出警告且保留輸入框內容供修改)與進度條讀取都實作進去了。如果你在執行測試時有任何想要微調的地方,隨時告訴我!

About

a simple tool to merge and/or split .pdf files (vibe coding with Gemini Pro)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages