Wkhtmltopdf Python と IronPDF for Python の比較

1. 序論

PDFは、現代のデジタルワークフローにおいて重要な役割を果たしており、ドキュメントの保存や共有の標準フォーマットとして機能しています。 Pythonでは、開発者はしばしば、PDFの生成や操作のためにwkhtmltopdfやIronPDFのような強力なライブラリを利用します。 両方のライブラリは異なる機能と能力を提供し、PDF生成の分野における異なるニーズに対応しています。 この比較では、それぞれのライブラリの強みと用途を探り、開発者が情報に基づいた選択を行う手助けをします。

ウィキッドPDFとは何ですか？

2.1 概要

wkhtmltopdf は、WebKit レンダリングエンジンを利用して、HTMLやその他のマークアップ言語をPDFに変換するコマンドラインツールです。 Python 開発者は、pdfkit ライブラリをよく使用して、wkhtmltopdf をシンプルな Python ラッパーとして自分のプロジェクトにシームレスに統合します。 現在、python3-wkhtmltopdf パッケージは、wkhtmltopdf コマンドラインツール用の Python ラッパーも提供しており、Python スクリプト内で wkhtmltopdf をより便利に使用できます。元の wkhtmltopdf Python パッケージはもはや維持されていません。

2.2 主な機能

2.2.1 HTMLからPDFへの変換

wkhtmltopdfは、HTMLコンテンツをPDFに変換し、スタイル、レイアウト、および画像を保持する点で優れています。 そのシンプルなアプローチにより、HTMLからPDFへの変換が主な要件であるシナリオに適しています。

2.2.2 コマンドラインインターフェース

コマンドラインツールとして、wkhtmltopdfはスクリプト化が容易で、さまざまなワークフローに統合することができます。 それはバッチPDF生成プロセスの自動化に特に役立ちます。

CSSスタイリングとJavaScriptのサポート

wkhtmltopdfは、高度なCSSスタイリングをサポートし、変換プロセス中にJavaScriptを実行することで、生成されるPDFにリッチで動的なコンテンツを可能にします。

2.2.4 柔軟性とカスタマイズ

wkhtmltopdfは、ページサイズ、向き、その他のレイアウト設定に関して柔軟性を提供します。 開発者は、生成されたPDFの見た目と使い勝手を調整するために、これらのパラメータを微調整することができます。

2.2.5 配置と依存関係

このツールは外部ライブラリや依存関係に依存していないため、デプロイが簡単です。 ただし、ユーザーはwkhtmltopdfバイナリが環境内に存在することを確認する必要があります。

3. IronPDF for Python

3.1 概要

IronPDF は、PDFの生成、編集、および操作を容易にするために設計された多用途なPythonライブラリです。 それは、HTMLからPDFを生成する、HTMLをPDFに変換する、既存のPDFにテキストや画像を追加する、PDFドキュメントからコンテンツを抽出するなど、PDFファイルを操作するためのさまざまな機能を提供します。 これは特に .NET Framework で人気があり、その Python バージョンは Python 開発者に同様の機能を提供することを目指しています。

3.2 主要機能

• HTMLからPDFへの変換: IronPDF は、HTMLをPDFに変換することに優れており、CSSスタイリング、JavaScriptの実行、カスタムヘッダーとフッターなどの機能を提供します。 HTMLコンテンツを変換するための複数の方法を提供しています。HTML文字列、HTMLファイル、そしてURLを含みます。
• 編集と操作: IronPDFの特筆すべき機能の一つは、既存のPDFファイルを編集できる能力です。 開発者はPDFドキュメントにテキスト、画像、注釈などを追加することができ、PDF操作のための包括的なソリューションとなります。
• セキュリティ機能: IronPDF には、パスワード保護、暗号化、PDFドキュメントの権限設定などの強力なセキュリティ機能が含まれています。 これらの機能は、機密情報を安全に取り扱うために重要です。
• カスタマイズ可能なレンダリング: IronPDFを使用する開発者は、レンダリングプロセスを詳細に制御することができます。 カスタムヘッダー、フッター、ページマージン、および変換用の特定のHTML部分を構成して、正確なPDF出力を実現できます。
• デプロイと依存関係: IronPDF は、ASP.NET、MVC、Windows Forms、WPF を含むさまざまな Python 環境とシームレスに統合します。 それは .NET Core と Framework の両方をサポートしており、さまざまなプロジェクトタイプに対応できる汎用性があります。さらに、Azure などのクラウドサービスでも動作します。

