以 Hugo Module 形式集成到 Hugo 站点
gallerydeluxe — Hugo 启动器模板
作者 bep
gallerydeluxe 是一个以 Hugo Module 形式使用的照片画廊主题,适合在页面中展示大量图片,并提供打乱顺序、反转顺序、Exif 信息与水印等配置项。
看看你的网站会是什么样
浏览真实页面截图,比较内容排版与手机效果。点击下方缩略图切换,放大查看整页细节。
目前有 1 张原始预览,可打开完整图片查看设计细节。
截图用于了解视觉与布局,交互效果请以实际项目为准。
值得关注的模板亮点
从已有项目资料中,快速了解它的特点。
面向大量图片展示的照片画廊主题
支持打乱或反转画廊中图片的顺序
可启用 Exif 数据展示
可为大图配置水印图片及位置
缩略图生成逻辑可通过复制模板文件自行调整
模板详细介绍
gallerydeluxe 是一个 Hugo 模块,用于在 Hugo 站点中展示照片画廊。它面向图片数量较多的场景,作者在 README 中说明其适用于大量图片展示,并提到该主题用于 staticbattery.com。
使用方式上,README 推荐以 Hugo Module 的形式把该主题加入站点,并指向 Gallery Deluxe Starter 作为快速上手模板,staticbattery.com 的仓库是另一个示例。如果需要多个画廊,README 建议改用 Galleries Deluxe。
配置集中在 params.gallerydeluxe 下,可设置是否打乱图片顺序(shuffle)、是否反转图片顺序(reverse)、是否启用 Exif 数据(enable_exif),以及为大图添加水印(watermark.image、watermark.posx、watermark.posy)。水印图片路径相对于 /assets,位置可选 left/center/right 与 top/center/bottom。
若需要完全控制图片生成方式,README 说明可以把 layouts/partials/gallerydeluxe/create-thumbs.html 复制到自己的项目中并调整。README 的 Credits 部分注明使用了 Dan Schlosser 的 Pig JS 库。
适合你的项目吗?
适用场景
- 在 Hugo 站点中搭建以图片为主的照片画廊页面
- 需要展示大量照片并希望控制图片排列顺序
- 希望在画廊大图上叠加水印
- 希望展示照片 Exif 信息
适合人群
- 使用 Hugo 并熟悉 Hugo Module 的开发者
- 以照片展示为主要内容的个人或作品站点
- 需要单画廊而非多画廊结构的项目
上手与定制指南
结合仓库当前版本的说明,按下面的资料检查内容、配置与运行要求。
- 1
README 推荐以 Hugo Module 方式引入,可参考 Gallery Deluxe Starter 快速起步
- 2
需要多个画廊时应改用 Galleries Deluxe,而不是本主题
- 3
画廊相关选项在 params.gallerydeluxe 下配置,包括 shuffle、reverse、enable_exif 与 watermark
- 4
水印图片路径相对于 /assets,位置由 posx 与 posy 指定
- 5
如需完全控制图片生成,可复制 layouts/partials/gallerydeluxe/create-thumbs.html 到自己的项目并修改
授权与来源资料
使用条件与限制
免费使用 · 保留许可声明本次收录的是公开仓库中采用 MIT 许可的免费版本;免费范围为该版本代码,不代表外部服务或第三方素材免费。
使用时需要遵守
- 允许免费使用、修改、商用和分发该版本代码。
- 分发代码副本或实质性部分时,保留原作者版权声明和完整 MIT 许可声明。
- 代码按现状提供;担保与责任限制以原许可证及适用法律为准。
额外费用与待核对事项
- 本主题仅支持单个画廊;若站点需要多个画廊,README 明确要求改用另一个项目 Galleries Deluxe,因此多画廊场景不适用本模板。
- 使用方式依赖 Hugo 及其 Module 机制,需在 Hugo 站点中以 Hugo Module 形式引入,并非可脱离 Hugo 独立部署的通用模板。
- 项目内使用了第三方 JS 库 Pig(pig.js),其版权归 Dan Schlosser;该第三方组件的许可与项目自身 MIT 许可相互独立,使用者需自行确认其许可条件。
- 演示图片、字体、图标及其他第三方素材需按各自许可核对,不能仅凭代码的 MIT 许可判断。
- 域名、托管、数据库、支付或 AI 等外部服务可能另外收费。
查看原文依据
Permission is hereby granted, free of charge
许可证原文
If you need _multiple_ galleries, see [Galleries Deluxe](https://github.com/bep/galleriesdeluxe).
README 原文
The recommended way to add this to your site is to include it as a Hugo Module.
README 原文
https://github.com/bep/gallerydeluxe/blob/main/LICENSEhttps://github.com/bep/gallerydeluxe/blob/main/README.mdCredit to Dan Schlosser for the [Pig](https://github.com/schlosser/pig.js) JS library.
README 原文
DeepSeek 根据仓库许可证和 README 整理 ·2026-10-02。结果仅覆盖已读取资料,依赖、图片、字体及后续条款变更以各自原文为准。
项目核对记录与介绍依据
模板资料
- 来源平台
- Hugo Themes
- 资料与维护参考分
- 资料较完整 · 79 / 100
- 技术栈
- Hugo
- 网站类型
- 启动器
这个分数如何计算
本站按许可资料(最高30分)、演示链接(12分)、预览图(10分)、Star数(15分)、记录的维护时间(15分)、描述完整度(8分)、功能记录(5分)和分类资料(5分)计算。它不是代码、安全或性能测试,也不是 Google 评分;有链接不代表已实测可用。
这个项目需要核对什么
- 记录的仓库更新时间
- 2026-09-18
- 截图检查日期
- 2026-10-02
目前没有记录演示链接。请依据仓库说明在本地评估;仅凭截图无法确认交互行为。
目录记录的主要技术栈是 Hugo。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料,不代表代码审计或部署实测。
查看具体选型方法 →介绍的制作与核对状态
介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。
已完成服务器许可规则与 AI 来源核对;未经过人工编辑审核。
查看当时使用的来源资料
SHA-256: 68efc035ff5f11b16a9dcffd195b0c62dc1f22689c6fe98d079db6f5bc64f22b
2026-10-02T18:06:46.653Z
来源文件 / 仓库>**Note 1:** See this [Gallery Deluxe Starter](https://github.com/bep/gallerydeluxe_starter) for a fast route to get this up and running.
>**Note 2:** If you need _multiple_ galleries, see [Galleries Deluxe](https://github.com/bep/galleriesdeluxe).
<hr/>
* [Configuration](#configuration)
* [Credits](#credits)
A Hugo Module to show a photo gallery. It's very fast/effective, especially if you have lots of images on display.
This theme is what you see on [staticbattery.com](https://staticbattery.com/) which, at the time of writing this, [scores 100](https://pagespeed.web.dev/report?url=https%3A%2F%2Fstaticbattery.com%2F&form_factor=mobile) at Google PageSpeed for both mobile and desktop.
[<img src="https://raw.githubusercontent.com/bep/gallerydeluxe/main/images/tn.jpg">](https://staticbattery.com/)
## Configuration
The recommended way to add this to your site is to include it as a Hugo Module. See [Gallery Deluxe Starter](https://github.com/bep/gallerydeluxe_starter) for a starter template. Another example is [staticbattery.com](https://github.com/bep/staticbattery.com).
### Params
```toml
[params]
[params.gallerydeluxe]
# Shuffle the images in the gallery to give the impression of a new gallery each time.
shuffle = false
# Reverse the order of the images in the gallery.
reverse = false
# Enable Exif data in the gallery.
# See https://gohugo.io/content-management/image-processing/#exif-data for how to filter tags.
enable_exif = false
# Optional watermark file for the large images.
[params.gallerydeluxe.watermark]
image = "images/gopher-hero8.png" # relative to /assets
posx = "left" # one of "left", "center", "right"
posy = "bottom" # one of "top", "center", "bottom"
```
If you want full control over how your images gets created, create and adjust a copy of [layouts/partials/gallerydeluxe/create-thumbs.html](layouts/partials/gallerydeluxe/create-thumbs.html) into your own project.
## Credits
Credit to Dan Schlosser for the [Pig](https://github.com/schlosser/pig.js) JS library.
看看同类模板
对比同技术栈与用途的模板,找到更适合的视觉与内容结构。

hugo-xmin
eXtremely Minimal Hugo theme: about 140 lines of code in total, including HTML and CSS (with no dependencies)
Hugo · 启动器

hugo-theme-gallery
Gallery Theme for Hugo
Hugo · 启动器

reveal-hugo
📽️ Create rich HTML-based presentations with Hugo and Reveal.js
Hugo · 启动器

anatole
Anatole is a minimalistic two-column theme for Hugo.
Hugo · 启动器

hugo-theme-diary
Moments piled up. A Hugo theme ported from SumiMakito/hexo-theme-Journal.
Hugo · 启动器

risotto
A minimalist, responsive hugo theme inspired by terminal ricing aesthetics.
Hugo · 启动器
