Hugo博客

hugo-blueprint — Hugo 博客模板

作者 Kircerta

基于 PaperMod 派生的 Hugo 主题，面向密集技术博客、项目日志与研究笔记，提供蓝图风格的明暗模式与文章卡片式布局。

打开源站下载源码 ZIP

看看你的网站会是什么样

浏览真实页面截图，比较内容排版与手机效果。点击下方缩略图切换，放大查看整页细节。

3 个预览视图
桌面端首页1 / 3
桌面端截图首屏预览

由服务器浏览器实际访问页面后截取。

全部页面与视图 3

截图用于了解视觉与布局，交互效果请以实际项目为准。

采集于 2026-10-12查看来源

值得关注的模板亮点

从已有项目资料中，快速了解它的特点。

01

由 hugo-PaperMod 派生，沿用其结构并加入 Blueprint 视觉语言

02

提供 Blueprint dark 与 light 两种模式，切换按钮固定在页面上

03

首页与列表页使用文章卡片布局，元数据紧凑

04

长技术文章支持可折叠目录

05

归档、搜索、标签、分页、表格与代码块均有样式

06

附带多语言示例站点，界面文案集中在 params.blueprint 下配置

模板详细介绍

Hugo Blueprint 是 Zixiang Zhang 的个人设计语言在 Hugo 上的实现，源自其个人网站，并由 hugo-PaperMod 派生而来。主题定位是承载密集的技术博客、项目日志和研究笔记，因此首页与列表页采用文章卡片布局，元数据保持紧凑，便于在有限空间内呈现较多条目。

视觉上提供 Blueprint dark 与 Blueprint light 两种模式，并配有固定位置的模式切换。长技术文章可启用可折叠目录。归档、搜索、标签、分页、表格与代码块均有对应样式。主题附带多语言示例站点，界面文案可通过 params.blueprint 配置，例如首页引导语、文章前缀、条目按钮文案以及明暗模式标签。

安装方式为将仓库作为子模块加入 Hugo 站点的 themes 目录，并在站点配置中设置 theme。示例站点可通过 hugo 命令以 exampleSite 为源构建。主题基于 PaperMod 派生，二者均以 MIT 许可分发。

Hugo博客

适合你的项目吗？

适用场景

  • 撰写篇幅较长、含代码块与表格的技术文章
  • 记录项目日志或研究笔记并按标签归档
  • 需要明暗两种阅读模式的个人博客
  • 希望以示例站点为起点搭建多语言 Hugo 站点

适合人群

  • 使用 Hugo 构建个人技术博客的开发者
  • 需要密集文章列表与紧凑元数据展示的写作者
  • 偏好 PaperMod 结构但希望更换视觉风格的用户
  • 需要可折叠目录来组织长文的作者

上手与定制指南

结合仓库当前版本的说明，按下面的资料检查内容、配置与运行要求。

  1. 1

    通过 git submodule add 将仓库加入 themes/hugo-blueprint，并在配置中设置 theme = "hugo-blueprint"

  2. 2

    在 params 中配置 mainSections、ShowReadingTime、ShowToc、TocOpen 等选项

  3. 3

    界面文案在 params.blueprint 下设置，如 homeKicker、articlePrefix、entryCta、documentLabel、darkLabel、lightLabel

  4. 4

    构建示例站点可使用 hugo --source exampleSite --themesDir ../.. --theme hugo-blueprint 命令

  5. 5

    演示图片、字体、图标等第三方素材需按各自许可单独核对，不随代码的 MIT 许可一并授权

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

本次收录的是公开仓库中采用 MIT 许可的免费版本；免费范围为该版本代码，不代表外部服务或第三方素材免费。

使用时需要遵守

  • 允许免费使用、修改、商用和分发该版本代码。
  • 分发代码副本或实质性部分时，保留原作者版权声明和完整 MIT 许可声明。
  • 代码按现状提供；担保与责任限制以原许可证及适用法律为准。

额外费用与待核对事项

  • 演示图片、字体、图标及其他第三方素材需按各自许可核对，不能仅凭代码的 MIT 许可判断。
  • 域名、托管、数据库、支付或 AI 等外部服务可能另外收费。
查看原文依据

Permission is hereby granted, free of charge

许可证原文
https://github.com/Kircerta/hugo-blueprint/blob/main/LICENSEhttps://github.com/Kircerta/hugo-blueprint/blob/main/README.md

DeepSeek 根据仓库许可证和 README 整理 ·2026-10-12。结果仅覆盖已读取资料，依赖、图片、字体及后续条款变更以各自原文为准。

项目核对记录与介绍依据

模板资料

来源平台
GitHub
资料与维护参考分
资料较完整 · 80 / 100
技术栈
Hugo
网站类型
博客
这个分数如何计算

