Hugo 主题
Kayal
Kayal 是一个 Hugo 主题,旨在为个人博客网站提供极简、轻量级且具有 markdown 风格的美感。
🌐演示站点
桌面 | 移动 |
---|---|
![]() | ![]() |
演示站点的源代码可在 exampleSite 分支中找到。
特性
- 简洁且响应式设计
- 浅色和深色模式:根据浏览器偏好和/或手动切换自动调整。
- 个人主页
- 可自定义的配置:轻松调整设置以进行个性化
- 短代码:包括来自第三方网站的标注、Markdown 和代码导入。
- KaTeX 支持
- Mermaid 图表支持
- 由 Fuse.js 驱动的客户端搜索
- 交叉链接:能够在第三方网站上链接帖子。
- RSS Feed
- 目录
- 代码复制
- 标题锚点
- Google Analytics
- 来自 FontAwesome 6 的 SVG 图标
- 对 SEO 友好。
- 面包屑
- 文章封面图片
- 响应式图像优化
- 可扩展性:包括以下占位符
- 自定义主页
- 其他分析
- 评论
- 自定义 CSS
- 自定义头部
- 站点托管资源 / 无 CDN
- 还有更多…
安装
Kayal 支持多种安装方法:作为 git 子模块、Hugo 模块或通过手动安装。
有关如何安装 Kayal 的详细说明,请参见演示站点上的“安装”。这是有关如何将主题安装为 git 子模块的快速指南
在您的 Hugo 站点目录中,运行以下命令
git submodule add -b main https://github.com/mnjm/kayal.git themes/kayal
将配置文件从
themes/kayal/config/_default
复制到 Hugo 项目根目录的config/_default
。在这些文件中进行必要的配置更改。有关更多信息,请参阅演示站点上的“配置”。如果存在
hugo.toml
,请将其删除,然后构建站点。
配置
Kayal 附带的配置文件包含该主题识别的所有可能的设置。默认情况下,许多这些设置都被注释掉了,但您可以简单地取消注释它们以激活或修改。
有关更多详细信息,请参阅演示站点上的“配置”。
贡献
发现错误或有新的功能想法?创建一个 issue 让我知道,或者更好的是,直接提交一个 pull request!
附录
在构建此主题时,我不断参考 Blowfish 和 Hugo-PaperMod 的源代码。使用 markdown 美感的想法来自另一个 Hugo 主题 Archie。
许可协议
此主题在 MIT 许可下发布。