Hugo博客

hugo-paper — Hugo 博客模板

作者 nanxiaobei

hugo-paper 是一个基于 Hugo 的简洁博客主题，支持配色切换、社交图标、评论与 KaTeX 数学排版等配置。

打开源站下载源码 ZIP

看看你的网站会是什么样

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

3 个预览视图

桌面端首页1 / 3

访问演示网站在新标签页打开

桌面端截图首屏预览

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

全部页面与视图 3

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

采集于 2026-09-30查看来源

值得关注的模板亮点

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

通过配置文件调整配色、社交图标、头像与简介等外观选项

支持 Disqus、giscus、graph comment 三种评论集成

可全局或按页面启用 KaTeX 数学排版，并支持本地资源

提供 git submodule 与 Hugo module 两种安装方式

支持 RTL 语言方向，并可自定义 favicon 与 Apple touch icon

采用 MIT 许可，允许免费使用、修改、商用和分发

模板详细介绍

hugo-paper 是面向 Hugo 静态站点生成器的博客主题，定位为简单、干净且可定制。它通过 config.toml 或 hugo.toml 中的 params 与 services 配置项调整外观和功能，包括配色方案（linen、wheat、gray、light）、页头社交图标（Twitter、GitHub、Instagram、LinkedIn、Mastodon、Threads、Bluesky、RSS）、首页头像与个人简介、favicon 与 Apple touch icon、RTL 方向支持等。

主题内置评论集成选项：Disqus、giscus 和 graph comment，并支持在单篇文章的 front matter 中关闭评论。数学排版方面，可全局或按页面启用 KaTeX，并可选择使用本地 KaTeX 资源而非 CDN。此外还提供 highlight.js 开关、文章导航开关、单色深色模式图标、Gravatar CDN 地址等杂项配置。

安装方式有两种：作为 git submodule 添加到 themes/paper 并设置 theme = "paper"，或作为 Hugo module 通过 module.imports 引入。主题采用 MIT 许可，仓库提供在线演示站点。

Hugo博客

适合你的项目吗？

适用场景

使用 Hugo 搭建个人博客并希望快速配置外观与社交链接
需要在文章中加入评论功能并可选多种评论服务
撰写包含数学公式的技术文章并希望启用 KaTeX 渲染
面向从右到左书写的语言构建博客站点

适合人群

熟悉 Hugo 基本配置的博客作者
偏好简洁排版与可调配色方案的站点
需要评论与数学排版等可选功能的静态博客
接受通过 TOML 配置文件进行主题定制的用户

上手与定制指南

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

1
作为 git submodule 安装：在 Hugo 项目内执行 git submodule add https://github.com/nanxiaobei/hugo-paper themes/paper，并将 config.toml 或 hugo.toml 中的 theme 设为 "paper"。
2
作为 Hugo module 安装：执行 hugo mod init，移除 theme 行，并在配置底部添加 [module] 与 [[module.imports]] path = "github.com/nanxiaobei/hugo-paper"。
3
评论、社交图标、头像、KaTeX 等选项需在 config.toml 或 hugo.toml 的 params 与 services 段中填写。
4
单篇文章可通过 front matter 设置 comments = false 或 math = true 覆盖全局配置。
5
演示图片、字体、图标等第三方素材需按各自许可核对，外部服务可能另行收费。

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

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

使用时需要遵守

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

额外费用与待核对事项

启用 Disqus 评论需在配置中填写你自己的 Disqus shortname，评论功能依赖该第三方外部服务。
启用 giscus 评论需提供 GitHub 仓库、repoId、category 与 categoryId，依赖 GitHub 与 giscus 外部服务。
启用 graph comment 评论需填写 GraphComment 的 ID，依赖该第三方评论服务。
使用 Gravatar 头像或自定义 Gravatar CDN 会请求外部服务，可能受其可用性与条款约束。
默认 KaTeX 资源从 CDN 加载；如需离线或避免外部依赖，需将 localKatex 设为 true 使用本地资源。
演示图片、字体、图标及其他第三方素材需按各自许可核对，不能仅凭代码的 MIT 许可判断。
域名、托管、数据库、支付或 AI 等外部服务可能另外收费。

查看原文依据

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

shortname = 'YOUR_DISQUS_SHORTNAME' # use disqus comments
README 原文

repo = 'YOUR_GISCUS_REPO' # see https://giscus.app for more details
README 原文

graphCommentId = "YOUR_GRAPH_COMMENT_ID" # use graph comment (disqus alternative)
README 原文

gravatarCdn = 'GRAVATAR_CDN_LINK' # e.g. 'https://cdn.v2ex.com/gravatar/'
README 原文

localKatex = false # use local KaTeX js/css instead of CDN
README 原文

https://github.com/nanxiaobei/hugo-paper/blob/main/LICENSE https://github.com/nanxiaobei/hugo-paper/blob/main/README.md

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

项目核对记录与介绍依据

模板资料

来源平台: GitHub
资料与维护参考分: 资料较完整 · 95 / 100
技术栈: Hugo
网站类型: 博客