4. Pythonプロジェクトを作成する

4.1 Python のセットアップ

Pythonがシステムにインストールされていることを確認してください。 Pythonは、公式Pythonウェブサイトからダウンロードできます。

PyCharmでプロジェクトを作成する方法

Pythonプロジェクトを作成するには、任意のIDEを使用できます。ここでは、著名なPython IDEであるPyCharmを使用します。任意のIDEまたはテキストエディタを使用することもできます。

1. PyCharmを開く: コンピューターでPyCharmを起動します。

2. 新しいプロジェクトの作成：ようこそ画面で「新しいプロジェクトの作成」をクリックするか、IDEでファイル > 新しいプロジェクトに移動します。

3. プロジェクトの場所を設定: プロジェクトディレクトリを指定し、必要に応じて「プロジェクト用のディレクトリを作成」を有効にします。

4. インタープリタを選択: 既存のPythonインタープリタを選択するか、新しい仮想環境を作成します。

5. プロジェクトの構成: プロジェクトタイプ、コンテンツルート、ソースルートを設定します（通常はデフォルトで問題ありません）。

6. 「作成」をクリック: 「作成」ボタンをクリックしてプロジェクトを作成します。

   

5. wkhtmltopdfユーティリティをインストール

wkhtmltopdf をダウンロードしてインストールする

wkhtmltopdfのダウンロードページにアクセスして、お使いのオペレーティングシステムに適したインストーラーをダウンロードしてください。

wkhtmltopdfをインストール

特定のオペレーティングシステムに対応したインストール手順に従ってください。 Windowsを使用している場合、任意のコマンドラインからアクセスできるように、PATH環境変数に追加してください。

• macOSで: Homebrewを使用してwkhtmltopdfをインストールします:

  :InstallCmd brew install --cask wkhtmltopdf

  :InstallCmd brew install --cask wkhtmltopdf

• Debian/Ubuntuの場合: APTを使用してwkhtmltopdfをインストールします。

  :InstallCmd sudo apt-get install wkhtmltopdf

  :InstallCmd sudo apt-get install wkhtmltopdf

インストールの確認

新しいターミナルまたはコマンドプロンプトを開き、「wkhtmltopdf」と入力して、ツールが正しくインストールされていることを確認してください。 利用可能なオプションに関する情報が表示されるはずです。

pipを使用してwkhtmltopdf pythonパッケージをインストール

wkhtmltopdfと連携する人気のPythonライブラリの1つはpdfkitです。 次のコマンドを使用して、本番プロジェクトにインストールしてください。

:InstallCmd pip install pdfkit

:InstallCmd pip install pdfkit

6. IronPDFのインストール

IronPDFをpipでインストール： PyCharmでターミナルまたはコマンドプロンプトを開き、次のコマンドを実行してpipを使用してIronPDFをインストールします：

`pip install ironpdf`

また、IronPDFウェブサイトのダウンロードセクションからプラットフォームに特化したPythonパッケージをダウンロードすることもできます。https://ironpdf.com/python/

7. 比較

この比較において、まず、wkhtmltopdfライブラリとIronPDFライブラリの両方を使用してHTMLからPDFドキュメントを作成する方法を見てみましょう。 次に示すものからPDFを生成する方法を見ていきます：

1. HTML文字列をPDFに変換

2. HTMLファイルをPDFに変換

3. URLをPDFに変換

   さらに、両方のライブラリが提供するいくつかのオプション引数と機能についても探求します。

7.1 IronPDFを使用してPDFファイルを作成する

まず、IronPDF がどのようにしてその ChromePdfRenderer エンジンを使用して、HTML 文字列、ファイル、および URL を PDF にシームレスにレンダリングするかを見ていきます。

7.1.1 HTML文字列からPDFへ

