Ruby で REST API を使用して HTML を PDF に変換する方法

HTML から PDF へのコンバータ |無料オンラインでHTMLをPDFに変換

Ruby 開発者は、GroupDocs.Conversion Cloud API を使用して、クラウド上でプログラムによって HTML ファイルを PDF ドキュメントに変換できます。 HTML から PDF への変換ソフトウェアは、オフラインで記事を読んだり、変換されたファイルをポータブル形式で共有したりするのに役立ちます。この記事では、Ruby の REST API を使用して HTML を PDF に変換する方法を学びます。

このチュートリアルでは次のトピックについて説明します。

HTML から PDF への変換 REST API と Ruby SDK のインストール

書式を失わずに HTML から PDF への変換を開始するには、Web ページの元のテキストとレイアウトを保持して GroupDocs.Conversion Cloud API の Ruby SDK を使用します。したがって、文書を印刷してもレイアウトが混乱することはありません。当社の API を使用すると、サポートされているファイル形式 のドキュメントと画像を必要な形式に変換できます。 Word、PowerPoint, Excel、PDF、HTML、CAD、ラスター画像など、50種類以上の文書や画像を簡単に変換できます。

GroupDocs.Conversion html to pdf ライブラリを Ruby アプリケーションに無料でインストールできます。 Rails コンソールで以下のコマンドを使用して、HTML を PDF に変換し、Gem を無料でダウンロードします。

gem install groupdocs_conversion_cloud

手順と利用可能なコード例を開始する前に、ダッシュボード から クライアント ID とクライアント シークレットを取得してください。 ID とシークレットを取得したら、以下に示すコードを追加してください。

# 無料登録後、https://dashboard.groupdocs.cloud から client_id と client_secret を取得します。
# http://api.groupdocs.cloud の Ruby アプリケーションに gem をロードします。

require 'groupdocs_conversion_cloud'
@client_id = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
@client_secret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
# ここにストレージ名を追加します
@mystorage = "InternalStorage"

REST APIを使用してRubyでHTMLをPDFに変換する

以下の簡単な手順に従って、HTML 形式を PDF ファイルに変換し、オフラインで表示して読むことができます。

ファイルをアップロードする

まず、以下のコード例を使用して、HTML ドキュメントを html2pdf 複数ページ変換用のクラウド ストレージにアップロードします。

# 変換 API のインスタンスを作成するための API 初期化
@fileApi = GroupDocsConversionCloud::FileApi.from_keys(@client_id, @client_secret)

# ファイルをクラウドストレージにアップロードする

@htmlfile = "#{Rails.root}/public/groupdocs-files/two-pages.html"
@fileStream = File.new(@htmlfile, "r")

@request = GroupDocsConversionCloud::UploadFileRequest.new("html-to-pdf/two-pages.html", @fileStream, @mystorage)
@response = @fileApi.upload_file(@request)

@fileStream.close()

puts("HTML File Uploading completed." + (@response).to_s )

その結果、アップロードされた HTML ファイルは、クラウド上のダッシュボードの ファイル セクション で利用できるようになります。

Ruby で HTML を PDF に変換する

以下の手順に従って、プログラムで HTML ドキュメントを PDF に簡単に変換できます。

  • ConvertApi のインスタンスを作成する
  • ConvertSettings のインスタンスを作成する
  • HTML ファイルのパスと出力ファイル形式を「pdf」に設定します。
  • HtmlLoadOptions のインスタンスを作成する
  • ページ\番号付けを true に設定します
  • ロードオプション設定の割り当て
  • 出力ファイルのパス「html-to-pdf」を設定します。
  • ConvertSettings を使用して ConvertDocumentRequest を作成する
  • 最後に、ConvertDocumentRequest を使用して convertdocument() メソッドを呼び出します。

次のコード例は、REST API を使用して HTML ファイルから PDF ドキュメントに変換する方法を示しています。

# 必要なAPIインスタンスを作成する
@fileApi = GroupDocsConversionCloud::ConvertApi.from_keys(@client_id, @client_secret)

# 変換設定を準備する
settings = GroupDocsConversionCloud::ConvertSettings.new
settings.file_path = "html-to-pdf/two-pages.html"
settings.format = "pdf"

loadOptions = GroupDocsConversionCloud::HtmlLoadOptions.new
loadOptions.page_numbering = true

settings.load_options = loadOptions
settings.output_path = "html-to-pdf"

# PDFに変換
result = @fileApi.convert_document(GroupDocsConversionCloud::ConvertDocumentRequest.new(settings))
puts("HTML file successfully converted to pdf file.")

変換されたファイルをダウンロードする

