Hugo博客

plain-blog — Hugo 博客模板

作者 LiaungYip

plain-blog 是一个以内容优先为目标的 Hugo 极简博客主题，采用 MIT 许可，支持分类、标签、系列等分类法，并可选 KaTeX 数学公式与 Google Analytics。

打开源站下载源码 ZIP

看看你的网站会是什么样

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

1 个预览视图

作者提供的预览

查看源码在新标签页打开

作者提供的预览首屏预览

来自项目 README 的原始预览。

目前有 1 张原始预览，可打开完整图片查看设计细节。

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

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

值得关注的模板亮点

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

以内容优先的极简排版：黑字白底蓝链接的高对比配色，响应式布局，适合桌面与移动端阅读

JavaScript 使用极少，禁用 JS 时基本不影响页面阅读

支持 categories、tags、series 三种分类法，可单独或同时启用

通过 front matter 开关目录（show_table_of_contents）与显式更新日期（content-updated-date）

使用 Hugo Pipes 在构建时获取第三方 CSS/JS 依赖，减少对第三方 CDN 的运行时依赖

可选 KaTeX 数学公式支持，需在 front matter 中设置 math = "true"

模板详细介绍

plain-blog 是 LiaungYip 发布的 Hugo 博客主题，定位是极简、内容优先，作者在 README 中明确以「首屏加载控制在 50kB 以内」为目标。主题采用黑字白底蓝链接的高对比配色，响应式布局，JavaScript 使用很少，在禁用 JS 时基本不影响阅读。

功能层面，主题支持分类、标签、系列三种分类法（可单独或同时启用），提供顶部与底部菜单、Google Analytics、打印样式（打印时隐藏页眉页脚和菜单）。文章可通过 front matter 中的 show_table_of_contents = "true" 显示目录，通过 content-updated-date = "YYYY-MM-DD" 显式声明更新日期，未填写则不显示「Updated」标签，避免文件修改时间造成误显示。数学公式通过 KaTeX 支持，需在 front matter 中设置 math = "true"，README 注明当前仍依赖第三方 CDN。构建时使用 Hugo Pipes 拉取第三方 CSS 与 JS 依赖，以减少对第三方 CDN 的运行时依赖。

为控制体积，主题有意省略了 jQuery、highlight.js（改用 Hugo 内置 Chroma 做服务端高亮）、Web 字体和图标字体等。依赖库包括 purecss 与 timeago.js（用于「刚刚」「4 天前」这类模糊时间戳）。README 中提供了作者个人站点 penwatch.net 作为在线示例，并说明灵感来自 qntm.org 与 gizak/nofancy；同作者另有面向文档场景的 plain-docs 主题。仓库未提供主题配置项、Hugo 版本要求或安装步骤的详细说明，使用前需自行阅读仓库文件确认。

Hugo博客

适合你的项目吗？

适用场景

搭建以文字阅读为主的个人博客，希望页面结构简单、加载负担小
需要按分类、标签或系列组织文章，并希望目录和更新日期可控
撰写包含数学公式的技术或学术类文章
需要打印友好的页面，打印时自动隐藏页眉、页脚和菜单
希望减少对第三方 CDN 与前端库依赖的 Hugo 站点

适合人群

使用 Hugo 构建静态博客、偏好极简排版的个人作者
在意首屏体积、希望避免引入 jQuery、highlight.js、Web 字体和图标字体的开发者
需要分类法、目录、更新日期与打印样式等基础博客能力的写作者
能接受自行阅读仓库文件、手动完成主题配置的用户

上手与定制指南

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

1
仓库 README 未提供完整的安装与配置步骤，使用前需查看仓库中的主题文件与示例配置
2
数学公式依赖 KaTeX，README 注明当前仍使用第三方 CDN，需自行评估
3
目录需在文章 front matter 中设置 show_table_of_contents = "true"，更新日期需设置 content-updated-date = "YYYY-MM-DD"
4
代码高亮使用 Hugo 内置 Chroma 在服务端完成，主题未包含 highlight.js
5
代码采用 MIT 许可，可免费使用、修改、商用和分发；分发时需保留版权声明与完整 MIT 许可声明，演示图片、字体、图标等第三方素材需按各自许可单独核对

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

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

使用时需要遵守

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

额外费用与待核对事项

