HTML と Word から PDF を作成: PDF ジェネレーター Gotenberg 9 を完全に再構築

Gotenberg のバージョン 9.0.0 がリリースされ、そのすぐ後にバージョン 9.1.0 がリリースされました。 PDF API は、PDF 編集用の独自のエンジンを受け取り、自由に選択可能な順序でステップを処理し、新しい LibreOffice 接続を受け取ります。バージョン 8 から移行するには、API 呼び出しと構成を変更する必要があります。

広告の後に続きを読む

Gotenberg を使用すると、開発者は PDF の作成と編集をアプリケーションに統合できます。 Docker コンテナとして利用できるオープンソース API は、Web ページ、HTML、Markdown、Office ドキュメントを PDF に変換します。彼女は Web コンテンツには Chromium を、オフィスファイルには LibreOffice を使用しています。

PDF編集と標準チェックのための独自エンジン

Go で書かれた PDF エンジン litho は、pdfcpu、QPDF、pdftk、ExifTool を置き換えます。 Gotenberg プロセスで直接実行されます。新しいエンジンはドキュメントに署名し、タイムスタンプを付け、ページを PNG または JPEG としてレンダリングします。編集すると、影響を受けるコンテンツが表示内で非表示になるだけでなく、ファイルから削除されます。また、フォームに入力したり、フォームフィールドを静的ページコンテンツに変換したり（フラット化）、画質を損なうことなく PDF を縮小したりすることもできます。 Gotenberg は、HTTP 400 で既存の署名を削除する処理ステップを拒否します。

と remediate 選択した適合プロファイルに基づいてリソ PDF を修正し、結果を確認します。長期アーカイブ用に 11 の PDF/A 準拠レベルがサポートされているほか、アクセシブルなドキュメント用に PDF/UA-1 および PDF/UA-2 がサポートされています。 PDF/A と PDF/UA の組み合わせ、および Factur-X も含まれます。後者は、読み取り可能な PDF 請求書と機械読み取り可能な XML 請求書データを組み合わせます。

2 つの応答ヘッダーは、ページ、テキスト、画像を保存するために litho が撤回した残りのルール違反と修正を報告します。自動修復は必ずしも規格に完全に準拠していることを意味するものではありません。以上 /forms/pdf/validate 既存の PDF は、変換とは別にチェックすることもできます。

固定の後処理ではなく処理ステップ

以前は、個々のフォームフィールドが固定された順序で後処理を制御していました。今、クライアントは現場を通過します stages Gotenberg が指定された順序で実行する処理ステップのリスト。これは、Chromium および LibreOffice の変換エンドポイントで動作します。既存のドキュメントの略です /forms/pdf/pipe 準備ができて。バージョン 9.0.0 には 26 のこのようなステップがあり、個別に実行することもできます /forms/pdf/ 到達可能です。リストの構造の詳細については、リクエスト処理のドキュメントを参照してください。

たとえば、アプリケーションは最初にウォーターマークを適用してから、 remediate 必要な規格への準拠を復元します。 Gotenberg は、処理が開始される前に HTTP 400 を使用して無効な注文を拒否します。追加の 6 つのエンドポイントは、情報、検証結果、メタデータ、ブックマーク、添付ファイル、フォームフィールドを JSON として配信します。

LibreOfficeKit が以前の接続を置き換えます

Office 変換の場合、永続的に実行される LibreOfficeKit プロセス lok が、Python や soffice リスナーを含む以前の unoconverter を置き換えます。 Gotenberg は lok を監視し、クラッシュ後にそれを再起動します。 PDF と Office の接続を変換すると、以前の PDF ツールに加えて、Java と Python も Docker イメージから削除されます。これは、オペレータがパッチを適用する必要があるパッケージが減り、Gotenberg が提供していないツールの CVE メッセージを受信しなくなることを意味します。 LibreOffice ではマクロはデフォルトで無効のままです。フラグを介して実行をオンにできます。 --libreoffice-enable-macros。

広告の後に続きを読む

LibreOfficeは経由で使用できます nativePdfa PDF/A-1b、PDF/A-2b、PDF/A-3b、または PDF/A-4 を直接エクスポートします。 nativePdfua PDF/UA-1をサポートします。ただし、Gotenberg は、さらなる処理後に PDF/A エクスポートを繰り返すことはなくなりました。下流のステップがコンプライアンスに影響を与える可能性がある場合は、 remediate 処理を完了します。 LibreOffice の変換では EPUB ファイルが受け入れられなくなりました。

新しい API オプションと移行の変更

フィールドと一緒に archives API は、アップロードされた ZIP アーカイブを解凍できます。オペレーターは、2 つの新しいフラグを使用して、(ZIP 爆弾から保護するために) 解凍時にエントリの数とサイズ比率を制限します。共通のフィールド paperSize Chromium および LibreOffice の用紙形式 (A4、レター、リーガルなど) を設定します。

アップグレードする場合、クライアントには以前のエンドポイントが存在する必要があります。 /forms/pdfengines の上 /forms/pdf フィールドの変更および後処理 stages 代わりの。独自の処理ステップを持つ変換フィールドには、それらを区別するための接頭辞が付けられます。 native （約 nativePdfa）。リモートエンドポイントは HTTP 404 で応答し、後続のエンドポイントを指定します。非推奨のフィールドでは、新しい使用法を示す HTTP 400 が返されます。

モニタリング構成にも調整が必要です。メトリクスとスパンの名前は OpenTelemetry の規則に従っています。以前の Prometheus モジュールは必要なくなり、エクスポートが引き継ぎます。 OTEL_METRICS_EXPORTER=prometheus。 Gotenberg アップグレードガイドでは、以前のエンドポイント、フィールド、フラグ、メトリック、およびスパンを新しい同等のものにマッピングします。

タグが付いた Docker イメージは誰ですか latest ダウンロードすると、Gotenberg 9 を入手できるようになります。まだ切り替えていない場合は、今のところ切り替える必要があります。 gotenberg/gotenberg:8 使用。イメージバリアント、サポートされているアーキテクチャ、コンテナユーザー、ポート、および起動コマンドは変更されません。さらなる変更、セキュリティ修正、バグ修正は、Gotenberg 9.0.0 のリリースノートに記載されています。

(フォ)