如何在 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，我們將通過保留網頁的原始文本和佈局來使用 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。
# 在你的 ruby 應用程序中為 http://api.groupdocs.cloud 加載 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。它是易於使用的免費在線 chrome html 到 pdf 轉換器。這個免費的 html 到 pdf 轉換器是使用上面的 convert html to pdf API 開發的。請嘗試以下 chrome html 文檔到 pdf 免費在線轉換器。

結論

在這篇文章中，我們學習瞭如何使用 Ruby 最好的 html 到雲上的 pdf 庫將 chrome HTML 轉換為 PDF 文檔。本文還解釋瞭如何使用高級選項將 html 轉換為帶有圖像的 pdf。此外，本文還解釋瞭如何以編程方式將 HTML 文件上傳到雲端，然後從雲端下載轉換後的 PDF 文件。您可以使用 文檔 了解有關 GroupDocs.Conversion 文件轉換器 API 的更多信息。我們還提供了一個 API 參考 部分，讓您可以直接通過瀏覽器可視化我們的 API 並與之通信。

問一個問題

如果您對免費的 HTML 到 PDF 轉換器或 GroupDocs.Conversion Cloud REST API 有任何疑問，請隨時在 論壇 上詢問我們。

也可以看看