guide从 Word 导入 - 快速入门

本文旨在帮助您在 CKEditor 高级功能免费试用中快速上手从 Word 导入功能。

请按照以下步骤操作

# 订阅 CKEditor 高级功能免费试用

通过 注册 CKEditor 高级功能免费试用 创建一个帐户。注册后,您将获得访问客户仪表板(CKEditor 生态系统仪表板)的权限。

CKEditor Premium Features free trial sign-up view.

您将被要求检查您最感兴趣的功能。

检查这些功能不会影响试用包内容 - 无论选择什么,所有功能都将可用。我们只是想更好地了解您的需求。

# 登录 CKEditor 生态系统仪表板

登录 CKEditor 生态系统仪表板。您将收到一封确认电子邮件,并被要求为您的帐户创建密码。请妥善保管密码。

# 帐户仪表板

登录后,点击左侧“您的产品”标题下的“CKEditor”。您将看到订阅参数概述,以及下面的管理区域。

Your CKEditor trials view in the customer dashboard.

# 创建令牌端点

在您开始使用新激活的 CKEditor 高级功能免费试用包之前,您需要先在您的应用程序中创建一个 安全令牌端点。该端点的作用是安全地授权您的应用程序的最终用户仅在他们应该有权访问他们所请求的内容或操作的情况下才能使用 CKEditor 云服务。

# 开发令牌端点(快速便捷)

如果您只是刚开始使用,您可以使用开箱即用的开发令牌端点 URL,它不需要您进行任何编码。开发令牌端点的 URL 可以通过三个简单的步骤轻松获得

  1. 要使用 CKEditor 高级功能(如从 Word 导入),您需要创建一个环境。环境允许您创建访问凭据、管理 Webhook、配置功能并连接到 CKEditor 云服务。您可能拥有多个环境来服务于不同的实例或集成。从环境列表中选择您要管理的环境。

    Environments list.

    如有必要,请参考 环境管理指南

  2. 选择环境后,按下“CKEditor 配置”选项卡中“开发令牌 URL”部分的“生成”按钮

    Press the button to generate the development token URL.

    开发令牌 URL 将显示在“开发令牌 URL”部分

    CKEditor configuration with the development token URL.

    开发令牌端点是一个特殊的端点,可帮助您开始使用 CKEditor 云服务。它提供对服务的无限制、完全访问权限,并在首次使用后 30 天过期。您不应在生产环境中使用它。任何知道此 URL 的人将拥有与关联环境完全访问权限。

# 编写您的令牌端点(高级用户)

如果您使用的是开发令牌端点,请跳过此步骤。

要编写您自己的 安全令牌端点,您需要通过转到“访问凭据”选项卡并点击“创建一个新的访问密钥”按钮为所选环境创建访问凭据。

环境管理指南的创建访问凭据 部分了解更多信息。

# 将从 Word 导入功能集成到编辑器中

要将插件安装到您的 WYSIWYG 编辑器中,请使用 在线构建器 生成一个启用该插件的自定义 CKEditor 5 构建。或者,请参考插件文档中的 安装指南,自行进行安装。

使用之前生成的令牌配置插件,将链接粘贴到配置中

import { ClassicEditor } from 'ckeditor5';
import { ImportWord } from 'ckeditor5-premium-features';

ClassicEditor
    .create( document.querySelector( '#editor' ), {
        plugins: [ ImportWord, /* ... */ ],
        toolbar: [ 'importWord', /* ... */ ], // Depending on your preference.
        importWord: {
            // Import from Word configuration.
            // ...
        }
    } )
    .then( /* ... */ )
    .catch( /* ... */ );

访问 CKEditor 5 从 Word 导入插件 指南,了解有关这些配置选项的更多详细信息。

# 使用 REST API 服务

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

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

请查看 快速入门 指南,详细了解如何将 REST API 集成到您的应用程序中。