使用 Ruby Cloud SDK 在线开发 Word 到 PDF 转换器。在线执行 DOCX 到 PDF 或 DOC 到 PDF
概述
DOCX 是 Microsoft Word 文档的一种众所周知的格式,随 Microsoft Word 2007 一起引入。Docx 基于开放的 XML,Docx 文件可以用 Word 2007 打开。而 PDF 是一个用于表示文档的便携式文档格式。它是由 Adobe Systems 开发的一种通用文件格式,可以包含任意数量的字体和图像。它提供了一种简单、可靠的方式来创建、呈现文档文件和传输打印机就绪输出。
您想将 DOCX 文件转换为 PDF 文件吗?许多 word 文档处理应用程序提供将 Word 转换为 Pdf 文件格式的功能。但是这整个过程需要努力安装应用程序以及许可成本。但是,当您只需要执行一项操作时,为什么要为整个产品许可付费。此外,无法使用此类市场可用软件执行批量转换操作。在所有这些情况下,Aspose.Words Cloud API 开始执行简单快速的文件格式处理。
Aspose.Words DOCX 到 PDF 转换器应用程序在开源 Ruby SDK 的帮助下立即将您的 DOCX 文件转换为 PDF 格式。这些 SDK 和工具由 Aspose.Words 的开发人员维护,并提供将 Aspose.Words Cloud API 与您的应用程序集成的最简单方法。使用这个免费的 Ruby SDK 工具,您可以轻松地将 DOCX 文件转换为 PDF 文件。 Aspose.Words 帮助您将 DOCX 文档立即高保真地转换为 PDF。使用 Aspose Cloud REST API 可以执行高级文件格式处理。此外,您可以在本页底部找到生成的即用型 cURL 代码片段示例。
Aspose 支持多种选项,用于将文档自动化集成到多种平台和编程语言的应用程序中。在本文中,我们将详细讨论以下主题。让我们探索。
- DOC 到 PDF 转换 API
- 如何安装Aspose.Words Ruby SDK?
- Aspose.Cloud 账户订阅说明
- Ruby 中的 Word 到 PDF 转换器
- 使用 cURL 命令将 Word 转为 PDF
DOC 到 PDF 转换 API
Aspose.Words 文档转换器允许您将文件从 DOCX 高质量地转换为 PDF。 Aspose.Words Cloud API 支持许多不同的文件格式,如 DOC、DOCX、DOCM、DOTX、RTF、ODT、 OTT 等等。这是一个令人兴奋的解决方案,可以使用 aspose 转换技术创建、操作和转换领先的 Word 文档格式。您将很快获得非常准确的转换结果。
借助此 API,我们可以执行 Word 到 PDF 以及转换为其他格式的操作,而无需使用 MS Office 自动化或任何其他依赖项。为了方便我们的客户,我们开发了特定的编程语言 SDK,以便您可以直接在您的应用程序代码中访问 API。在本文中,我们的重点是 Aspose.Words Cloud SDK for Ruby,它使 Ruby 开发人员能够以零初始成本在 Ruby 应用程序中快速轻松地实现 Word 文档处理功能。
如何安装Aspose.Words Ruby SDK?
为了使用 Ruby SDK 与 Aspose.Words Cloud REST API 进行通信,我们首先需要在我们的系统上安装它。 Ruby SDK 可作为 RubyGem(推荐)和 GitHub 以零初始成本下载。配置 Ruby 运行时后,请在终端中执行以下命令,以在 Ruby 应用程序中快速轻松地安装 word docx 到 pdf 转换器。
gem 'aspose_words_cloud', '~> 22.3'
# or install directly
gem install aspose_words_cloud
但在继续安装 Aspose.Words Cloud SDK for Ruby 2.6 或更高版本之前,您需要在系统上安装以下依赖包。
# Following are the runtime dependencies to setup aspose_words_cloud
faraday 1.4.3 >= 1.4.1
marcel 1.0.1 >= 1.0.0
multipart-parser 0.1.1 >= 0.1.1
# Development dependencies is
minitest 5.14.4 ~> 5.11, >= 5.11.3
此 SDK for Ruby 支持 20 多种文档相关格式,具有完整的读写访问权限。更多详细信息,请访问aspose cloud 文档网站。
Aspose.Cloud 账户订阅说明
安装完Ruby环境的所有依赖包后,下一步就是获取ClientID和ClientSecret详情,调用Aspose.Words云API进行Doc转Pdf。有两个选项可以直接通过一些 rest 客户端(如 cURL)或使用云 SDK 来使用 REST API。因此,第一步是通过导航 Aspose.Cloud 仪表板 创建一个帐户。如果您有 Google 或 Microsoft 帐户,则只需单击 Google 或 Microsoft 按钮即可注册。否则,请通过提供所需信息点击注册链接以创建新帐户。
登录云空间仪表板后,单击左侧栏中的“应用程序”选项卡。现在向下滚动,单击创建新应用程序按钮,如下图所示。
现在通过选择默认存储来创建新应用程序,如下图所示。您还可以按照如何配置第 3 方云存储 指南配置第三方存储以上传您的数据文件。
现在,向下滚动到客户端凭据部分以复制客户端 ID 和客户端密码,如下图所示。
这些客户端凭证将用于对 DOCX 到 PDF 转换器的 Aspose.Words 云 API 进行 API 调用。接下来,我们将看到如何使用 Aspose.Words cloud SDK for Ruby 将 Word 转换为 PDF。
Ruby 中的 Word 到 PDF 转换器
按照下面给出的说明使用 Ruby SDK for ruby on rails 应用程序执行 MS Word 文件 DOCX 到 PDF 的转换。
- 第一步是创建 ruby 变量,其中包含从 aspose 云仪表板 复制的 ClientID 和 ClientSecret。
- 其次,创建 AsposeWordsCloud 配置并传递 ClientID、ClientSecret 值。
- 第三步是创建 WordsAPI 实例
- 接下来,使用 UploadFileRequest() 方法将源 DOCX 文件上传到云存储
- 现在,创建一个 ConvertDocumentRequest() 对象,它将输入的 DOCX 名称、结果格式作为参数
- 最后,使用 convertdocument() 方法启动 DOCX 到 PDF 的转换过程。
# 加载gem,请到https://github.com/aspose-words-cloud/aspose-words-cloud-ruby
require 'aspose_words_cloud'
# 如何以编程方式将 Word 转换为 PDF。
# 从 https://dashboard.aspose.cloud/applications 获取 AppKey 和 AppSID 凭证
@app_client_id = "######-####-####-####-#########"
@app_client_secret = "##########################"
# 将配置属性与 WordsApi 相关联
AsposeWordsCloud.configure do |config|
config.client_data['ClientId'] = @app_client_id
config.client_data['ClientSecret'] = @app_client_secret
end
# 创建 WordsApi 实例
@words_api = WordsAPI.new
# 输入 DOCX 文件
@fileName = "mysample.docx"
# 最终文件格式
@format = "pdf"
# 将原始文档上传到您选择的云存储
@words_api.upload_file UploadFileRequest.new(File.new(@fileName, 'rb'), @fileName, nil)
# 定义文档转换参数initialize(document, format, out_path, file_name_field_value, storage, fonts_location)
@request = ConvertDocumentRequest.new(File.new(@fileName, 'rb'), @format, nil, nil, nil, nil)
# 启动 DOCX 到 PDF 的转换过程
@result = @words_api.convert_document(@request)
puts @result.to_s.inspect
# 在控制台中打印结果响应
puts("Document successfully converted to pdf")
# 结束文档转换示例
结果 mysample.pdf 将保存在项目文件夹的根目录下。
使用 cURL 命令将 Word 转为 PDF
现在我们来看看如何使用 cURL 将 word 文档转换为 pdf。 cURL 命令行工具用于访问与服务器之间的 REST API。由于 Aspose.Words Cloud API 是按照 REST 原则开发的,因此我们可以使用这些 Cloud API 来进行转换操作。为了执行转换,我们将根据从 Aspose.Cloud dashboard 检索到的 ClientID 和 ClientSecret 生成 JSON Web Token (JWT)。请在终端中执行命令以生成如下所示的 JWT 令牌。
curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=######-####-####-####-######&client_secret=#########################" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"
现在我们将在下面的命令中使用 JWT 令牌将 Word 转换为 PDF 格式,其中输入的 DOCX 文件应该在云存储上可用。然后 outPath 参数显示生成的 PDF 文档的位置,格式是生成的 pdf 文件的格式。 GetDocumentWithFormat API 用于文档转换,doc-to-pdf.doc 文件成功呈现为 PDF 格式。您可以在云存储中查看以 doc-to-pdf.pdf 名称保存的文件。
curl -X GET "https://api.aspose.cloud/v4.0/words/test_multi_pages.docx?format=pdf&outPath=doc-to-pdf.pdf" \
-H "accept: application/octet-stream" \
-H "Authorization: <PASTE HERE JWT Token>"
结论
在上面的文章中,使用 Aspose.Words Cloud SDK for Ruby 逐步解释了与 Word 到 PDF / DOCX 到 PDF / DOC 到 PDF 相关的所有细节。 Aspose Cloud SDK 是开源的(在 MIT 许可下发布),Aspose.Words cloud SDK for Ruby 的完整代码可在 GitHub 上获得。
如果您对最佳 DOCX 到 PDF 转换器有任何问题、建议或意见,请随时访问支持 论坛。您可以在社交媒体 Facebook、LinkedIn 和 Twitter 上关注我们。
探索
我们还建议访问以下相关链接: