gpdf

クイックスタート

インストール

go get github.com/gpdf-dev/gpdf

gpdfは外部依存ゼロ — Go標準ライブラリのみを使用します。

Hello World

package main

import (
    "os"
    "github.com/gpdf-dev/gpdf/document"
    "github.com/gpdf-dev/gpdf/template"
)

func main() {
    doc := template.New(
        template.WithPageSize(document.A4),
        template.WithMargins(document.UniformEdges(document.Mm(20))),
    )

    page := doc.AddPage()
    page.AutoRow(func(r *template.RowBuilder) {
        r.Col(12, func(c *template.ColBuilder) {
            c.Text("Hello, World!", template.FontSize(24), template.Bold())
        })
    })

    data, _ := doc.Generate()
    os.WriteFile("hello.pdf", data, 0644)
}

┌─ A4 ──────────────────────────────────┐
│                                       │
│   Hello, World!    ← 24pt, Bold       │
│                                       │
│                                       │
└───────────────────────────────────────┘

PDFを作成する3つの方法

gpdfには3つのPDF生成アプローチがあります:

1. Builder API（推奨）

最も一般的なアプローチ — 流暢なビルダーパターンによるプログラム制御:

doc := template.New(template.WithPageSize(document.A4))
page := doc.AddPage()
page.AutoRow(func(r *template.RowBuilder) {
    r.Col(6, func(c *template.ColBuilder) {
        c.Text("Left column")
    })
    r.Col(6, func(c *template.ColBuilder) {
        c.Text("Right column")
    })
})
data, err := doc.Generate()

2. JSONスキーマ

JSONで宣言的にドキュメントを定義 — 動的コンテンツやAPI駆動の生成に最適:

schema := []byte(`{
    "page": {"size": "A4", "margins": "20mm"},
    "body": [
        {"row": {"cols": [
            {"span": 12, "text": "Hello from JSON!", "style": {"size": 24, "bold": true}}
        ]}}
    ]
}`)

doc, err := template.FromJSON(schema, nil)
data, err := doc.Generate()

3. 再利用可能なコンポーネント

一般的なビジネスドキュメント向けのプリビルトコンポーネント:

doc := template.Invoice(template.InvoiceData{
    Number:  "#INV-2026-001",
    Date:    "March 1, 2026",
    DueDate: "March 31, 2026",
    From:    template.InvoiceParty{Name: "ACME Corp", Address: []string{"123 Main St"}},
    To:      template.InvoiceParty{Name: "Client Inc", Address: []string{"456 Oak Ave"}},
    Items: []template.InvoiceItem{
        {Description: "Web Development", Quantity: "40 hrs", UnitPrice: 150.00, Amount: 6000.00},
    },
    TaxRate:  10,
    Currency: "$",
})
data, err := doc.Generate()

出力方法

// Generate は PDF を []byte として返します
data, err := doc.Generate()

// Render は任意の io.Writer に PDF を書き込みます
err := doc.Render(w)

次のステップ