チュートリアル

簡単にライブラリーを使用するためのチュートリアルコレクション

チュートリアル».NET»Spire.PDF for .NET»文書操作»C#/VB.NET:PDF ファイルを圧縮する方法
2026-11-19

Python で既存の PDF にヘッダーとフッターを追加する方法

報告書や業務資料の各ページに文書名やロゴを表示すると、印刷後にページが分かれても資料を識別しやすくなります。また、ページ下部に「1 / 10」のようなページ番号を付ければ、読む順序や全体の分量も確認できます。

この記事では、Spire.PDF for Python を使用して、既存の PDF にヘッダーとフッターを追加する方法を紹介します。ヘッダーには日本語のタイトルとロゴ、区切り線を配置し、フッターには現在のページ番号と総ページ数を表示します。

目次:

1. ライブラリとサンプルファイルの準備

次のコマンドを実行して、Spire.PDF for Python をインストールします。

pip install Spire.PDF

または、Spire.PDF for Python のダウンロードページ から手動でライブラリをインストールすることもできます。

実行する Python スクリプトと同じフォルダーに、次のファイルを用意してください。

  • Input.pdf:上下に余白があるPDF文書
  • Logo.png:ヘッダーに配置する横長のロゴ画像

日本語の描画には、PdfCjkStandardFont を使用します。以下の例では、日本語のゴシック体に対応する PdfCjkFontFamily.HeiseiKakuGothicW5 を指定します。

2. 追加位置を決めるための座標の考え方

既存の PDF に文字や画像を描画するときは、配置位置を座標で指定します。この記事で使用する描画 API では、ページの左上を基準に、X 座標は右方向、Y 座標は下方向に増加します。

座標や描画サイズにはポイントを使用します。72 ポイントが1インチに相当するため、36 ポイントは約 12.7 mmです。

例えば、(36, 24) は左端から 36 ポイント、上端から 24 ポイントの位置です。ページ下部の位置は、ページの高さから一定の値を引いて求めます。

なお、以下の処理は既存ページに要素を描き足すものです。本文を自動で縮小したり、ヘッダー用の余白を新しく確保したりする処理は含みません。入力 PDF の余白に合わせて座標を調整してください。

3. PDF にタイトルとロゴのヘッダーを追加する

最初の例では、各ページの左上に「月次業務レポート」、右上にロゴ画像を配置し、その下に横線を引きます。

ロゴの表示幅を固定し、元画像の縦横比から高さを計算します。画像サイズを明示することで、画像ファイルのピクセル数に左右されずに配置できます。

from spire.pdf import *
from spire.pdf.common import *

# 入出力ファイル
input_path = "Input.pdf"
output_path = "WithHeader.pdf"
logo_path = "Logo.png"

# ヘッダーの設定(単位:ポイント)
header_text = "月次業務レポート"
side_margin = 54.0
text_y = 32.0
logo_y = 18.0
logo_width = 130.0

# PDF を読み込む
document = PdfDocument()
document.LoadFromFile(input_path)

# 描画に使用するフォント、ブラシ、ペンを作成する
header_font = PdfCjkStandardFont(
    PdfCjkFontFamily.HeiseiKakuGothicW5, 14.0
)
header_brush = PdfBrushes.get_DarkBlue()
line_pen = PdfPen(PdfBrushes.get_Black(), 0.5)

# ロゴの縦横比を維持して表示サイズを計算する
logo = PdfImage.FromFile(logo_path)
logo_height = logo_width * logo.Height / logo.Width
line_y = max(54.0, logo_y + logo_height + 8.0)

# 全ページにヘッダーを描画する
for page_index in range(document.Pages.Count):
    page = document.Pages[page_index]
    page_width = page.ActualSize.Width

    page.Canvas.DrawString(
        header_text, header_font, header_brush,
        side_margin, text_y
    )

    page.Canvas.DrawImage(
        logo,
        page_width - side_margin - logo_width,
        logo_y,
        logo_width,
        logo_height
    )

    page.Canvas.DrawLine(
        line_pen,
        side_margin, line_y,
        page_width - side_margin, line_y
    )

# 別のPDFとして保存する
document.SaveToFile(output_path)
document.Dispose()

コードのポイント

DrawString() でタイトル、DrawImage() でロゴ、DrawLine() で区切り線を描画しています。ページ幅をループ内で取得し、ロゴのX座標を計算することで、各ページの右端を基準に配置します。

タイトルを長くする場合は、ロゴと重ならないように文字サイズや表示内容を調整します。縦長のロゴを使用する場合も、ヘッダーが本文に重ならないかを確認してください。

タイトル、ロゴ、区切り線を追加した  PDF の上部

4. PDF に「現在のページ番号 / 総ページ数」のフッターを追加する

次の例では、各ページの下部に区切り線と「1 / 10」形式のページ番号を追加します。

現在のページ番号には PdfPageNumberField 、総ページ数には PdfPageCountField を使用します。これらを PdfCompositeField で組み合わせると、ページごとに表示が変わる文字列を作成できます。