from ironpdf import *      
# Instantiate Renderer
renderer = ChromePdfRenderer()
# Create a PDF from an HTML string using Python
pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>")
# Export to a file or Stream
pdf.SaveAs("output.pdf")

py

こちらはHTML文字列をPDFに変換した出力です:

HTMLファイルをPDFに変換 (7.1.2)

from ironpdf import *      
# Instantiate Renderer
renderer = ChromePdfRenderer()
# Create a PDF from an existing HTML file using Python
pdf = renderer.RenderHtmlFileAsPdf("example.html")
# Export to a file or Stream
pdf.SaveAs("output.pdf")

py

HTMLファイルをPDFに変換した出力は以下の通りです:

HTML URL から PDF へ

from ironpdf import *      
# Instantiate Renderer
renderer = ChromePdfRenderer()
# Create a PDF from a URL or local file path
pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/python")
# Export to a file or Stream
pdf.SaveAs("url.pdf")

py

7.2 wkhtmltopdf

次に、wkhtmltopdfとPdfkitパッケージを使用して、HTML文字列、ファイル、およびURLをPDFに変換する方法を見ていきます。 まず、wkhtmltopdfライブラリのインストールパスを設定するか、コードの実行前に手動で設定を追加する必要があります。

config = pdfkit.configuration(wkhtmltopdf='PATH-to-WKHTMLTOPDF-EXECUTABLE-FILE')

py

7.2.1 HTML文字列からPDFへ

import pdfkit
config = pdfkit.configuration(wkhtmltopdf='PATH-to-WKHTMLTOPDF-EXECUTABLE-FILE')
pdfkit.from_string('<h1>Hello World!</h1>', 'out.pdf', configuration=config)

py

こちらはPDFに変換されたHTML文字列です:

7.2.2 HTMLファイルをPDFに変換

import pdfkit
config = pdfkit.configuration(wkhtmltopdf='PATH-to-WKHTMLTOPDF-EXECUTABLE-FILE')
pdfkit.from_file('example.html', 'index.pdf', configuration=config)

py

以下はHTMLファイルをPDFに変換したものです：

7.2.3 HTML URLをPDFに変換

import pdfkit
config = pdfkit.configuration(wkhtmltopdf='PATH-to-WKHTMLTOPDF-EXECUTABLE-FILE')
pdfkit.from_url('https://google.com', 'example.pdf', configuration=config)

py

7.3 比較

上記のコードと両方のライブラリが提供する機能の全体的な比較において、PDF生成のために提供されるコードと特徴の詳細な比較は次の通りです。

1. 使いやすさ

IronPDFは簡潔でPython風のAPIを提供し、HTMLからPDFへの変換において使いやすくなっています。 コードがクリーンで表現力豊かです。

wkhtmltopdfはシンプルで使いやすいですが、IronPDFと比べると構文がPythonicではないかもしれません。 さらに、これは主にコマンドラインツールであり、Python環境でwkhtmltopdfを正常に実行するために別のPythonパッケージに依存しています。

2. 柔軟性

IronPDFは、PDFのレンダリング、編集、およびセキュリティに関する広範なカスタマイズオプションを提供し、高い柔軟性を持っています。 こちらは、HTMLレンダリング設定としてオプション引数を作成できるコード例です。

from ironpdf import *          
    # Instantiate Renderer
    renderer = ChromePdfRenderer()
    # Many rendering options to use to customize!
    renderer.RenderingOptions.SetCustomPaperSizeInInches(12.5, 20)
    renderer.RenderingOptions.PrintHtmlBackgrounds = True
    renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape
    renderer.RenderingOptions.Title = "My PDF Document Name"
    renderer.RenderingOptions.EnableJavaScript = True
    renderer.RenderingOptions.WaitFor.RenderDelay(50) # in milliseconds
    renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Screen
    renderer.RenderingOptions.FitToPaperMode = FitToPaperModes.Zoom
    renderer.RenderingOptions.Zoom = 100
    renderer.RenderingOptions.CreatePdfFormsFromHtml = True
    # Supports margin customization!
    renderer.RenderingOptions.MarginTop = 40 # millimeters
    renderer.RenderingOptions.MarginLeft = 20 # millimeters
    renderer.RenderingOptions.MarginRight = 20 # millimeters
    renderer.RenderingOptions.MarginBottom = 40 # millimeters
    # Can set FirstPageNumber if you have a cover page
    renderer.RenderingOptions.FirstPageNumber = 1 # use 2 if a cover page will be appended
    # Settings have been set, we can render:
    renderer.RenderUrlAsPdf("https://www.wikipedia.org/").SaveAs("my-content.pdf")