本站按许可资料（最高30分）、演示链接（12分）、预览图（10分）、Star数（15分）、记录的维护时间（15分）、描述完整度（8分）、功能记录（5分）和分类资料（5分）计算。它不是代码、安全或性能测试，也不是 Google 评分；有链接不代表已实测可用。

这个项目需要核对什么

记录的仓库更新时间
2026-05-20
截图检查日期
2026-10-12

已收录演示链接。请用你的内容与屏幕尺寸检查；有演示不代表表单、认证或支付已经可用。

目录记录的主要技术栈是 Hugo。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料，不代表代码审计或部署实测。

查看具体选型方法 →

介绍的制作与核对状态

介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。

审核声明: [email protected] · 2026-10-13

查看当时使用的来源资料

SHA-256: fa4b18882d926d3c7af161ac50b2e07efc95864a0603ed1e12385a004668a4c0

2026-10-12T08:38:25.160Z

来源文件 / 仓库
# Hugo Blueprint

Hugo [Blueprint](https://www.zixiangzhang.com/design/UndertideAtelier) is [Zixiang Zhang](https://zixiangzhang.com)'s personal design language for Hugo, originated from his [personal website](https://zixiangzhang.com). It is a PaperMod-derived theme for dense technical blogs, project logs, and research notes.

Author: [Zixiang Zhang](https://zixiangzhang.com). Personal Hugo blog: [kircerta.com](https://www.kircerta.com).

## Preview

![Blueprint dark preview](https://raw.githubusercontent.com/Kircerta/hugo-blueprint/main/images/screenshot-dark.png)

![Blueprint light preview](https://raw.githubusercontent.com/Kircerta/hugo-blueprint/main/images/screenshot-light.png)

## Theme Surface

- Article-card home and list pages with compact metadata.
- Blueprint dark and light visual modes with a fixed mode switch.
- Collapsible table of contents support for long technical posts.
- Styled archives, search, tags, pagination, tables, and code blocks.
- Multilingual example site and theme labels under `params.blueprint`.

## Install

Add the theme to a Hugo site:

```bash
git submodule add https://github.com/Kircerta/hugo-blueprint.git themes/hugo-blueprint
```

Set the theme:

```toml
theme = "hugo-blueprint"
```

## Configuration

```toml
baseURL = "https://example.com/"
title = "Blueprint"
theme = "hugo-blueprint"
defaultTheme = "dark"
disableThemeToggle = true
enableRobotsTXT = true

[outputs]
  home = ["HTML", "RSS", "JSON"]

[params]
  mainSections = ["posts"]
  ShowReadingTime = true
  ShowToc = true
  TocOpen = false

  [params.blueprint]
    homeKicker = "BLUEPRINT BLOG"
    articlePrefix = "ARTICLE"
    entryCta = "READ ARTICLE"
    documentLabel = "ARTICLE"
    darkLabel = "BLUEPRINT DARK"
    lightLabel = "BLUEPRINT LIGHT"
```

## Example Site

Demo: <https://kircerta.github.io/hugo-blueprint/>

Build the included example site:

```bash
hugo --source exampleSite --themesDir ../.. --theme hugo-blueprint --destination /tmp/hugo-blueprint-example --cleanDestinationDir --gc --minify
```

## Attribution

Blueprint is derived from [hugo-PaperMod](https://github.com/adityatelange/hugo-PaperMod) by [Aditya Telange](https://github.com/adityatelange). Thanks to [Hugo](https://gohugo.io/) and the [Hugo authors](https://github.com/gohugoio/hugo/graphs/contributors). PaperMod and Blueprint are distributed under the MIT License.

## License

MIT. See [LICENSE](LICENSE).
反馈内容错误

看看同类模板

对比同技术栈与用途的模板，找到更适合的视觉与内容结构。

hugo-PaperMod

hugo-PaperMod

PaperMod 是 Hugo 生态里知名度较高的主题之一，定位很明确：给博客和轻量作品集站点提供一套干净、响应式的阅读界面。

Hugo · 作品集

LoveIt

LoveIt

❤️A clean, elegant but advanced blog theme for Hugo 一个简洁、优雅且高效的 Hugo 主题

Hugo · 博客

hugo-coder

hugo-coder

A minimalist blog theme for hugo.

Hugo · 博客

blowfish

blowfish

Personal Website & Blog Theme for Hugo

Hugo · 博客

hugo-paper

hugo-paper

🪺 A simple, clean, customizable Hugo theme

Hugo · 博客

hextra

hextra

Hextra 是一个 Hugo 主题，定位在文档站与博客之间：既提供侧边栏导航、目录、面包屑、分页这类文档站结构，也能承载博客内容。

Hugo · 文档