from spire.pdf import *
from spire.pdf.common import *

# 入出力ファイル
input_path = "Input.pdf"
output_path = "WithFooter.pdf"

# フッターの設定(単位:ポイント)
side_margin = 54.0
line_bottom_offset = 48.0
text_bottom_offset = 38.0

# PDF を読み込む
document = PdfDocument()
document.LoadFromFile(input_path)

# 描画に使用するフォント、ブラシ、ペンを作成する
footer_font = PdfCjkStandardFont(
    PdfCjkFontFamily.HeiseiKakuGothicW5, 14.0
)
footer_brush = PdfBrushes.get_Black()
line_pen = PdfPen(footer_brush, 0.5)

# 現在のページ番号と総ページ数を組み合わせる
page_number = PdfPageNumberField()
page_count = PdfPageCountField()
footer_field = PdfCompositeField(
    footer_font, footer_brush,
    "{0} / {1}",
    [page_number, page_count]
)

# 全ページにフッターを描画する
for page_index in range(document.Pages.Count):
    page = document.Pages[page_index]
    page_width = page.ActualSize.Width
    page_height = page.ActualSize.Height

    page.Canvas.DrawLine(
        line_pen,
        side_margin, page_height - line_bottom_offset,
        page_width - side_margin, page_height - line_bottom_offset
    )

    footer_field.Location = PointF(
        side_margin,
        page_height - text_bottom_offset
    )
    footer_field.Draw(page.Canvas, 0.0, 0.0)

# 別のPDFとして保存する
document.SaveToFile(output_path)
document.Dispose()

コードのポイント

PdfCompositeField の書式文字列にある {0} は現在のページ番号、{1} は総ページ数に対応します。例えば、日本語の表記にする場合は、次のように変更します。

footer_field = PdfCompositeField(
    footer_font, footer_brush,
    "全{1}ページ中 {0}ページ",
    [page_number, page_count]
)

フッターの位置は、各ページの高さを取得して計算しています。通常の回転していないページであれば、ページサイズが異なる PDF でも、それぞれの下端を基準に配置できます。回転や特殊な表示領域が設定された PDF は、出力結果を確認して位置を調整してください。

区切り線とページ番号を追加した PDF の下部

5. 同じ PDF にヘッダーとフッターを追加するには

上の 2 つの例は、それぞれ単独で実行できます。両方を同じ PDF に追加する場合は、先にヘッダーの例を実行し、フッターの例の入力パスを次のように変更します。

input_path = "WithHeader.pdf"
output_path = "WithHeaderAndFooter.pdf"

これにより、ヘッダーを追加済みの PDF を読み込み、さらにフッターを追加したファイルを保存できます。同じ文書を繰り返し処理するとヘッダーやフッターが重ねて描画されるため、作り直す場合は元の PDF から処理してください。

まとめ

Spire.PDF for Python では、既存 PDF の各ページに文字、画像、線を描画することでヘッダーを追加できます。また、ページ番号と総ページ数のフィールドを組み合わせると、ページごとに自動更新されるフッターを作成できます。

文書の余白に合わせて位置やフォントサイズを調整すれば、報告書やマニュアルなどに統一した見出しとページ番号を付けられます。

よくある質問(FAQ)

1. ヘッダーを追加すると、本文の位置は自動で調整されますか?

この記事のコードでは、本文の位置は変わりません。指定した座標に文字や画像を描画するため、余白が足りない場合は本文と重なる可能性があります。入力 PDF の余白に合わせて、配置位置や文字サイズ、ロゴの大きさを調整してください。

2. 表紙を除いて、2ページ目から追加できますか?

はい。ページを処理するループの開始位置を変更します。

# 先頭ページを除き、2ページ目から処理する
for page_index in range(1, document.Pages.Count):
    page = document.Pages[page_index]
    # ヘッダーやフッターの描画処理

ただし、描画を2ページ目から始めても、ページ番号の開始値が自動的に「1」になるわけではありません。表紙を除いて番号を振る場合は、表示する番号と総ページ数を別途計算する必要があります。

3. ページ番号の表示形式は変更できますか?

はい。PdfCompositeField の書式文字列を変更します。この記事の例では、{0} が現在のページ番号、{1} が総ページ数を表します。

表示例 書式文字列
1 "{0}"
- 1 - "- {0} -"
1 / 10 "{0} / {1}"
Page 1 of 10 "Page {0} of {1}"
全10ページ中 1ページ "全{1}ページ中 {0}ページ"

4. 既存のヘッダーやフッターを置き換えることはできますか?

この記事のコードは、新しい要素を追加する処理です。既存のヘッダーやフッターは削除されないため、同じ位置に追加すると重なって表示されます。

置き換える場合は、既存の文字や画像を特定して削除する処理が別途必要です。ヘッダーやフッターを追加する前の PDF がある場合は、そのファイルから作り直すと管理しやすくなります。

無料トライアルライセンスの取得

Spire.PDF for Python の機能を評価制限なしで体験したい場合は、30 日間無料トライアルライセンス を申請できます。

Read 14 times