KITA

Halo PDF 插件

薛柔零 薛柔零 261
分类记录
标签Halo
Halo PDF 插件
本文演示用的 PDF 区块已迁移：原先由 Halo PDF 插件提供的编辑器区块（<div data-type="pdf" data-src="…"></div>）已替换为「文章组件」的 PDF 组件 <xhhao-com-pdf>，在线预览、缩放、分页导航与下载能力保持不变；下方关于「Halo PDF 插件」编辑器用法的说明仍然有效。https://github.com/AR-26710/halo-plugin-pdf

功能特性

  • 编辑器集成：在 Halo 富文本编辑器中以 Tiptap 扩展形式嵌入，通过工具栏按钮、斜杠命令或工具箱面板即可插入 PDF 区块

  • 多种来源：支持从 Halo 附件库选择 PDF 文件，或直接使用外部链接

  • 在线预览：基于 PDF.js 渲染，支持缩放、分页导航、下载功能

  • 明暗主题：自动适配主题的浅色/深色模式

  • 无刷新兼容：自动适配 pjax / swup ，页面切换后 PDF 预览仍然正常工作

安装

  1. 从 Releases 页面下载最新版本的 JAR 文件

  2. 在后台「插件管理」中安装插件

使用方式

  1. 在 Halo 后台进入文章或页面编辑器

  2. 点击工具栏中的「插入 PDF」按钮，或通过工具箱面板、斜杠命令（输入 /pdf）插入

  3. 在弹出的 PDF 设置面板中，你可以：

    • 点击「从附件库选择」选取已上传的 PDF 文件

    • 点击「外链地址」输入外部 PDF 链接

  4. 配置完成后，PDF 预览区块将显示在编辑器中，发布后访问者即可在文章/页面中在线预览 PDF

预览