Welcome to OPC! :tada: on One Person Company

欢迎来到 Blowfish

mikezhangding@gmail.com (One Person Company) — Mon, 01 Jan 0001 00:00:00 +0000

Blowfish 包含了大量的特性功能。

Blowfish 的目标是开发一个简单且轻量级的主题。该主题是 Congo 的一个分支，并进行了大量扩展。

安装和配置

mikezhangding@gmail.com (One Person Company) — Mon, 01 Jan 0001 00:00:00 +0000

如果想快速上手，可以按照标准的 Hugo 快速启动文档。

更详细的安装如下，更新主题的教程也可以看此文档。

入门指南

mikezhangding@gmail.com (One Person Company) — Mon, 01 Jan 0001 00:00:00 +0000

本节内容需要已经阅读了安装 Blowfish 主题。

我们刚刚推出了一个 CLI 工具，用来帮助你快速开始 Blowfish。它将帮助你安装和配置 Blowfish 主题。可以使用以下命令全局安装 CLI 工具：

配置

mikezhangding@gmail.com (One Person Company) — Mon, 01 Jan 0001 00:00:00 +0000

Blowfish 是一个高度定制化的主题，使用到了一些 Hugo 中最新的特性来简化配置方式。

主页布局

mikezhangding@gmail.com (One Person Company) — Mon, 01 Jan 0001 00:00:00 +0000

Blowfish 提供了一个完全灵活的主页布局。你可以选择两种主要模板，并提供了额外的参数来帮助调整设计。当然，你也可以提供自己的模板，完全控制主页的内容。

简码

mikezhangding@gmail.com (One Person Company) — Mon, 01 Jan 0001 00:00:00 +0000

除了所有默认 Hugo 简码之外，Blowfish 还添加了一些额外的功能。

醒目框
#

alert 可以将其中内容输出为文章中的风格化消息框。它对于吸引读者注意您不想让读者错过的重要信息很有用。

Front Matter(文件头信息)

mikezhangding@gmail.com (One Person Company) — Mon, 01 Jan 0001 00:00:00 +0000

除了 Hugo 中默认的 front matter，Blowfish 主题中还添加了大量的参数选项来自定义单个页面的展示方式。所有可用的扉页参数如下。

多创作者模式

mikezhangding@gmail.com (One Person Company) — Mon, 01 Jan 0001 00:00:00 +0000

一个网站会有多个创作者共同贡献内容，所以需要再整个网站中默认使用多创作者。对于这种情况，Blowfish 允许用户使用多创作者功能拓展创作者列表。

局部模板(Partials)

mikezhangding@gmail.com (One Person Company) — Mon, 01 Jan 0001 00:00:00 +0000

站点分析
#

Blowfish 支持了 Fathom、Google 和 Umami。Fathom 和 Umami 都是开源、简单、且注重隐私的站点分析服务，他们可以很好地替代 Google 分析。Fathom 和 Umami 都有公有云的付费版本，当然你也可以自己手动部署开源版。

缩略图

mikezhangding@gmail.com (One Person Company) — Mon, 01 Jan 0001 00:00:00 +0000

缩略图
#

Blowfish 对视觉支持进行了增强，可以让你轻松地为文章添加缩略图。你只需要将一个以 feature* 开头的图像文件（支持几乎所有格式，但更推荐 .png 或 .jpg）放置在文章所在的目录中，如下面所示：

内容示例

mikezhangding@gmail.com (One Person Company) — Mon, 01 Jan 0001 00:00:00 +0000

如果你已经按顺序阅读了文档，那么你现在应该已经了解了 Blowfish 中所有的功能和配置信息。这个页面旨在把所有内容整合在一起，并提供一些你会在 Hugo 项目中使用的示例。

系列

mikezhangding@gmail.com (One Person Company) — Mon, 01 Jan 0001 00:00:00 +0000

Blowfish 提供了将一组文章分组到“系列”下的功能。将文章放在系列下将在每个页面中显示该系列文章的其余部分，并在它们之间提供快速导航。您可以在上面看到一个例子。

进阶自定义

mikezhangding@gmail.com (One Person Company) — Mon, 01 Jan 0001 00:00:00 +0000

