用 Hugo 主题复刻 Bear Blog 的极简超快静态博客

方案简介

Hugo Bear Blog 是一个基于 Bear Blog 的 Hugo 主题，目标是打造「免费、无废话、超快」的博客。Bear Blog 原版以极简、快速著称，该主题将这种极简哲学移植到 Hugo 静态站点生成器生态中，让用户可以用 Markdown 写作、用 Hugo 构建、以极快的速度发布博客。适合想要轻量、无干扰、性能极佳的个人博客作者。项目提供在线演示站（https://janraasch.github.io/hugo-bearblog/），并内置 exampleSite 示例目录，方便从零快速上手。社区还衍生出多个变体（如支持中文文档的 Neo 版、多语言的 Bear Cub 版），但主仓库保持与原版 Bear Blog 一样简单和快速。

亮点与能力

• 基于极简 Bear Blog 哲学的 Hugo 主题，免费、无废话、超快
• 支持亮色/暗色两套配色方案，检测到浏览器暗色模式时自动切换，默认为亮色
• 提供完整 exampleSite 示例目录，可直接复制上手
• 通过 hugo new 命令快速创建页面与博客文章
• 支持通过 custom_head.html 自定义品牌、颜色和 CSS
• 社区活跃，有多个独立维护的 Remix 变体（中文版 Neo、多语言 Bear Cub 等）

组成与分工

• Hugo：静态站点生成器，负责 Markdown 内容渲染、构建与本地开发服务器（hugo server）
• Bear Blog：原版极简博客平台，本主题复刻其设计哲学与外观
• Git：以 git submodule 方式将主题安装进 Hugo 站点
• GitHub Pages：托管官方在线演示站点

前置要求

• 需要已安装 Hugo。安装方法参见 Hugo 官方 setup guide：https://gohugo.io/getting-started/installing
• 若在已有 Hugo 站点上安装主题，需要 Git（用于添加子模块）

安装主题的命令：

bash
git submodule add https://github.com/janraasch/hugo-bearblog.git themes/hugo-bearblog

实施步骤

1. 已有 Hugo 站点：添加主题

bash
git submodule add https://github.com/janraasch/hugo-bearblog.git themes/hugo-bearblog

2. 调整配置

然后按说明调整 hugo.toml。主题仓库的 exampleSite 目录中包含可参考的 hugo.toml 配置文件，可对照修改。

3. 从零开始

如果从零新建，把主题自带的 exampleSite 目录内容整体复制到你的源码目录，即可了解工作方式并在此基础上定制。

4. 添加内容

• 编辑首页：修改 content/_index.md
• 新建页面：

bash
hugo new my-new-page.md

• 新建博客文章：

bash
hugo new blog/my-new-post.md

5. 本地运行示例站

bash
hugo server --source ./exampleSite --themesDir ../..

使用与配置要点

• 首页内容：通过编辑 content/_index.md 修改首页内容
• 创建内容：用 hugo new my-new-page.md 建页面、hugo new blog/my-new-post.md 建博文；在仓库根目录使用 hugo 命令时需追加 --source ./exampleSite --themesDir ../..，例如：

bash
hugo new blog/post.md --source ./exampleSite --themesDir ../..

• 自定义品牌/颜色/CSS：在 layouts/partials 目录添加 custom_head.html 文件，其中可以加