文档内图片缩略显示 - 使用手册 - WLN.WIKI

文档内图片缩略显示

更新于 2025-09-12

功能概述

WLN.WIKI 的文档内图片缩略显示功能可以自动将文档中的大图转换为缩略图展示,点击后查看原图。此功能有效减少页面加载时间,提升文档浏览体验,尤其适用于包含大量高清图片的技术文档和产品手册。

功能特性

图片缩略显示功能提供以下特性:

  • 自动缩略:文档中宽度超过设定阈值的图片将自动生成缩略图,默认阈值为 800px。
  • 点击放大:用户点击缩略图可在弹层中查看原始大图,支持鼠标滚轮缩放和拖拽。
  • 懒加载:图片在滚动到可视区域时才加载,进一步优化页面首屏加载速度。
  • 格式优化:自动将 PNG 图片转换为 WebP 格式(浏览器支持时),减少文件体积。
  • 响应式适配:缩略图尺寸根据屏幕宽度自适应,在移动端和桌面端均有良好展示效果。

配置方法

  1. 进入管理后台「站点配置」→「文档显示设置」。
  2. 找到「图片缩略显示」选项,开启此功能。
  3. 设置缩略图宽度阈值(推荐 600-1200px)。
  4. 选择是否启用懒加载和 WebP 格式转换。
  5. 点击保存,新文档将自动应用缩略图设置。

注意事项

已发布的文档需要手动触发「重新生成缩略图」操作才能应用新设置。缩略图文件存储在服务器的缓存目录中,清理缓存后系统会自动重新生成。如需了解更多配置选项,请访问 WLN.WIKI官方文档。