py

wkhtmltopdfは基本的な変換作業に柔軟に対応しますが、より高度なPDF操作には追加ツールが必要な場合があります。 ここではPDFKitがこの目的に役立つレンダリングオプションを提供します:

import pdfkit
options = {
    'page-size': 'Letter',
    'orientation': 'Landscape',
    'margin-top': '0.75in',
    'margin-right': '0.75in',
    'margin-bottom': '0.75in',
    'margin-left': '0.75in',
    'encoding': "UTF-8",
    'custom-header': [
        ('Accept-Encoding', 'gzip')
    ],
    'no-outline': None
}
pdfkit.from_file('index.html', 'index.pdf', options=options)

py

3. 機能

IronPDF は、PDF/A 準拠、編集、結合、セキュリティ設定などの高度な機能を提供します。 こちらは、IronPDFが提供するパスワード、セキュリティ & メタデータオプションと機能のリストです。

from ironpdf import *          
    # Open an Encrypted File, alternatively create a new PDF from Html
    pdf = PdfDocument.FromFile("encrypted.pdf", "password")
    # Edit file metadata
    pdf.MetaData.Author = "Satoshi Nakamoto"
    pdf.MetaData.Keywords = "SEO, Friendly"
    pdf.MetaData.ModifiedDate = Now()
    # The following code makes a PDF read-only and will disallow copy & paste and printing
    pdf.SecuritySettings.RemovePasswordsAndEncryption()
    pdf.SecuritySettings.MakePdfDocumentReadOnly("secret-key")
    pdf.SecuritySettings.AllowUserAnnotations = False
    pdf.SecuritySettings.AllowUserCopyPasteContent = False
    pdf.SecuritySettings.AllowUserFormData = False
    pdf.SecuritySettings.AllowUserPrinting = PdfPrintSecurity.FullPrintRights
    # Change or set the document encryption password
    pdf.SecuritySettings.OwnerPassword = "top-secret"  # password to edit the pdf
    pdf.SecuritySettings.UserPassword = "sharable"  # password to open the pdf
    pdf.SaveAs("secured.pdf")

py

wkhtmltopdfはHTMLからPDFへの変換に特化しており、IronPDFが提供するいくつかの高度な機能が欠けています。

4. 統合

IronPDFはPython環境とシームレスに統合され、簡単に導入できます。

wkhtmltopdf は、デプロイ時に追加の考慮事項が必要となる場合がある wkhtmltopdf バイナリが利用可能であることを要求します。

5. 文法

• IronPDFの構文はクリーンで、Pythonコードにうまく統合されています。
• wkhtmltopdfの構文は簡単ですが、IronPDFに比べてPythonへの統合が低いと感じるかもしれません。

8. サポートとドキュメント

8.1 IronPDF

ドキュメントの品質と利用可能性

IronPDFは、包括的でユーザーフレンドリーなドキュメントで際立っており、初心者から経験豊富な開発者まで対応しています。 ドキュメントには詳細なガイド、API リファレンス、コード例が豊富に含まれており、Python、Java、C#、Node.jsなど複数の言語でライブラリの機能を理解して実装する際の円滑なサポートを提供します。

サポートオプション

IronPDF は、多様なサポートオプションを提供しており、開発者が迅速に支援を受けられるようにしています。 これには、メールでアクセスできる専用サポートチーム、開発者フォーラムへの積極的な参加、およびリアルタイムでのヘルプを提供するウェブサイト上のライブサポートオプションが含まれます。

8.2 wkhtmltopdf

ドキュメントの品質と利用可能性

