English | 简体中文
Blowfish 是一个轻量有力的 Hugo 主题。它使用 Tailwind CSS 构建,洁净而富有极简主义,是你网站内容载体的不二之选。
🌏 示例站点
📑 主题文档
💎 周边商店
🐛 Bug 问题报告
💡 问答和功能需求
- 使用 Tailwind CSS 3.0 构建全面响应式布局
- 多种配色方案,亦可完全由你定义
- 夜间模式支持(手动开启/关闭或根据用户设备自动切换)
- 高度自主的配置方式
- 集成 Firebase 以支持动态数据统计
- 集成浏览次数统计和点赞机制
- “相关文章”列表生成
- 多种主页布局
- 多作者模式支持
- 可将文章整理成选集列表
- 禅模式支持
- 可灵活定义各种内容类型、分类标准和菜单
- 页眉和页脚双重菜单可选
- 支持嵌套菜单和子导航菜单
- 支持多语言内容,包括 RTL 语言
- 可链接到第三方网站上的帖子
- 支持多种简码,如图库、时间轴、GitHub 卡片和图片灯箱
- 支持 Buymeacoffee
- 拥有由 Fuse.js 支持的客户端一侧网站搜索功能
- 植入了基于 Mermaid 的图表功能
- 植入了基于 Chart.js 的图表功能
- 集成逼真的自动打字效果
- 集成性能优化的 Youtube 卡片简码
- 集成 KaTeX 的公式
- 集成 FontAwesome 6 的矢量图标引用
- 使用 Hugo Pipes 自动调整图像大小
- 拥有标题锚点、目录、代码复制、按钮、分类徽章等功能
- 文章内部支持 HTML 和 Emoji 🎉
- 便于搜索引擎优化,文章可一键分享到社交媒体
- 支持 Fathom Analytics 和 Google Analytics
- 支持 RSS 订阅、网站图标和评论功能
- 可使用简单的 Tailwind 对颜色和样式进行高级定制
- 优化了性能和可访问性,拥有极高的 Lighthouse 评分
- 文档齐全,定期更新
Blowfish 有 全面的文档,覆盖主题的任何一个方面。 请确保 阅读文档 以详细了解本主题有哪些功能。
Blowfish 支持多种安装方式,既能作为 git 子模块、Hugo 模块,也可完全手动安装。
每种方法的详细说明都可以在 安装 文档中找到。为了获得最简单的安装体验,请查阅文档。如果你使用的是 git,请阅读下面使用子模块的快速开始指南;如果你能安装 Hugo 主题,请阅读下面 Hugo 模块的快速开始指南。
注: 请确保你已安装 Node.js、 Git、 Go 和 Hugo ,且已经创建了一个 Hugo 工程。
我们最新推出了一个新的 CLI 工具,帮助你开始使用 Blowfish。它将为你创建一个新的 Hugo 项目、安装主题并设置主题配置文件。它仍处于测试阶段,因此请 报告你发现的任何问题。
使用 npm(或其他软件包管理器)全局安装 CLI 工具:
npm i -g blowfish-tools
然后运行 "blowfish-tools "命令,开启一个交互式进程,引导你完成创建和配置。
blowfish-tools
你也可以运行命令 blowfish-tools new
来创建一个新的 Hugo 项目,并一次性安装主题。更多信息请查看 CLI 帮助。
blowfish-tools new mynewsite
注: 请确保你已安装 Node.js、 Git、 Go 和 Hugo ,且已经创建了一个 Hugo 工程。
-
从你工程的所在目录初始化 git 仓库
git init
-
配置 Blowfish 作为 git 子模块
git submodule add -b main https://github.com/nunocoracao/blowfish.git themes/blowfish
-
在你网站的根目录中删除由 Hugo 自动生成的
config.toml
文件,并把主题文件夹中的*.toml
配置文件复制到你的config/_default/
文件夹中你可在 Hugo 缓存目录中找到主题配置文件,或者也可以从这里下载一份。
-
按照入门指南来配置你的网站
注: 确保你已经安装了 Go 和 Hugo,且已创建了一个 Hugo 工程。
-
从你工程的所在目录初始化 Hugo 模块
hugo mod init github.com/<用户名>/<仓库名>
-
新建
config/_default/module.toml
并写入以下内容:[[imports]] path = "github.com/nunocoracao/blowfish/v2"
-
运行
hugo server
启动你的本地服务器,本主题就会自动下载。 -
在你网站的根目录中删除由 Hugo 自动生成的
config.toml
文件,并把主题文件夹中的*.toml
配置文件复制到你的config/_default/
文件夹中注 不要覆盖之前的
module.toml
!你可在 Hugo 缓存目录中找到主题配置文件,或者也可以从这里下载一份。
-
按照入门指南来配置你的网站
当新的主题版本发布,你可以在你网站的根目录使用 Hugo 命令hugo mod get -u
来简单地把主题更新到最新版本。
详细的更新指南在文档中。
Blowfish 将会持续进化。我打算不断增加功能,并按需进行修改。
如有任何问题或对新功能的建议,请随时联系我。
- 🐛 Bug 问题报告 使用 GitHub Issues
- 💡 发表关于新功能的想法: 在 GitHub Discussions 发起讨论
- 🙋♀️ 一般问题: 查看 GitHub Discussions
如果你有能力修补 Bug 或者实现新功能,欢迎提交 PR。了解更多.