数学公式功能依赖 KaTeX，且 README 注明当前通过第三方 CDN 加载，属于外部服务依赖，离线或受限网络环境下可能无法正常渲染。
主题内置 Google Analytics 支持，启用后需自行提供 Google Analytics 账号与跟踪 ID，并受 Google 服务条款约束。
构建时需通过 Hugo Pipes 拉取第三方 CSS/JS 依赖，构建环境需能访问相应来源，否则构建可能失败。
演示图片、字体、图标及其他第三方素材需按各自许可核对，不能仅凭代码的 MIT 许可判断。
域名、托管、数据库、支付或 AI 等外部服务可能另外收费。

查看原文依据

Permission is hereby granted, free of charge
许可证原文

Supports math using KaTeX - `$ x = \frac{-b\pm\sqrt{b^2-4ac}}{2a} $` - use `math = "true"` in front matter. (Note: Uses third party CDN - for now.)
README 原文

Google Analytics.
README 原文

Hugo Pipes is used to fetch third-party CSS and JS dependencies at the time you build the website, avoiding use of third-party CDN's.
README 原文

https://github.com/LiaungYip/plain-blog/blob/master/LICENSE https://github.com/LiaungYip/plain-blog/blob/master/README.md

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

项目核对记录与介绍依据

模板资料

来源平台: GitHub
资料与维护参考分: 资料一般 · 71 / 100
技术栈: Hugo
网站类型: 博客

这个分数如何计算

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

这个项目需要核对什么

记录的仓库更新时间: 2026-05-14
截图检查日期: 2026-10-02

目前没有记录演示链接。请依据仓库说明在本地评估；仅凭截图无法确认交互行为。

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

查看具体选型方法 →

介绍的制作与核对状态

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

已完成服务器许可规则与 AI 来源核对；未经过人工编辑审核。

查看当时使用的来源资料

SHA-256: 8f152f28bfb9bbf18b038f78ace2806f4ef2e1a56711410b5b6386ec6919e405

2026-10-02T10:21:34.385Z

来源文件 / 仓库

# plain-blog

    minimal theme
    puts your content first
    refridgerator

See a live example at my website, [penwatch.net](//penwatch.net/).

Inspired by [qntm.org](//qntm.org) and [gizak/nofancy](https://github.com/gizak/nofancy).

Looking for a Hugo documentation theme with a similar focus on minimal functionality? Try [`plain-docs`](//github.com/LiaungYip/plain-docs/).

## Screenshots

![](https://raw.githubusercontent.com/LiaungYip/plain-blog/master/images/screenshot.png)

## Features

* Pages load FAST FAST FAST. (First page overhead: ≈40 kB. Subsequent page overhead: ≈3 kB.)
* Responsive - looks great on desktop or mobile.
* High contrast - black text, on a white background, with blue links.
* Minimal Javascript. Hardly cares if JS is disabled.
* Supports your choice of taxonomies: categories, or tags, or series, or all three at once.
* Google Analytics.
* Top and bottom menus.
* Printable - headers, footers, and menus disappear when you hit the "Print" button.
* Table of contents - use `show_table_of_contents = "true"` in front matter.
* Intentional "Updated" date - add `content-updated-date = "YYYY-MM-DD"` in front matter to show an updated date alongside the posted date. Omitting it suppresses the "Updated" label entirely, so spurious file-modification timestamps don't appear.
* Hugo Pipes is used to fetch third-party CSS and JS dependencies at the time you build the website, avoiding use of third-party CDN's. (See https://github.com/gohugoio/hugoThemes/issues/668 .)
* Supports math using KaTeX - `$ x = \frac{-b\pm\sqrt{b^2-4ac}}{2a} $` -  use `math = "true"` in front matter. (Note: Uses third party CDN - for now.)

## Things omitted

My goal is to load the first page in 50kB or less.

That means I've left out anything that wasn't needed. Some things I omitted include:

* jQuery (30kB compressed)
* highlight.js (100kB compressed) - use Chroma for [server-side highlighting](https://gohugo.io/extras/highlighting/) instead.
* Web fonts (e.g. 200kB for Proxima Nova and Source Code Pro)
* Icons, i.e. font-awesome (70 kB compressed)

## Libraries used

* [`purecss`](https://purecss.io/) ([License](https://github.com/yahoo/pure/blob/master/LICENSE.md))
* [`timeago.js`](https://github.com/hustcc/timeago.js) for fuzzy timestamps - "just now", "4 days ago", "2 years ago". (MIT License)

反馈内容错误