README

适用于 Craft CMS 5 的 PDF 转换

PDF 转换是一个 Craft CMS 插件，可以将存储在资产中的 PDF 转换为图像。然后可以通过 Twig 在模板中输出。

这个用例是在用户下载特定文件之前显示 PDF 预览。

您还可以通过在 Craft 管理控制面板的插件商店中搜索 PDF 转换 来安装插件。

要转换 PDF 为图像，请使用以下 Twig 标签

{% set pdfToTransform = entry.pdfAsset.one() %}

{% set transformedPdf = craft.pdfTransform.render(pdfToTransform) %}

{{ transformedPdf.one().url }}

转换后的 PDF（现在存储在资产中的图像）可以使用 {{ transformedPdf.one().url }} 输出。或者获取任何资产属性，例如 title、id、filename 等。

如果转换后的图像不存在，则 PDF 将通过模板进行转换。这可能会导致模板/页面在 PDF 转换期间变慢。

请注意，这也可能输出一个大型图像，因此我们建议运行图像转换。请参阅尺寸。

该插件通过名为 pdf-to-image 的 PDF 库运行 PDF。它们在 Imagick 中存在已知问题，如果 Ghost Script 无法通过 Imagick 访问，转换可能会失败（非常容易解决）

PDF 转换的基本功能是将您的 PDF 转换为单个图像。它永远不会设置宽度和高度维度（除了图像分辨率）。

我建议运行 PDF 图像通过以下选项/插件之一，并设置尺寸（其中一些也处理图像缓存）

如果您有任何问题（当然不会有！），我会尽快回复。如果这是一个网站崩溃-哦不-发生了什么事的时候，请通过 Craft CMS Discord - @bymayo 联系我。