使用 REST API 在 Ruby 中將 Word 文檔轉換為 PDF

如何使用 Ruby 將 Word 文檔轉換為 PDF

DOCX 是世界上最流行的文字處理器之一。但是，MS DOCX 會重新格式化文檔，並且可以在不同的計算機系統上打開時進行更改。雖然 PDF 文件對移動設備友好，易於閱讀且無法更改。這就是為什麼用戶在發送在線賬單、交易歷史和講義等重要信息時將 word 文檔轉換為 ruby 中的 PDF 的原因。

現在您知道為什麼要將 Word 文檔轉換為 PDF 文件了吧。您可以使用 Microsoft Office 提供的內置功能將 Word DOCX 轉換為 PDF，但您可能需要以編程方式將 Word 文檔 DOCX 轉換為 PDF。使用 Groupdocs 轉換 API 將您的 Word 文檔轉換為 PDF 是快速、簡單和即時的。您所需要的只是穩定的互聯網連接和您的文件。在本文中，我們將學習如何使用 REST API 在 Ruby 中將 Word 文檔轉換為 PDF。

本博客文章應涵蓋以下主題：

Word 到 PDF 轉換 REST API - Ruby API 安裝

您可以使用 GroupDocs.Conversion Cloud 的 Ruby SDK 輕鬆地將 DOCX 文件 轉換為 PDF。它可以幫助您快速可靠地將支持的文件格式的文檔轉換為其他文檔格式 - 只需幾秒鐘，而且質量很高。 GroupDocs.Conversion Cloud REST API 允許您在範圍廣泛的支持的文件格式 中轉換文檔，而無需任何依賴軟件。它兼容所有主要的辦公軟件，並且完全獨立於操作系統。

GroupDocs.Conversion 提供高質量的文檔轉換解決方案。您可以在 此處 查看我們可用的 SDK 列表，以使用我們的雲 REST API 將文檔轉換為新格式。您還可以使用 GroupDocs.Conversion Cloud API 參考 Swagger UI 直接從瀏覽器調用此 REST API。 rubygems 提供了 gem groupdocsconversioncloud。您可以安裝 GroupDocs.Conversion Cloud API，使用此 gem 在 Rails 控制台中使用以下命令在 Ruby 應用程序中將 word 文檔轉換為 PDF：

gem install groupdocs_conversion_cloud

Addressable ~> 2.5.0, >= 2.5.0 是 groupdocsconversioncloud 的運行時依賴 gem。您還可以將轉換 gem 複製到 Gemfile 中以與 GroupDocs.Conversion Cloud API 通信，然後運行 bundle install：

gem "groupdocs_conversion_cloud", "~> 22.3"
bundle install

接下來，您需要在向 GroupDocs Conversion Cloud API 發出任何請求之前添加一個 Client Id 和一個 Client Secret。這將用於調用 GroupDocs Cloud API 到您現有的項目中。您可以通過在 Groupdocs 儀表板 上創建一個新的 應用程序 來獲取客戶端憑據。獲得客戶端 ID 和客戶端密碼後，將它們添加到 ruby 代碼片段中，如下所示：

# 免費註冊後，從 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"
# 在此處添加您的存儲名稱
@groupdocs_storage = "MyStorage"

使用 REST API 在 Ruby 中將 Word 文檔轉換為 PDF

您可以按照以下簡單步驟在雲端以編程方式將 Word 文檔轉換為 PDF：

  1. 上傳DOCX文件到雲端
  2. 轉換 DOCX轉PDF文件
  3. 下載轉換後的PDF文件
  4. 刪除 文件從雲存儲

1\。上傳 DOCX 文件

首先，使用以下代碼示例將 DOCX 文件上傳到雲存儲：

# API 初始化：創建轉換 API 的實例
@fileApi = GroupDocsConversionCloud::FileApi.from_keys(@client_id, @client_secret)

# 上傳文件到雲存儲

@wordfile = "#{Rails.root}/public/groupdocs-files/four-pages.docx"
@fileStream = File.new(@wordfile, "r")

@request = GroupDocsConversionCloud::UploadFileRequest.new('conversion/four-pages.docx', @fileStream, @groupdocs_storage)
@response = @fileApi.upload_file(@request)

@fileStream.close()

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

因此，上傳的 DOCX 文件將在雲上的 儀表板 的 文件部分 中可用。

2.使用 Ruby 將 DOCX 轉換為 PDF

您可以按照以下步驟以編程方式將 DOCX 轉換為 PDF 文件：

  • 首先，創建 FileApi 的實例。
  • 接下來，創建 ConvertSettings 的實例。
  • 然後，設置輸入 DOCX 文件路徑。
  • 提供輸出文件的格式為“pdf”。
  • 現在，將輸出目錄路徑提供為“轉換”。
  • 接下來，使用提供的設置創建 ConvertDocumentRequest。
  • 最後，以 ConvertDocumentRequest 作為參數調用 convert\document() 方法。

