导出为 PDF - 概述

CKEditor 云服务提供快速且高度可扩展的服务，使用户能够将文档导出为 PDF 文档。该功能作为一项服务提供，可以使用户将 HTML 字符串直接发送到云服务服务器，以便更高级的使用，或作为便捷的所见即所得编辑器插件，以便在需求较低的情况下更易于使用。

这是一个高级功能。您可以在这里购买许可证或联系我们以获取定制报价。如果您有任何反馈或问题，请告知我们！

如果此功能在未经身份验证的情况下使用，则生成的文档将带有水印。

# 分页功能

CKEditor 5 的补充高级分页功能使您能够在文档导出为 PDF 后查看页面的断点。得益于实时预览，用户在编辑时能够微调输出文档的结构。除此之外，分页功能还显示页面计数，并允许轻松地在文档页面之间导航。

HTML 到 PDF 转换器提供了一个 API，用于将 HTML 文档转换为 PDF 文件。该服务生成一个文件并将其返回给用户，以便他们可以在磁盘上将其保存为 .pdf 格式。要将该功能集成到您的环境中，请首先查看快速入门指南以开始使用它。

您还可以使用导出为 PDF 演示页面测试该功能。

使用转换器服务时，可以使用以下选项

至少需要一个 html、options.header_html 或 options.footer_html 参数才能生成 PDF。

这些参数中的任何一个都不能包含带有刷新文档间隔的 <meta> 标签。

如果要直接使用此 API，则需要手动提供正确的 CSS 代码。要实现这一点，您应该传递一个字符串，该字符串是默认编辑器样式（请参阅 CKEditor 5 的内容样式指南）和（可选）您的自定义样式到 css 属性。使用默认编辑器配置，您无需指定 options 属性。

任何符合 HTML 规范的内容都可以发送到转换器。

该 API 仅接受使用 UTF-8 编码的内容进行转换。

此选项用于发送自定义 CSS 样式。

与 HTML 一样，CSS 必须使用 UTF-8 编码。

如果您不能使用 UTF-8，并且希望请求对其他字符集的支持，请联系我们。

PDF 选项使您可以设置输出文件的页眉、页脚、边距和页面格式。还有 wait_time 参数来控制渲染时间。

有关这些选项的语法和用法的详细信息，请参阅转换器文档。

图像可以使用 <img> 标签的 src 属性从 URL 或 Base64 编码插入。

要生成 PDF 文档，您可以像在普通浏览器中一样使用网络字体。您需要指定字体文件的 URL 或转换为 Base64 格式的字体文件。

请注意，网络字体在页眉和页脚正文和样式中均不受支持。
对于页眉和页脚，请使用默认字体之一。

有关详细信息和示例，请参阅转换器文档。

导出为 PDF CKEditor 插件使您可以轻松地将所见即所得编辑器的内容打印到 PDF 文件。启用此功能后，该功能会将编辑器的内容以及用于显示它的样式发送到 CKEditor 云服务 HTML 到 PDF 转换器服务。然后，该服务会生成一个 PDF 文档，用户可以下载。

得益于此插件，只需单击一下按钮即可获得与 CKEditor 所见即所得编辑器中显示的方式相同格式化的内容的 PDF 文件。一个易于集成的解决方案，无需在编辑后进一步处理编辑器数据。

导出为 PDF 是一项服务，它根据客户提供的数据（HTML、CSS）生成 PDF 文件。要执行转换，它需要从编辑器或数据库发送的数据，但该服务本身是完全无状态的。

数据（尤其是您的敏感数据：HTML、CSS、注释）仅在处理期间使用。但是，我们会存储一些用于计费和维护我们系统所需的信息。我们尝试将存储的数据减少到必要的最小值，目前我们存储诸如导出次数和持续时间、最终文档大小、唯一导出次数、统计数据（使用功能、IP 地址、编辑器版本）等信息。

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