1. 報告的 PDF 結構
讓我們開始學習如何保存和結構化 PDF，讓你的報告看起來像是專業設計師製作的一樣。
先從基本的開始。如你所知，一份好的報告不僅要包含有用的資訊，還要便於閱讀。這意味著它需要有適當的結構。讓我們來看看如何讓你的報告不僅內容豐富，還能設計得很漂亮。
如何正確組織和結構化 PDF
文件的結構就像是你代碼塊的計畫，只是這裡是文字世界。良好的結構包括：
- 目錄：幫助快速了解文件的內容以及如何找到它。如果你的報告很長，目錄是你最好的朋友。
- 章節與子章節：邏輯順序的資訊可以幫助讀者跟上作者的思路。像生活一樣：先是開頭，然後是高潮，最後是結局。
- 視覺元素：表格、圖表和圖片有時比文字頁還要具表現力。
創建目錄和章節以便於導航
創建目錄和章節是避免你的報告成為一個大文本堆的關鍵。將資訊分成邏輯塊，並記得加上標題。
from PyPDF2 import PdfWriter, PdfReader
# 創建新的 PDF 文件
writer = PdfWriter()
# 添加空白頁面
writer.add_blank_page(width=210, height=297) # 標準 A4 格式
# 保存 PDF 到文件
with open("report.pdf", "wb") as f:
writer.write(f)
2. 生成 PDF 格式的報告
現在我們知道了如何結構化報告，是時候開始創建了。PyPDF2 是你在這項艱巨任務中的朋友。
使用 PyPDF2 從數據生成報告
從數據生成報告不僅僅是複製和貼上。你的文件應該像你的貓一樣充滿活力，當你試圖工作時 PyPDF2 幫助你提取數據，將其添加到文件中，甚至設置其外觀。
import PyPDF2
# 打開現有 PDF
with open('source.pdf', 'rb') as read_file:
reader = PdfReader(read_file)
writer = PdfWriter()
# 將頁面複製到新文件
for page in reader.pages:
writer.add_page(page)
# 添加標題
writer.add_blank_page()
page = writer.pages[-1]
page.content = """你好！這是我的報告！""" # 錯誤!!
# 保存到新文件
with open('structured_report.pdf', 'wb') as write_file:
writer.write(write_file)
可惜這段代碼無法工作。PyPDF2 不支援處理頁面內容，甚至無法添加文本。如果你需要向現有的 PDF 添加文本，可以使用 `ReportLab`。
3. 使用 `ReportLab`
在這個修正版的例子中，使用 PyPDF2 創建 PDF，然後使用 `ReportLab` 添加文本。接著，將結果合併到一個 PDF 文件中。
使用 `ReportLab` 添加文本的修正版代碼
import PyPDF2
from reportlab.pdfgen import canvas
from reportlab.lib.pagesizes import A4
# 使用 ReportLab 創建帶有標題的文件
title_pdf = "title_page.pdf"
c = canvas.Canvas(title_pdf, pagesize=A4)
c.drawString(100, 800, "你好！這是我的報告！")
c.save()
# 創建合併的 PDF
with open("source.pdf", "rb") as source_file, open(title_pdf, "rb") as title_file:
reader_source = PyPDF2.PdfReader(source_file)
reader_title = PyPDF2.PdfReader(title_file)
writer = PyPDF2.PdfWriter()
# 添加標題頁
writer.add_page(reader_title.pages[0])
# 從原文件中復製頁面
for page in reader_source.pages:
writer.add_page(page)
# 保存帶有標題的新 PDF
with open("structured_report.pdf", "wb") as output_file:
writer.write(output_file)
print("報告已成功創建並保存為 'structured_report.pdf'.")
修正說明：
- 創建標題頁：使用 `ReportLab` 創建一個帶有文本 "你好！這是我的報告！" 的 PDF 文件。
- 合併 PDF：使用 `PyPDF2` 添加標題頁和 `source.pdf` 中的其他頁面。
- 保存最終文件：保存合併的 PDF 為 `structured_report.pdf`。
添加標題和章節以提升結構化
現在我們已經有了文件的基礎，添加一些結構吧。標題和副標題可以幫助你在資訊的森林中不迷路。PyPDF2 可以插入頁面，但如果你需要更高級的功能，例如字體設置，建議考慮使用 ReportLab。
from reportlab.lib.pagesizes import letter
from reportlab.pdfgen import canvas
def create_pdf(filename):
# 創建 PDF 畫布
c = canvas.Canvas(filename, pagesize=letter)
text = c.beginText(40, 750)
# 標題
text.setFont("Helvetica-Bold", 18)
text.textLine("專案報告 '超級秘密'")
# 副標題
text.setFont("Helvetica", 14)
text.textLine("章節:")
text.textLine("1. 簡介")
text.textLine("2. 數據分析")
text.textLine("3. 結論")
c.drawText(text)
c.save()
create_pdf("detailed_report.pdf")
錯誤和陷阱
如同任何程式設計，在處理 PDF 文件時也有自己的陷阱。主要的頭痛來源之一是正確使用頁面索引。在 PyPDF2 中，就像在 Python 中一樣，頁面索引從零開始。請注意，避免意外添加錯誤的頁面到你的報告。
另一個可能造成問題的方面是文本編碼錯誤。PDF 文件的文本可能以不同的格式編碼。確保你的代碼能正確處理這些符號，特別是如果你的報告將用於多種語言。
GO TO FULL VERSION