以下代碼片段顯示瞭如何在 Ruby 中使用 REST API 將 DOCX 轉換為 PDF。

# API 初始化：創建轉換 API 的實例
@fileApi = GroupDocsConversionCloud::FileApi.from_keys(@client_id, @client_secret)

# 準備轉換文件設置
settings = GroupDocsConversionCloud::轉變Settings.new
settings.file_path = "four-pages.docx"
settings.format = "pdf"
settings.output_path = "conversion"

# 轉變
result = @fileApi.convert_document(GroupDocsConversionCloud::轉變DocumentRequest.new(settings))

puts("Word file successfully converted to pdf file.")
使用 Ruby 將 DOCX 轉換為 PDF

使用 Ruby 將 DOCX 轉換為 PDF

3.下載轉換後的文件

轉換後的 PDF 文件已保存在雲端。以下代碼片段演示瞭如何使用 Ruby 下載文件：

# API 初始化：創建轉換 API 的實例
@fileApi = GroupDocsConversionCloud::FileApi.from_keys(@client_id, @client_secret)

# 下載文件請求

@request = GroupDocsConversionCloud::DownloadFileRequest.new("conversion/four-pages.pdf", @groupdocs_storage)
@response = @fileApi.download_file(@request)
    
puts("File downloading successfully completed." + (@response).to_s )

4\。從雲存儲中刪除文件

您可以使用如下代碼示例刪除轉換後的 PDF 文件：

# API 初始化：創建轉換 API 的實例
@fileApi = GroupDocsConversionCloud::FileApi.from_keys(@client_id, @client_secret)

# 從存儲中刪除文件請求

@request = GroupDocsConversionCloud::DeleteFileRequest.new("conversion/four-pages.docx", @groupdocs_storage)
@response = @fileApi.delete_file(@request)

puts("File successfully deleted from storage." + (@response).to_s )

使用 Ruby 中的高級選項將 Word 轉換為 PDF

您還可以按照以下步驟使用高級選項將 Word 文檔轉換為 ruby 中的 PDF 文件：

  • 首先，創建 FileApi 的實例。
  • 現在，使用 ConvertSettings 創建 ConvertDocumentRequest
  • 然後，設置輸入 DOCX 文件路徑。
  • 將結果文件的格式提供為“pdf”。
  • 現在，創建 DocxLoadOptions 的實例。
  • 為 loadOptions 設置密碼
  • 接下來，創建 PdfConvertOptions 的實例
  • 然後，設置各種轉換選項，如中心\窗口、顯示\文檔\標題、邊距、圖像\質量和字體等。
  • 提供加載\選項、轉換\選項和輸出\路徑設置。
  • 最後，通過使用 ConvertDocumentRequest 調用 convert\document() 方法來轉換 DOCX

以下代碼示例顯示瞭如何使用高級轉換選項將 Word 文檔轉換為 PDF 文檔。請按照前面提到的步驟上傳和下載文件。

# API 初始化：創建轉換 API 的實例
@fileApi = GroupDocsConversionCloud::FileApi.from_keys(@client_id, @client_secret)

# 高級文件選項
# 準備並設置轉換設置

settings = GroupDocsConversionCloud::ConvertSettings.new
settings.file_path = "four-pages.docx"
settings.format = "pdf"
 
loadOptions = GroupDocsConversionCloud::DocxLoadOptions.new
loadOptions.password = "password"

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 = "advance_options"
 
# 轉換文檔 
result = @fileApi.convert_document(GroupDocsConversionCloud::ConvertDocumentRequest.new(settings))

puts("Word file successfully converted to pdf file with advance file options.")

因此，Word DOCX 文件將使用高級文件選項轉換為 PDF 文件。

免費的 DOCX 到 PDF 在線轉換器

如何在線將Word轉PDF？我們的免費在線 PDF 轉換器將從您的 Word 文檔創建 PDF。此在線 PDF 轉換器是使用 Groupdocs Conversion API 開發的，可保留文件的佈局。 免費將文檔 DOCX 轉換為 PDF 與原始 PDF 文件完全相同。

結論

在本文中，我們學習瞭如何將 Word 文檔轉換為雲端的 PDF 文件。您還了解瞭如何使用 Ruby 使用高級選項將 DOCX 轉換為 PDF。本文還介紹瞭如何以編程方式將 DOCX 文件上傳到雲端，然後從雲端下載轉換後的 PDF 文件。此外，您可以使用 文檔 了解有關 GroupDocs.Conversion Cloud API 的更多信息。我們還提供了一個 API 參考 部分，讓您可以直接通過瀏覽器可視化我們的 API 並與之交互。

問一個問題

如果您對 DOCX 到 PDF 轉換器有任何疑問，請隨時在 論壇 上詢問我們。

也可以看看

我們建議使用支持的文檔轉換的相關鏈接：