guide从 Word 导入 - 概述

CKEditor 云服务提供了一种快速且高度可扩展的服务,使用户能够将内容从 Microsoft Word 导入到 HTML。该功能作为一项服务提供,可以使用户将 Word 文件直接发送到云服务服务器,或直接将其与 CKEditor 5 WYSIWYG 编辑器插件 集成,该插件开箱即用地集成了该功能。

这是一个高级功能,您需要订阅才能使用它。您可以 在这里购买 用于您的开源 CKEditor 实现。如果您需要:

  • CKEditor 商业许可证用于您的应用程序。
  • 您需要服务的本地部署(自托管)版本。
  • 您还有其他许可问题。

您也可以注册 CKEditor 高级功能 30 天免费试用

# 从 Word 导入功能的工作原理

DOCX 到 HTML 转换器提供了一个 REST API,用于将 Microsoft Word 文件转换为 HTML 文档。该服务会生成 HTML 数据并将其返回给 API 消费者,使其能够在浏览器或 CKEditor 5 实例中显示它。它可用于自动化 Word 文件的转换,并允许在不使用编辑器的情况下批量转换文档。

这里您可以看到一个包含一些基本格式的简单 Word 文档

A simple document with formatting in Word.

而这里则是同一个示例文档,但已经被导入到 CKEditor 5 中。所有格式都被保留了。

A simple document imported into CKEditor 5.

要将该功能集成到您的环境中,首先查看 快速入门 指南以开始使用它。

您还可以使用 从 Word 导入演示页面 测试该功能。

# 支持的文件类型

从 Word 导入功能支持以下文件类型

  • Microsoft Word .docx
  • Microsoft Word 模板 .dotx

如果您想看到其他文件类型支持的引入,请 联系我们

# 使用 REST API 与服务交互

DOCX 到 HTML 转换器的 REST API 是一种 HTTP API 服务,允许您将 Word 文件转换为 HTML。无论您只是不使用 CKEditor 5,还是想将数据库中的许多 Word 文档迁移到 HTML,您都可以使用 API 将前端或后端应用程序与从 Word 导入功能集成。

该服务将保留 Word 文档中的所有格式和样式,包括协作功能和文档设置等高级功能。

请查看 快速入门 指南,了解有关如何在您的应用程序中集成 REST API 的更多信息。

# 从 Word 导入编辑器插件

从 Word 导入 CKEditor 插件 允许您轻松地将 Word 文件导入到您的内容中,同时保留格式和富媒体。启用此功能后,它会负责与 MS Word 文件转换器的通信,让您在编辑器中享受 Word 文档。

由于有了这个插件,您只需上传一次,就可以继续编辑在 Word 中创建的内容,而不会中断。

# 粘贴与导入的区别

CKEditor 5 WYSIWYG 编辑器还提供了一个更简单的 从 Office 粘贴 插件,它允许您将内容从 Microsoft Word 粘贴到您的编辑器中,并保持原始结构和格式(前提是编辑器设置支持格式化功能)。

请查看 功能比较 指南,了解有关从 Word 粘贴和从 Word 导入功能之间差异的更多信息。

# 支持的功能

有关从 Word 导入功能可以正确转换的所有支持功能的最新列表,请查看专门的 支持的功能 指南。

# 存储的数据

从 Word 导入转换器是一项服务,它根据客户提供的 .docx 文件生成一个 HTML 文档。为了执行转换,它需要将数据从从 Word 导入插件或通过 REST API 发送,但服务本身是完全无状态的。

数据(尤其是您的敏感数据:输入文件、转换后的 HTML、评论、建议)仅在请求处理期间使用,不会存储。但是,我们确实存储了一些用于计费和维护系统所需的信息。我们努力将存储的数据量减少到所需的最小值,目前我们存储的信息包括导入次数和持续时间、最终有效负载大小、唯一导入次数和统计数据(IP 地址、编辑器版本)。

与处理请求相关的日志仅在发生意外情况时才会保存,并存储 14 天。日志中的数据包括错误消息、堆栈跟踪和有关请求的信息。