wkhtmltopdfはオープンソースプロジェクトであり、公式GitHubリポジトリやその他のオンラインプラットフォームでドキュメントが提供されています。 基本的な使用方法とインストールをカバーしている一方で、ドキュメントは一部の商用代替品と比べて詳しさや初心者に優しい性質が欠けているかもしれません。

GitHubの問題とコミュニティサポート

wkhtmltopdfのサポートは主にコミュニティによって提供されています。 ユーザーは、GitHubのIssueを通じて問題を報告し、コミュニティのディスカッションやフォーラムを利用して問題解決の支援を求めることができます。 コミュニティは活発に議論に参加し、経験やソリューションを共有しています。

9. ライセンスモデル

9.1 wkhtmltopdf

wkhtmltopdfは、オープンソースのライセンスモデルに従っています。 これは、無料でオープンソースのソフトウェアライセンスであるGNU Affero一般公衆利用許諾契約書（AGPL）の下で配布されています。 AGPLはコピーレフトライセンスであり、ソフトウェアの修正版もAGPLの下で配布する必要があります。 以下は wkhtmltopdf のライセンスに関する重要なポイントです。

オープンソース

wkhtmltopdfは無料でオープンソースで提供されており、ユーザーはソースコードを閲覧、変更、配布することができます。

AGPLライセンス

コードに加えられた変更は同じライセンスの下で公開されることを要求するGNU AGPLのもとで配布されています。

無料で使用可能

ユーザーはライセンス料金を発生させることなく、ソフトウェアを自由にダウンロード、使用、及び変更することができます。

コピーレフト条項

AGPLのコピーレフト条項は、派生作品もオープンソースでなければならないことを保証します。

9.2 IronPDF

IronPDFは商用ライセンスモデルに従っています。 IronPDFのライセンスは、特定のニーズや使用シナリオに対応するさまざまなエディションに基づいています。 利用可能なエディションは次のとおりです:

ライトエディション

• クラウド展開のための一度限りの費用として$749で価格設定されています。
• 基本的なPDF処理要件を持つ小規模なプロジェクトまたはチーム向けに設計されています。

プロフェッショナル版

• クラウド利用のための一括料金として$1,999で価格設定されています。
• 高度なPDF機能と性能を必要とするプロの開発者向け。

無制限版

• クラウドデプロイメントのための一回限りの料金として、価格は$3,999です。

• 大規模な企業での使用に最適で、使用に制限のない広範な機能を提供します。

  

  IronPDFのライセンスは永久ライセンスであり、有効期限がありません。また、開発者は選択したエディションに基づいて更新とサポートを受けることができます。 ライセンシングモデルは、開発者がプロジェクトの要件に一致するエディションを選択する柔軟性を提供します。 ライセンスとアドオンに関する詳細情報については、ライセンス ページをご覧ください。

10. 結論

結論として、wkhtmltopdf と IronPDF for Python を徹底的に比較した結果、IronPDF が高度なPDF要件を持つプロジェクトにおいて優れた選択肢であることが明らかになりました。 wkhtmltopdfは、シンプルでコマンドラインインターフェイスを活用したHTMLからPDFへの変換タスクには適していますが、より複雑なPDF操作に直面した場合には、不十分になることが多く、そのために追加のツールが必要となる場合があります。

それどころか、IronPDFは、特により高い洗練度が求められるプロジェクトにおいて際立った選択肢であることを証明しています。 それは、広範なカスタマイズオプションを備えた使いやすいAPIを提供することに優れています。 これによって、IronPDFは包括的なPDF操作、編集、および強力なセキュリティ機能を必要とするタスクに最適なソリューションとなります。 その柔軟性はレイアウト設定にとどまらず、開発者が様々なPython環境にシームレスに統合できるようにします。

IronPDFのドキュメントは、その深さとアクセスしやすさにおいて優れており、開発者にとって包括的なリソースを提供します。 これに対して、wkhtmltopdfはコミュニティのサポートに依存しているため、コミュニティフォーラムや自己解決に慣れている開発者に適しているかもしれません。

IronPDFは開発のために無料ですが、生成されたPDFには透かしが入っています。そして、商用モードで透かしなしの完全な機能を試すための無料試用版を提供しています。 ソフトウェアをこちらからダウンロードしてください。