【Python】フレームによる段組みレイアウト

ReportLabを使用すると、Pythonを使用してPDFにテキストを挿入することができます。

本記事では、ReportLabによる、フレームを使用した段組みレイアウトの表現方法について、詳しくご説明します。

こんな人に読んでほしい

Pythonを使用したPDFの操作方法を知りたい人
フレームを使用した段組みレイアウトの表現方法を知りたい人

ReportLabとは
ReportLabのインストール
フレームを使用した段組みレイアウトの表現
まとめ
参考
1. Python学習用おすすめ教材
2. おすすめプログラミングスクール

ReportLabとは

ReportLabは、Pythonを使用してPDFを操作するための外部ライブラリの１つです。

PDF操作用ライブラリは他にも、PyPDF4やPDFMinerなどいくつか存在します。

それぞれのライブラリの用途は、以下の通りです。

ライブラリ	用途
ReportLab	・PDFの新規作成
PDFMiner	・テキストの抽出
PyPDF4	・画像の抽出・PDFファイルの結合や分割・しおり（目次）の追加

本記事では、ReportLabによる、フレームを使用した段組みレイアウトの表現方法をご紹介します。

ReportLabのインストール

「ReportLab」は、以下コマンドを入力することで、インストールすることができます。

コマンドの入力は、コマンドプロンプトあるいはターミナルから行います。

pip install reportlab

動作確認として、試しに以下を入力します。

from reportlab.pdfgen import canvas

上記を入力してもエラーが発生しなければ、正常にインストールされています。

フレームを使用した段組みレイアウトの表現

「reportlab.platypus」クラスのSimpleDocTemplate()で用意したPDFに対して、Paragraph()を使用することで、テキストボックス（段落）を指定することができます。

Paragraph()は、第一引数にテキスト（文章）を、第二引数にスタイル（テキストボックスの書式設定）をそれぞれ指定します。

「reportlab.platypus.frames」クラスのFrame()を指定することで、フレームレイアウトを表現することができます。

Frame()は、第一引数にフレームのx座標（左）、第二引数にフレームのy座標（下）、第三引数にフレームの幅、第四引数にフレームの高さをそれぞれ指定します。

以下に例をご紹介します。

#input
from reportlab.pdfgen import canvas
from reportlab.lib.pagesizes import A4, portrait, landscape
from reportlab.pdfbase import pdfmetrics
from reportlab.pdfbase.cidfonts import UnicodeCIDFont
from reportlab.lib.units import mm
import os
from reportlab.platypus import Paragraph, Spacer, PageBreak, FrameBreak, SimpleDocTemplate, ListFlowable, ListItem, PageTemplate
from reportlab.lib.styles import ParagraphStyle, ParagraphStyle
from reportlab.lib.styles import getSampleStyleSheet
from reportlab.platypus.frames import Frame

# A4（横）の新規PDFファイルを作成
p = SimpleDocTemplate("sample.pdf", pagesize=landscape(A4))

# Frame(x1, y1, width, height)
frames=[Frame( 30*mm, 120*mm, 110*mm, 60*mm, showBoundary=1),
        Frame(160*mm, 120*mm, 110*mm, 60*mm, showBoundary=1),
        Frame( 30*mm,  30*mm, 110*mm, 60*mm, showBoundary=1),
        Frame(160*mm,  30*mm, 110*mm, 60*mm, showBoundary=1)]

page_template = PageTemplate("frames", frames=frames)
p.addPageTemplates(page_template)

style_dict ={"name":"normal",
            "fontName":"Times-Bold",
            "fontSize":12*mm,
            "leading":12*mm,
            "firstLineIndent":12*mm}
style      = ParagraphStyle(**style_dict)

flowables = []

space = Spacer(10*mm, 10*mm)

# 第１パラグラフ
para = Paragraph("<span backcolor=yellow>Let it be</span>", style)
flowables.append(para)

# フレームブレイク
flowables.append(FrameBreak())

# 第２パラグラフ
text  = "When I find myself in times of trouble "
text += "Mother Mary comes to me "
text += "Speaking words of wisdom "
text += "Let it be "
text += "And in my hour of darkness "
text += "She is standing right in front of me "
text += "Speaking words of wisdom "
text += "Let it be"

para = Paragraph(text, style)
flowables.append(para)

p.multiBuild(flowables)

FrameBreak()により、２つ目のパラグラフから次のフレームに移動しています。

また２つ目のパラグラフについては、指定フレームからはみ出したテキストが自動的に次のフレームに移動しています。

まとめ

この記事では、ReportLabによる、フレームを使用した段組みレイアウトの表現方法について、ご説明しました。

本記事を参考に、ぜひ試してみて下さい。

【Python】フレームによる段組みレイアウト｜ReportLab基礎

ReportLabとは

ReportLabのインストール

フレームを使用した段組みレイアウトの表現

まとめ

参考

Python学習用おすすめ教材

Pythonの基本を学びたい方向け

統計学基礎を学びたい方向け

Pythonの統計解析を学びたい方向け

おすすめプログラミングスクール