这个分数如何计算

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

这个项目需要核对什么

记录的仓库更新时间: 2026-08-21
截图检查日期: 2026-10-01

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

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

查看具体选型方法 →

介绍的制作与核对状态

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

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

查看当时使用的来源资料

SHA-256: 82243cbdf9644673d2401fc2e233fa2c9f2e18a58851c135d80762d056edcf7c

2026-10-01T13:47:39.498Z

来源文件 / 仓库

<div align="center">

gorgeous framer templates ☞ [21beats.lemonsqueezy.com](https://21beats.lemonsqueezy.com/)

your online home screen ☞ [kee.so](https://kee.so/)

</div>

---

<div align="center">
<h1>Paper <sup><sup><sub>6.30</sub></sup></sup></h1>

Demo → [hugo-paper.vercel.app](https://hugo-paper.vercel.app/)

A simple, clean, customizable Hugo theme.

⚡️ Fast | 👒 Customizable | 🫙 Smooth

</div>

## Links

Product Hunt: [producthunt.com/posts/hugo-paper-6](https://www.producthunt.com/posts/hugo-paper-6)

Hugo themes: [themes.gohugo.io/hugo-paper](https://themes.gohugo.io/hugo-paper/)

## Overview

![](./images/screenshot.png)
![](./images/screenshot_dark.png)
![](./images/pagespeed.png)

## Options

Available options to `config.toml` or `hugo.toml`:

```toml
[services]
  [services.disqus]
    shortname = 'YOUR_DISQUS_SHORTNAME'     # use disqus comments

[params]
  # color style
  color = 'linen'                           # linen, wheat, gray, light

  # header social icons
  twitter = 'YOUR_TWITTER_ID'               # twitter.com/YOUR_TWITTER_ID
  github = 'YOUR_GITHUB_ID'                 # github.com/YOUR_GITHUB_ID
  instagram = 'YOUR_INSTAGRAM_ID'           # instagram.com/YOUR_INSTAGRAM_ID
  linkedin = 'YOUR_LINKEDIN_ID'             # linkedin.com/in/YOUR_LINKEDIN_ID
  mastodon = 'YOUR_MASTODON_LINK'           # e.g. 'https://mastodon.instance/@xxx'
  threads = '@YOUR_THREADS_ID'              # threads.net/@YOUR_THREADS_ID
  bluesky = 'YOUR_BLUESKY_ID'               # https://bsky.app/profile/YOUR_BLUESKY_ID
  rss = true                                # show rss icon

  # home page profile
  avatar = 'GRAVATAR_EMAIL'                 # gravatar email or image url
  name = 'YOUR_NAME'
  bio = 'YOUR_BIO'


  # misc
  disableHLJS = true                        # disable highlight.js
  disablePostNavigation = true              # disable post navigation
  monoDarkIcon = true                       # show monochrome dark mode icon
  gravatarCdn = 'GRAVATAR_CDN_LINK'         # e.g. 'https://cdn.v2ex.com/gravatar/'
  math = true                               # enable KaTeX math typesetting globally
  localKatex = false                        # use local KaTeX js/css instead of CDN
  graphCommentId = "YOUR_GRAPH_COMMENT_ID"  # use graph comment (disqus alternative)
  favicon = "favicon.ico"                   # customize the default favicon
  appleTouchIcon = "apple-touch-icon.png"   # customize the default Apple touch icon

  # RTL supprot
  direction = "rtl"                         # RTL support for Right-to-left languages

  # giscus
[params.giscus]
  repo = 'YOUR_GISCUS_REPO'                 # see https://giscus.app for more details
  repoId = 'YOUR_GISCUS_REPO_ID'
  category = 'YOUR__GISCUS_CATEGORY'
  categoryId = 'YOUR_GISCUS_CATEGORY_ID'
  mapping = 'pathname'
  theme = 'light'
  lang = 'zh-CN'
```

Available options to front matter:

```toml
comments = false                            # disable comments for a specific page
math = true                                 # enable KaTeX math typesetting for a specific page
```

## Install

### As git submodule

Inside the folder of your Hugo project, run:

```bash
git submodule add https://github.com/nanxiaobei/hugo-paper themes/paper
```

Open `config.toml`(or `hugo.toml`), change `theme` to `"paper"`:

```toml
theme = "paper"
```

For more information, please read the [official guide](https://gohugo.io/getting-started/quick-start/#configure-the-site) of Hugo.

### As hugo module

Add paper theme ad dependency of your site:

```bash
hugo mod init github.com/<your_user>/<your_project>
```

Open `config.toml`(or `hugo.toml`), remove the `theme` line (if present), add `module` section to the bottom of the file:

```toml
[module]
  [[module.imports]]
    path = "github.com/nanxiaobei/hugo-paper"
```

For more information, please read the [official guide](https://gohugo.io/hugo-modules/use-modules/#use-a-module-for-a-theme) of Hugo.

## License

[MIT License](https://github.com/nanxiaobei/hugo-paper/blob/main/LICENSE) (c) [nanxiaobei](https://lee.so/)

反馈内容错误