HexoPress 的媒体功能已经不只是一个简单的图片列表。现在的媒体库由 图片分组列表、媒体详情页 和 文件列表 组成,重点解决的是图片变体管理、引用追踪和快速插入。
进入媒体库
点击左侧导航栏的「媒体库」即可进入。页面分为两个标签页:
- 图片:按图片资源分组展示
- 文件:列出
source目录下的其他非图片文件
图片列表:先看“组”,再看“变体”
图片标签页会把同名但不同格式或尺寸的图片归为一组。例如同一张图的 cover.png、cover.webp、cover@2x.png 会集中显示在同一张卡片上。卡片展示的是代表图和该组包含的变体数量。
插图:请插入媒体库图片标签页截图,展示图片卡片网格和“X 个尺寸”信息
这种分组方式非常适合管理响应式图片、多格式输出或手动导出的不同尺寸资源。
媒体详情页
点击任意图片卡片,会进入该组图片的详情页。这里会展示:
- 代表图片的预览
- 文件大小
- 图片尺寸
- 创建时间和更新时间
- 在浏览器中直接打开资源
页面下方还有一个变体表格,列出这一组里的所有文件。
对单个变体执行操作
在变体表格中,你可以对每个文件执行:
- 打开:在浏览器中查看原图
- 查看引用:查找有哪些文章引用了这张图片
- 删除:删除单个变体文件
插图:请插入媒体详情页截图,展示顶部描述信息和下方变体表格
查看引用
“查看引用” 会弹出一个对话框,列出引用当前图片的文章。你可以直接从这里跳转回编辑器继续修正文章内容。
如果没有文章引用该图片,对话框会明确提示这一点,并允许你进一步决定是否删除当前图片。
这比手动在博客目录里全文搜索文件名要可靠得多,尤其适合清理历史遗留素材。
删除行为说明
HexoPress 当前会在删除前给出风险提示:该文件可能仍被文章引用。也就是说,删除动作是允许的,但系统会先提醒你确认风险,而不是静默删除。
当前可直接删除的常见格式包括:
- PNG
- JPG / JPEG
- WebP
- GIF
- SVG
文件标签页
文件标签页用于浏览 source 目录下的非图片资源。这里更适合查看下载文件、附件或其他静态资源的路径与更新时间。
插图:请插入文件标签页截图,展示表格视图
和编辑器联动
媒体库之外,编辑器本身也有一个媒体侧边面板:
- 支持搜索图片
- 支持预览图片尺寸和路径
- 双击即可把 Markdown 图片语法插入到当前光标位置
此外,你还可以把本地图片直接拖进编辑器。HexoPress 会弹出上传对话框,默认按年月写入 source/images/YYYY/MM/,上传完成后自动把图片 Markdown 插入正文。
这让“上传图片 + 拿到正确路径 + 插入正文”变成一个连续操作,而不再需要手工复制文件和拼接相对路径。