上記のコードサンプルでは、html2pdf形式のファイルをクラウド上に保存します。次のコードサンプルを使用してダウンロードできます。

# API の初期化: 変換 API のインスタンスを作成します。
@fileApi = GroupDocsConversionCloud::FileApi.from_keys(@client_id, @client_secret)

# PDFファイルのダウンロードリクエスト
@request = GroupDocsConversionCloud::DownloadFileRequest.new("html-to-pdf/two-pages.pdf", @mystorage)
@response = @fileApi.download_file(@request)

puts("PDF file successfully downloaded." + (@response).to_s )

Ruby の詳細オプションを使用した HTML から PDF への変換

以下の手順に従って、プログラムで高度なオプションを使用して HTML ドキュメントを PDF ドキュメントに変換することもできます。

  • ConvertApi のインスタンスを作成する
  • ConvertSettings のインスタンスを作成する
  • HTML ファイルのパスと出力ファイル形式を「pdf」に設定します。
  • HtmlLoadOptions のインスタンスを作成する
  • ページ\番号付けを true に設定します
  • PdfConvertOptions のインスタンスを作成する
  • さまざまな ConvertOptions center\window、from\page、margin\top などを設定します。
  • ロードオプション設定の割り当て and convert options settings
  • 出力ファイルのパス「html-to-pdf」を指定します。
  • ConvertSettings を使用して ConvertDocumentRequest を作成する
  • 最後に、ConvertDocumentRequest を使用して convertdocument() メソッドを呼び出します。

次のコード例は、Ruby の REST API を使用して、事前設定を行って Chrome HTML ドキュメントを PDF ドキュメントに変換する方法を示しています。前述の手順に従ってファイルをアップロードおよびダウンロードしてください。

#  HTML から PDF への変換 API のインスタンスを作成する
@fileApi = GroupDocsConversionCloud::ConvertApi.from_keys(@client_id, @client_secret)

# 高度なファイル オプションの変換設定を設定する

settings = GroupDocsConversionCloud::ConvertSettings.new
settings.file_path = "html-to-pdf/two-pages.html"
settings.format = "pdf"
 
loadOptions = GroupDocsConversionCloud::HtmlLoadOptions.new
loadOptions.page_numbering = true

convertOptions = GroupDocsConversionCloud::PdfConvertOptions.new
convertOptions.center_window = true
convertOptions.compress_images = false
convertOptions.display_doc_title = true
convertOptions.dpi = 1024.0
convertOptions.fit_window = false
convertOptions.from_page = 1
convertOptions.grayscale = false
convertOptions.image_quality = 100
convertOptions.linearize = false
convertOptions.margin_top = 5
convertOptions.margin_left = 5
convertOptions.password = "password"
convertOptions.unembed_fonts = true
convertOptions.remove_unused_streams = true
convertOptions.remove_unused_objects = true
convertOptions.remove_pdfa_compliance = false
 
settings.load_options = loadOptions
settings.convert_options = convertOptions
settings.output_path = "html-to-pdf"

# HTML を PDF に変換する
result = @fileApi.convert_document(GroupDocsConversionCloud::ConvertDocumentRequest.new(settings))

puts("HTML file successfully converted to pdf file with advanced file options.")

無料のオンラインHTMLからPDFへのコンバーター

HTMLファイルをオンラインで無料でPDFに変換するにはどうすればよいですか?弊社の最高の HTML から PDF への無料コンバーターを使用して、オンラインで無料で HTML を PDF に変換し、ワンクリックで HTML を PDF に変換できます。これは、オンラインで無料で使える使いやすいChrome HTMLからPDFへのコンバーターです。この無料の HTML から PDF へのコンバーターは、上記の HTML から PDF への変換 API を使用して開発されました。次の Chrome HTML ドキュメントから PDF へのコンバーターをオンラインで無料 をお試しください。

結論

この記事では、クラウド上で Ruby の最高の HTML to PDF ライブラリを使用して Chrome HTML を PDF ドキュメントに変換する方法を学びました。この記事では、高度なオプションを使用して、HTML を画像付きの PDF に変換する方法についても説明しました。さらに、この記事では、プログラムによって HTML ファイルをクラウドにアップロードし、変換された PDF ファイルをクラウドからダウンロードする方法についても説明しました。 GroupDocs.Conversion ファイル コンバータ API の詳細については、ドキュメント を使用して学習できます。また、ブラウザーを通じて API を直接視覚化して通信できる API リファレンス セクションも提供しています。

質問する

無料の HTML から PDF へのコンバーターまたは GroupDocs.Conversion Cloud REST API についてご質問がある場合は、フォーラム でお気軽にお問い合わせください。

関連項目