您可以通过多种方式对 Blowfish 进行高级自定义。请阅读下文，了解更多可自定义的内容以及实现想要效果的最佳方法。

托管和部署

mikezhangding@gmail.com (One Person Company) — Mon, 01 Jan 0001 00:00:00 +0000

有许多方法可以部署基于 Blowfish 主题的 Hugo 网站。这个主题几乎在任何部署场景中都很灵活。

Firebase: 阅读量 & 点赞量

mikezhangding@gmail.com (One Person Company) — Mon, 01 Jan 0001 00:00:00 +0000

为了能够在网站中获取动态数据，我们支持了对 Firebase 的集成。这将允许你在列表和文章中使用阅读量功能。

使用 Blowfish和 Hugo 构建你的主页

mikezhangding@gmail.com (One Person Company) — Wed, 04 Oct 2023 00:00:00 +0000

一年前我创建了 Blowfish，这是一个为了打造我的个人主页而精心设计的 Hugo 主题。我决定将其作为一个开源项目。直到今天，Blowfish 已经变成了一个蓬勃发展的开源项目，在 GitHub 上拥有超过900个 star 和数百名用户。在本教程中，我将向你展示如何搭建并在几分钟内让你的网站运行起来。

多作者

mikezhangding@gmail.com (One Person Company) — Wed, 12 Oct 2022 00:00:00 +0000

如何使用多个作者的简单示例。

缩略图

mikezhangding@gmail.com (One Person Company) — Mon, 26 Sep 2022 00:00:00 +0000

一个展示如何在你的文章中开始使用缩略图的快速示例。

图标

mikezhangding@gmail.com (One Person Company) — Fri, 14 Aug 2020 00:00:00 +0000

Blowfish 内置了许多 FontAwesome 6 中的图标。你可以使用图标部分或者图标短代码将这些图标包含在你的网站中。

Markdown

mikezhangding@gmail.com (One Person Company) — Mon, 11 Mar 2019 00:00:00 +0000

本文提供了可在 Blowfish 中使用的基本 Markdown 格式示例，还展示了如何加入一些基本 HTML 元素。

简码示例

mikezhangding@gmail.com (One Person Company) — Sun, 10 Mar 2019 00:00:00 +0000

这是简码内容的示例。

文本占位符

mikezhangding@gmail.com (One Person Company) — Sat, 09 Mar 2019 00:00:00 +0000

Lorem est tota propiore conpellat pectoribus de pectora summo.

数学表达式

mikezhangding@gmail.com (One Person Company) — Fri, 08 Mar 2019 00:00:00 +0000

KaTeX 可用于在文章中呈现数学表达式。

流程图和思维导图

mikezhangding@gmail.com (One Person Company) — Wed, 06 Mar 2019 00:00:00 +0000

使用 Mermaid 可以轻松地将图表和流程图添加到文章中。

图表

mikezhangding@gmail.com (One Person Company) — Wed, 06 Mar 2019 00:00:00 +0000

Blowfish 包含 Chart.js，可实现强大的图表和数据可视化。

Emoji 表情符号 :parachute:

mikezhangding@gmail.com (One Person Company) — Tue, 05 Mar 2019 00:00:00 +0000

📖🏞️🧗🏽🐉🧙🏽‍♂️🧚🏽👸

使用指南模板

mikezhangding@gmail.com (One Person Company) — Tue, 22 Dec 1987 00:00:00 +0000

感谢您愿意为 Blowfish 社区做出贡献。

如何开始？
#

这是一篇模板文章，将解释如何为 Blowfish 的指南部分创建新文章。

Welcome to OPC! :tada: on One Person Company

欢迎来到 Blowfish

安装和配置

入门指南

配置

主页布局

简码

醒目框 #

Front Matter(文件头信息)

多创作者模式

局部模板(Partials)

站点分析 #

缩略图

缩略图 #

内容示例

系列

进阶自定义

托管和部署

Firebase: 阅读量 & 点赞量

使用 Blowfish和 Hugo 构建你的主页

多作者

缩略图

图标

Markdown

简码示例

文本占位符

数学表达式

流程图和思维导图

图表

Emoji 表情符号 :parachute:

使用指南模板

如何开始？ #

醒目框
#

站点分析
#

缩略图
#

如何开始？
#