Hugo博客

blist-hugo-theme — Hugo 博客模板

作者 apvarun

Blist 是面向 Hugo 站点的博客主题，采用 MIT 许可，提供响应式布局、分页、搜索、目录、深色模式与多种评论系统接入。

打开源站下载源码 ZIP

看看你的网站会是什么样

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

1 个预览视图
作者提供的预览
作者提供的预览首屏预览

来自项目 README 的原始预览。

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

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

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

值得关注的模板亮点

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

01

响应式布局，针对移动端优化

02

支持文章分页与目录导航

03

内置基于 fuse.js 的文本搜索，需启用首页 JSON 输出

04

支持深色模式切换并记忆用户偏好

05

可接入 Disqus、giscus、utterances 评论系统

06

通过 Tailwind CSS 颜色名自定义主题强调色

模板详细介绍

Blist 是一个用于 Hugo 静态站点的博客主题，仓库由 apvarun 维护，采用 MIT 许可证发布。主题定位为博客内容展示，提供响应式布局与移动端适配、文章分页、目录、社交链接、代码高亮、颜色自定义、深色模式、i18n 多语言支持以及 SEO 相关配置。搜索功能基于 fuse.js 实现，需要在 Hugo 的 outputs 中为首页启用 JSON 输出；评论支持 Hugo 原生的 Disqus，以及 giscus 和 utterances。主题要求 Hugo 最低版本 0.110.0，构建流程依赖 npm 与 PostCSS，部署到 Netlify、Vercel 等平台时使用 npm i && HUGO_ENVIRONMENT=production hugo --gc 命令，其中生产环境变量用于启用 CSS 清理。仓库自带配置完整的 exampleSite，可复制其 hugo.toml 与 package.json 到站点根目录后运行预览。

Hugo博客

适合你的项目吗？

适用场景

  • 使用 Hugo 搭建个人技术博客或写作站点
  • 需要多语言内容与本地化站点配置的博客
  • 希望为文章接入第三方评论系统的静态站点
  • 需要搜索、目录与深色阅读模式的博客

适合人群

  • 使用 Hugo 并熟悉 npm 构建流程的开发者
  • 以文章列表和正文阅读为主的博客站点
  • 需要多语言与评论功能的个人站点

上手与定制指南

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

  1. 1

    Hugo 最低版本要求为 0.110.0

  2. 2

    通过 git clone 或 git submodule 将主题放入 themes/blist

  3. 3

    将主题的 package.json 与 package-lock.json 复制到站点根目录并执行 npm install

  4. 4

    在 hugo.toml 中设置 theme = 'blist'，并参考 exampleSite 的配置

  5. 5

    启用搜索需在 outputs 中为 home 添加 JSON 输出

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

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

使用时需要遵守

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

额外费用与待核对事项

  • 启用 Google Analytics 需在 hugo.toml 中配置 services.googleAnalytics.ID，属于外部第三方服务，使用前需自行确认其条款与费用。
  • 评论功能依赖 Disqus、giscus 或 utterances 等第三方外部服务，需自行注册并配置相应账号或仓库，可能受其各自条款约束。
  • 构建流程依赖 npm 及全局安装 postcss-cli，需具备 Node.js 环境与相应网络访问。
  • 使用该主题要求 Hugo 版本不低于 0.110.0，低于此版本无法正常构建。
  • 搜索功能依赖 fuse.js 库，需通过 npm 安装并在 outputs 中为首页启用 JSON 输出。
  • 演示图片、字体、图标及其他第三方素材需按各自许可核对，不能仅凭代码的 MIT 许可判断。
  • 域名、托管、数据库、支付或 AI 等外部服务可能另外收费。
查看原文依据

Permission is hereby granted, free of charge

许可证原文

Set `services.googleAnalytics.ID` in `hugo.toml` to activate Hugo's [embedded Google Analytics template]

README 原文

Support comments systems - Disqus (hugo native) - giscus - utterances

README 原文

Run `npm i -g postcss-cli` to use PostCSS with Hugo build

README 原文

Minimum Hugo Version: **0.110.0**

README 原文

Uses fuse.js to enable searching through content

README 原文
https://github.com/apvarun/blist-hugo-theme/blob/main/LICENSEhttps://github.com/apvarun/blist-hugo-theme/blob/main/README.md

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

项目核对记录与介绍依据

模板资料

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

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

这个项目需要核对什么

