1. PDFにテキストとヘッダーを追加する基本
ReportLabでは、canvasオブジェクトを使用してテキストを追加するよ。これを使えば、フォント、色、サイズ、テキストの位置を設定できる。
ヘッダーとテキストを含むシンプルなPDFを作成する
from reportlab.pdfgen import canvas
from reportlab.lib.pagesizes import A4
# 新しいPDFを作成
pdf_file = canvas.Canvas("styled_text.pdf", pagesize=A4)
width, height = A4
# ヘッダーを追加
pdf_file.setFont("Helvetica-Bold", 20)
pdf_file.drawString(100, height - 100, "売上レポート")
# メインテキストを追加
pdf_file.setFont("Helvetica", 12)
pdf_file.drawString(100, height - 130, "この文書には最新の四半期の売上情報が含まれています。")
# PDFを保存
pdf_file.save()
このコードは、ヘッダーとメインテキストが含まれたPDFを生成するよ。setFont()メソッドを使って、フォントとテキストサイズを設定してる。
2. テキストのスタイリングとフォーマット
ReportLabでは、色、フォント、テキストサイズをカスタマイズできる!おしゃれなヘッダーや内容が作れるから、文書を読みやすく構造化できるよ。
フォントとテキストサイズを変更する
ReportLabは、Helvetica、Times-Roman、Courierのような標準フォントをサポートしてるよ。setFont()を使って、フォントスタイル(ノーマル、ボールド、イタリック)やサイズも指定できる!
pdf_file.setFont("Helvetica-Bold", 18) # ボールドフォントのヘッダー
pdf_file.drawString(100, height - 50, "メインヘッダー")
pdf_file.setFont("Helvetica-Oblique", 14) # イタリックなサブヘッダー
pdf_file.drawString(100, height - 80, "サブヘッダー: 四半期の概要")
テキストの色を変更する
setFillColorRGB()メソッドを使えば、RGB値(0から1の範囲)でテキストの色を調整できる!
pdf_file.setFillColorRGB(0.2, 0.4, 0.6) # 青色
pdf_file.setFont("Helvetica", 12)
pdf_file.drawString(100, height - 110, "このテキストは青色です。")
reportlab.lib.colorsのプリセット色も使えるよ!
from reportlab.lib import colors
pdf_file.setFillColor(colors.red)
pdf_file.drawString(100, height - 140, "赤色のテキスト")
3. テキストの配置と複数行テキスト
テキストが長い場合は、複数行で表示した方がいいね。ReportLabには、TextObjectクラスがあって、自動で改行してくれる。
TextObjectを使った複数行テキスト
text = """
レポートには、過去3か月の売上分析が含まれています。
変更点と、それが会社全体の成長に与える影響を検討しています。
"""
text_object = pdf_file.beginText(100, height - 180)
text_object.setFont("Helvetica", 12)
text_object.setFillColor(colors.darkblue)
for line in text.split("\n"):
text_object.textLine(line)
pdf_file.drawText(text_object)
このコードは、複数行のテキストブロックを作成する例だよ。各行がPDFに追加される。TextObjectを使うと長いテキストの自動フォーマットが簡単!
4. 段落を使ったテキストのスタイリング
reportlab.platypusモジュールのParagraphクラスを使えば、HTMLタグ(例:<b>、<i>、<u>)に対応したスタイリングテキストを追加できる!段落のスタイリングや余白も簡単にできちゃう。
Paragraphを使った段落作成
from reportlab.lib.pagesizes import A4
from reportlab.lib.styles import getSampleStyleSheet
from reportlab.platypus import SimpleDocTemplate, Paragraph
# PDFの設定
doc = SimpleDocTemplate("styled_paragraphs.pdf", pagesize=A4)
styles = getSampleStyleSheet()
elements = []
# ボールドとイタリックなテキストの段落を作成
text = "<b>売上レポート</b><br><i>2023年の四半期レポート</i>"
paragraph = Paragraph(text, styles["Title"])
elements.append(paragraph)
# メインテキストの追加
main_text = """
このレポートには、最新の四半期における売上データの要点が含まれています。
また、売上が会社全体の収益に与える影響の分析も行っています。
"""
paragraph = Paragraph(main_text, styles["BodyText"])
elements.append(paragraph)
# PDFを生成
doc.build(elements)
ここでは、Paragraphを使ってフォーマット済みテキストを追加してるよ。HTMLタグを使ったスタイリング(ボールドとかイタリック)が便利。getSampleStyleSheet()でベーススタイルを取得してカスタマイズ可能。
5. テキストスタイルの適用
ReportLabでは、テキストの書式に使う独自のスタイルを作って設定できるよ。見出し・小見出し・本文で同じスタイルを繰り返し使うレポートを作るときに、とくに便利なんだ。
ユーザー定義スタイルの設定
from reportlab.lib.pagesizes import A4
from reportlab.lib.styles import ParagraphStyle
from reportlab.platypus import SimpleDocTemplate, Paragraph
# PDFの設定
doc = SimpleDocTemplate("custom_styles.pdf", pagesize=A4)
elements = []
# ユーザー定義スタイルの作成
custom_style = ParagraphStyle(
name="CustomStyle",
fontName="Helvetica-Bold",
fontSize=14,
leading=18,
textColor=colors.darkgreen,
spaceAfter=10,
)
# ユーザー定義スタイルを使った段落の作成
paragraph = Paragraph("これはユーザー定義スタイルを使った見出しです", custom_style)
elements.append(paragraph)
# 本文の追加
default_style = ParagraphStyle(
name="Default",
fontName="Helvetica",
fontSize=12,
leading=14,
textColor=colors.black,
spaceAfter=10,
)
paragraph = Paragraph("これは標準スタイルを使った本文です。", default_style)
elements.append(paragraph)
# PDFを生成
doc.build(elements)
この例では、文字色が緑でフォントサイズが大きいCustomStyleというユーザー定義スタイルを作り、それを見出しに適用しているよ。
6. 見出しとテキストを持つ文書の作成
PDF文書をもっと構造的にしたいなら、セクションごとに見出しとスタイル付きの本文を持つ、複数ページのレポートを作ればいい。
構造化された複数ページレポートの作成
from reportlab.lib.pagesizes import A4
from reportlab.lib.styles import getSampleStyleSheet, ParagraphStyle
from reportlab.platypus import SimpleDocTemplate, Paragraph, PageBreak
# PDFの設定
doc = SimpleDocTemplate("structured_report.pdf", pagesize=A4)
styles = getSampleStyleSheet()
elements = []
# 見出し用のスタイル
title_style = ParagraphStyle("TitleStyle", parent=styles["Title"], fontSize=18, spaceAfter=12)
# 1ページ目の見出し
title = Paragraph("2023年の売上レポート", title_style)
elements.append(title)
# 本文
main_text = """
このレポートは、2023年第1四半期における当社の売上について詳しくまとめたものです。
地域別・商品カテゴリ別のデータと、主要な指標を収録しています。
"""
elements.append(Paragraph(main_text, styles["BodyText"]))
# 改ページ
elements.append(PageBreak())
# 2ページ目の見出し
subtitle = Paragraph("カテゴリ別の売上分析", title_style)
elements.append(subtitle)
# 2ページ目の本文
category_text = """
2ページ目では、商品カテゴリ別の売上データを掲載しています。
各カテゴリについて、売上の推移と市場の変化を踏まえて分析しました。
"""
elements.append(Paragraph(category_text, styles["BodyText"]))
7. テキスト書式の細かいところ
フォントとサイズの選び方
PDFの世界は、無個性な書類を作るだけの場所じゃなくて、テキストで自分らしさを表現できる場所でもある。ただ、reportlabはフォントやスタイルの設定オプションをたくさん持っている一方で、いくつか制限があることも覚えておこう。たとえば、ライセンスされたコピーを持っていないフォントは使えないことがある。
フォントの設定にはsetFontメソッドを使った。これはフォント名とサイズを受け取る:
c.setFont("Times-Roman", 12)
見出しのスタイリング
見出しを目立たせたくなることもあるよね。フォントサイズを大きくしたり、太字にしたりすればいい。見出しにHelvetica-Boldを使ったのを思い出してみて。
テキストの配置
reportlabではテキストは既定で左揃えになるけど、テキストの幅を計算して中央に置くメソッドを使えば変更できる。ページ上でもっと凝った文字組みをしたいときに役立つよ。
8. 実際の使いどころ
PDFにテキストや見出しを追加することが役に立つ場面を、いくつか挙げてみよう:
- レポートの自動生成。 データ分析から取り出した内容を動的なテキストとして差し込んだレポートを作れる。
- 目次付きの文書。 見出しと小見出しを入れておくと、とくに大きな文書で読み進めるのが楽になる。
- 個別化された文書。 参加者ごとの証明書や招待状のように、一人ひとり違う書類を作る必要があるプロジェクトでは、PDFのテキスト自動化がとても役に立つ。
よくある失敗
PDFを作っていると、うまくいかないことがある。よくあるのは、対応していないフォントを使ってしまうことや、ページサイズを考慮しなかったせいでテキストの位置がずれることだ。いくつかの例でスクリプトを試して、どのプラットフォームや端末でもテキストが正しく出ることを確かめておこう。
もっと詳しい情報や複雑な例については、ReportLabのドキュメントとPyPDF2のGitHubを見てみて。使い方の例やコツがたくさん載っているよ。
GO TO FULL VERSION