Hugo 主题
鱼鹰的喜悦
速度极快且模块化的主题,非常适合展示您的作品。

概述
鱼鹰的喜悦是自由思想艺术家的选择,它提供了无杂乱且速度极快的单页作品集。
它非常适合展示您令人惊叹的作品!
它的味道与伟大的鱼鹰主题略有不同,并为您的喜悦添加了令人惊叹的模块化功能。
展示
了解鱼鹰的喜悦在现实世界中的表现
- Hugo Mods - 此主题围绕网站上展示的 Hugo Mods 构建。此站点还提供了完整的源代码。
- Protonaut Music - 音乐家和顶级贡献者,其高度可识别的网站由该主题启动。
- KDEVO - 如果我不亲自运行此主题以确保一切顺利运行,那就不是我了。
功能
- 模块化并由可扩展的节构建块组成
- 关于:介绍你自己
- 图库:使用基于网格的图库展示您的作品,其中包含交互式模态框
- 博客:轻量级博客功能
- 联系方式:带有 Basin 支持和内置防垃圾邮件机器人的联系表单
- 使用您的高质量图像素材
- 延迟图像加载以及使用 lazyimg 模块进行完全自动的调整大小
- 使用自动低质量图像占位符 (LQIP) 的模糊技术
- 具有旧浏览器回退的现代 WebP 支持
- 搜索引擎优化
- 在 PageSpeed Insights 中获得 100 分。每一个细节都经过了精心调整,以提高性能!
- 自动生成的结构可确保每个人都能找到您
- 令人愉悦的用户体验
- 在不同的主题之间选择
- 通过 icons 模块在页脚中显示很棒的社交图标
- 平滑滚动和滚动侦听器
- 自动获取 GitHub 存储库数据
- 为禁用脚本/禁用 JavaScript 的用户提供合理的后备方案
- 高度可自定义 - 无需维护 fork!
总的来说,原始主题的许多未解决的问题已得到解决,代码也已重写。
贡献并表示您的支持
如果您喜欢这个项目,可以通过多种方式来表示您的支持
- ❤️ 成为赞助商
- ⭐ 为项目加星,以确保每个人都能找到它
- 开始贡献
快速入门
请确保已安装 Hugo 的扩展版本和 Go。如果您是 Hugo 的新手,请访问文档以获取更多信息和常规站点设置。
将您的存储库初始化为模块(替换 <用户名>
和 <项目名称>
)
hugo mod init github.com/<username>/<projectname>
下载已记录的配置文件,例如,通过 curl
curl https://raw.githubusercontent.com/kdevo/osprey-delight/master/exampleSite/config.yaml -O
继续阅读配置选项。
升级
接收主题的最新功能
hugo mod get -u
在升级之前检查发行说明是一种好习惯。
配置和使用
最好是简单地查看完全注释的配置文件。此主题遵循边做边学的学习方法。
图像
此主题是资产驱动的!它“知道”如何处理您的宝贵资产,并且通常不需要手动调整大小。为了使其正常工作,请在 assets
目录中提供以下所有图像(不要使用 static
目录)。
下表显示了有关所需资产的建议
图像类型 | 配置键 | 最小宽度 | 备注 |
---|---|---|---|
徽标 | logoBig (config.yaml) | 200px | 透明,最小边距顶部/底部 |
导航栏徽标 | logoSmall (config.yaml) | 96px | 透明,小边距顶部/底部,首选正方形格式 |
图库 | image (content/gallery/*) | 400px | 透明,中等边距顶部/底部/左/右,首选正方形或横向格式 |
背景 | background (config.yaml) | 1920px | 可选,使用高质量的 JPG |
内容文件
关于部分
要创建在主页上呈现的关于部分,请运行
hugo new about.md
图库项目
要创建新的图库项目,请运行
hugo new gallery/my-item.md
您将获得一个完整的文档文件,其中单独描述了每个配置选项。
联系表单
Basin 是此主题使用的免费 AJAX 联系表单服务。
要进行设置
- 注册一个免费帐户并创建一个表单。
- 将表单的 URL 端点复制并粘贴到
ajaxBasin
config.yaml 参数中。 - 在 Basin 仪表板上选择
通过 AJAX 提交此表单
选项。
启用防垃圾邮件机器人保护
在“设置”→“设置自定义蜜罐字段”下,输入 _anti_spam_honeypot
。Basin 将忽略所有包含此特定字段的消息。这应该有效,因为有一个用户通常不使用的隐藏字段,但垃圾邮件机器人会盲目地输入他们的数据。
请不要勾选“reCAPTCHA”复选框,不支持此服务,而且通常也没有必要。
了解更多
自定义它
想要完全控制外观?查看如何更精细地自定义主题。
需要帮助?
这个主题有一个由 GitHub 驱动的社区论坛!请在问答中随意提问(请确保完整阅读文档和现有讨论/问题)。
需要帮助
此 README 可能需要针对最新功能进行一些文档改进。 欢迎对此提出任何 PR。另请查看如何贡献!