记录的仓库更新时间
2025-12-31
截图检查日期
2026-10-01

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

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

查看具体选型方法 →

介绍的制作与核对状态

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

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

查看当时使用的来源资料

SHA-256: cb56d400f90a52575aa79a313a30d06c809a466e64ba12b8a33c1381c3ad3134

2026-10-01T14:25:55.190Z

来源文件 / 仓库
# Blist theme for Hugo

![Latest Release](https://img.shields.io/github/tag/apvarun/blist-hugo-theme.svg)
![Blist hugo theme](https://img.shields.io/github/license/apvarun/blist-hugo-theme)
![Hugo generator](https://img.shields.io/badge/generator-hugo-brightgreen)

Blist is a clean and fast blog theme for your Hugo site.

![Blist Icon](https://github.com/apvarun/blist-hugo-theme/raw/main/images/blist-logo.png)

**Features:**

- Responsive content / Mobile-optimized
- Blog pagination
- Customizable Text Search
- Table of contents
- Social links
- Code highlighting
- Color customization
- Dark mode
- Fast performance
- SEO optimized
- i18n support
- Support comments systems
  - Disqus (hugo native)
  - giscus
  - utterances

## Preview

![Preview](https://github.com/apvarun/blist-hugo-theme/raw/main/images/screenshot.png)

➡️ [DEMO](https://blist.vercel.app/)

## Get the theme

Minimum Hugo Version: **0.110.0**

Run from the root of your Hugo site:

```sh
git clone https://github.com/apvarun/blist-hugo-theme.git themes/blist
```

Alternatively, you can include this repository as a [git submodule](https://git-scm.com/docs/gitsubmodules). This makes it easier to update this theme if you have your Hugo site in git as well:

```sh
git submodule add https://github.com/apvarun/blist-hugo-theme.git themes/blist
```

## Preview the theme with example content

Blist theme ships with an fully configured example site. For a quick preview:

Copy the `package.json` file from `themes/blist` folder to your hugo website root folder, and run `npm install`.

```sh
cd themes/blist/exampleSite/
hugo serve --themesDir ../..
```

Then visit `http://localhost:1313/` in your browser to view the example site.

## Configuring theme to a hugo website

1. Copy `package.json` and `package-lock.json` to the root folder of your website
2. Run `npm install` to install required packages for theme
3. Run `npm i -g postcss-cli` to use PostCSS with Hugo build
4. Set `theme = 'blist'` in hugo.toml
5. Run `npm start` to start your local server

Make sure to commit the above changes to your repository.

## Publish your website

When deploying to services like Netlify or Vercel, use the following command for building your site:

```sh
npm i && HUGO_ENVIRONMENT=production hugo --gc
```
The parameter `HUGO_ENVIRONMENT=production` enables the execution of css purging.

## Add content

The following explains how to add content to your Hugo site. You can find sample content in the `exampleSite/` folder.

### Structure:

    .
    ├── ...
    ├── blog       # Blog Section
    │   ├── post1   # Post 1
    │   ├── post2   # Post 2
    │   └── _index
    └── ...

## Configure your site

From `exampleSite/`, copy `hugo.toml` to the root folder of your Hugo site and change the fields as you like. Helpful comments are provided.

### Menu

Menu in Blist theme is pre-set to have all section names. You can include custom links in header using the `menu.main` option hugo.toml.

### Logo

`logo` param in the site config will allow to use an image as the logo instead of the website name. It is localizable and so can have different logo for different languages

### Darkmode

`[params.darkModeToggle]` enables the dark mode toggle in header. The preference is then saved so that the mode is automatically chosen for return visits.

### Customize Ascent Color

Use `[params.ascentColor]` to change the default `pink` color to any supported color from the [list of default colors](https://tailwindcss.com/docs/customizing-colors) from Tailwind CSS.

Some example values: bg-blue-200, bg-yellow-300

### Search

`[params.enableSearch]` option is used to enable search option in the theme.

- Adds the search icon in header
- Generates the search index
- Uses fuse.js to enable searching through content

In order to search, you can either click on the search icon from header or press `Ctrl/Cmd + /` key combination.

**Note:**

Make sure to enable JSON in outputs array.

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

### LaTeX

Enable mathematical options: set `math: true` in your markdown frontmatter

### Google Analytics

Set `services.googleAnalytics.ID` in `hugo.toml` to activate Hugo's [embedded Google Analytics template](https://gohugo.io/templates/embedded/#google-analytics).

## Performance

[![Pagespeed Insights Performance](https://github.com/apvarun/blist-hugo-theme/raw/main/images/pagespeed-performance.png)](https://developers.google.com/speed/pagespeed/insights/?url=https%3A%2F%2Fblist.vercel.app&tab=mobile)

## Issues

If you have a question, please [open an issue](https://github.com/apvarun/blist-hugo-theme/issues) for help and to help those who come after you. The more information you can provide, the better!

## Contributing

Contributions, issues, and feature requests are welcome! For major changes, please open an issue first to discuss what you would like to change.

<table>
  <tr>
    <td align="center"><a href="https://github.com/apvarun"><img alt="apvarun"
          src="https://avatars.githubusercontent.com/u/8411309?v=4" width="117" /><br />apvarun</a></td>
    <td align="center"><a href="https://github.com/Ravinou"><img alt="Ravinou"
          src="https://avatars.githubusercontent.com/u/39600829?v=4" width="117" /><br />Ravinou</a></td>
    <td align="center"><a href="https://github.com/engel-b"><img alt="engel-b"
          src="https://avatars.githubusercontent.com/u/5812810?v=4" width="117" /><br />engel-b</a></td>
    <td align="center"><a href="https://github.com/chris-gillatt"><img alt="chris-gillatt"
          src="https://avatars.githubusercontent.com/u/9963006?v=4" width="117" /><br />chris-gillatt</a></td>
    <td align="center"><a href="https://github.com/apps/dependabot"><img alt="dependabot[bot]"
          src="https://avatars.githubusercontent.com/in/29110?v=4" width="117" /><br />dependabot[bot]</a></td>
    <td align="center"><a href="https://github.com/xLexip"><img alt="xLexip"
          src="https://avatars.githubusercontent.com/u/46321162?v=4" width="117" /><br />xLexip</a></td>
  </tr>
  <tr>
    <td align="center"><a href="https://github.com/AntoineSoetewey"><img alt="AntoineSoetewey"
          src="https://avatars.githubusercontent.com/u/17910063?v=4" width="117" /><br />AntoineSoetewey</a></td>
    <td align="center"><a href="https://github.com/chiragksharma"><img alt="chiragksharma"
          src="https://avatars.githubusercontent.com/u/74889769?v=4" width="117" /><br />chiragksharma</a></td>
    <td align="center"><a href="https://github.com/dlecan"><img alt="dlecan"
          src="https://avatars.githubusercontent.com/u/586631?v=4" width="117" /><br />dlecan</a></td>
    <td align="center"><a href="https://github.com/jpiaskowski"><img alt="jpiaskowski"
          src="https://avatars.githubusercontent.com/u/8420943?v=4" width="117" /><br />jpiaskowski</a></td>
    <td align="center"><a href="https://github.com/lucab85"><img alt="lucab85"
          src="https://avatars.githubusercontent.com/u/24267107?v=4" width="117" /><br />lucab85</a></td>
    <td align="center"><a href="https://github.com/Marty"><img alt="Marty"
          src="https://avatars.githubusercontent.com/u/100658?v=4" width="117" /><br />Marty</a></td>
  </tr>
  <tr>
    <td align="center"><a href="https://github.com/ernavdeepkr"><img alt="ernavdeepkr"
          src="https://avatars.githubusercontent.com/u/50796185?v=4" width="117" /><br />ernavdeepkr</a></td>
    <td align="center"><a href="https://github.com/roypeter"><img alt="roypeter"
          src="https://avatars.githubusercontent.com/u/16620459?v=4" width="117" /><br />roypeter</a></td>
    <td align="center"><a href="https://github.com/janvanveldhuizen"><img alt="janvanveldhuizen"
      src="https://avatars.githubusercontent.com/u/43573150?v=4" width="117" /><br />janvanveldhuizen</a></td>
    <td align="center"><a href="https://github.com/jmflaherty"><img alt="jmflaherty"
      src="https://avatars.githubusercontent.com/u/12985011?v=4" width="117" /><br />jmflaherty</a></td>
  </tr>
</table>

## License

Licensed under [MIT](LICENSE)

## 🤝 Support

Give a ⭐️ if you like this project!

<a href="https://www.buymeacoffee.com/apvarun" target="_blank" rel="noopener"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" height="40" width="145" alt="Buy Me A Coffee"></a>
反馈内容错误

看看同类模板

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

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 · 文档