Hugo博客

DoIt — Hugo 博客模板

作者 HEIGE-PCloud

DoIt 是 HEIGE-PCloud 维护的 Hugo 博客主题，基于 LoveIt、LeaveIt、KeepIt 发展而来，采用 MIT 许可，提供演示站点与完整文档。

打开源站下载源码 ZIP

看看你的网站会是什么样

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

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

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

全部页面与视图 3

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

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

值得关注的模板亮点

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

01

基于 LoveIt、LeaveIt、KeepIt 发展而来的 Hugo 博客主题，仓库采用 MIT 许可

02

提供响应式布局、明暗模式、分页、可展开目录、多语言与 i18n、PWA 兼容

03

通过扩展 Markdown 与 shortcode 支持 KaTeX 公式、mermaid 图表、ECharts、Mapbox、音乐与 Bilibili 播放器

04

支持 algolia、Fuse.js、Pagefind 搜索，以及 Disqus、Waline、Twikoo、giscus 等多种评论系统

05

可接入多类统计与搜索引擎验证服务，支持多作者、第三方库 CDN 与远程图片缓存

模板详细介绍

DoIt 是一个面向 Hugo 的博客主题，由 HEIGE-PCloud 维护，仓库采用 MIT 许可。它基于 LoveIt、LeaveIt 和 KeepIt 三个主题发展而来，继承其功能并在此基础上增加新功能与优化。主题定位是让使用者直接进入内容创作，而不必处理复杂的技术细节。

在内容呈现方面，DoIt 提供响应式布局、明暗两种模式、分页、可展开的目录、多语言与 i18n 支持、CSS 动画，以及为宽屏优化的页面布局和 PWA 兼容。文章层面支持代码高亮与一键复制代码、图片画廊、Twemoji，以及通过扩展 Markdown 语法实现的 Font Awesome 图标、注音和分数写法；同时提供 KaTeX 数学公式、mermaid 图表、ECharts 数据可视化、Mapbox 地图、APlayer 与 MetingJS 音乐播放器、Bilibili 播放器、多种 admonition 以及自定义样式、脚本和友链等 shortcode。

站点功能方面，主题支持 algolia、Fuse.js 或 Pagefind 搜索，最多 64 个社交链接与 28 个分享站点，并接入 Disqus、Gitalk、Valine、Waline、Twikoo、Vssue、Remark42、giscus、Artalk、Utterances、Commento、Facebook 评论、Telegram 评论等多种评论系统。统计与验证方面支持 Google Analytics、Fathom、百度统计、Umami、Plausible、Cloudflare Web Analytics、Splitbee、Matomo，以及 Google、Bing、Yandex、百度的搜索引擎验证。主题还支持第三方库 CDN、多作者、远程图片缓存和 cookie 同意横幅。

使用限制与注意事项：README 中列出的性能分数、功能清单与第三方服务均为项目自述，未在本资料中逐项核验；主题依赖的字体、图标、播放器、评论与统计等第三方资源有各自的许可与使用条件，代码的 MIT 许可不覆盖这些素材，也不代表外部服务免费。仓库更新频繁，README 明确不推荐直接下载 release 压缩包，因为发布版本可能滞后。

Hugo博客

适合你的项目吗？

适用场景

  • 用 Hugo 搭建以文章为主的个人博客或技术博客
  • 在文章中嵌入数学公式、流程图、数据可视化图表或音乐、视频内容
  • 需要多语言站点、明暗模式切换和站内搜索的博客项目
  • 希望从 LoveIt 主题迁移到功能更丰富的 Hugo 主题

适合人群

  • 使用 Hugo 构建静态博客的开发者
  • 需要在文章中嵌入公式、图表、播放器等富内容形式的写作者
  • 需要多语言、多作者或多种评论系统接入的博客站点
  • 已使用 LoveIt 并希望迁移到延续其设计的主题的用户

上手与定制指南

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

  1. 1

    推荐以 git submodule 方式将仓库加入站点目录：git submodule add https://github.com/HEIGE-PCloud/DoIt.git themes/DoIt

  2. 2

    在 config.toml 中将 theme 改为 DoIt，从 LoveIt 迁移时只需修改该配置项

  3. 3

    README 不推荐下载 release 压缩包，因为仓库更新频繁，发布版本可能滞后

  4. 4

    本地构建文档可执行 hugo server --source=exampleSite

  5. 5

    使用前请核对字体、图标、播放器、评论与统计等第三方素材和服务的各自许可与费用

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

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

使用时需要遵守

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

额外费用与待核对事项

  • README 不推荐下载 release 压缩包，因为仓库更新频繁，发布版本可能滞后；建议以 git submodule 方式引入并定期更新。
  • Mapbox 地图 shortcode 依赖 Mapbox GL JS，使用该功能通常需要 Mapbox 账号与访问令牌，可能产生外部服务费用。
  • algolia 搜索需要注册 Algolia 账号并配置 API 密钥，属于外部服务；Fuse.js 与 Pagefind 为本地方案。
  • Disqus 等评论系统需在对应第三方平台注册账号并配置站点标识，评论数据托管于外部服务。
  • Google Analytics、Fathom、百度统计、Umami、Plausible、Cloudflare、Splitbee、Matomo 等统计服务需自行注册账号并配置，部分为付费服务。
  • 主题内置 Font Awesome、Simple Icons、KaTeX、mermaid、ECharts、APlayer、MetingJS、lightgallery.js、TypeIt 等第三方资源，各自遵循其自身许可，MIT 代码许可不覆盖这些素材。
  • 演示图片、字体、图标及其他第三方素材需按各自许可核对，不能仅凭代码的 MIT 许可判断。
  • 域名、托管、数据库、支付或 AI 等外部服务可能另外收费。
查看原文依据

Permission is hereby granted, free of charge

许可证原文

Not recommended, the repo is being updated frequently so the releases may out of date.

README 原文

**Mapbox** shortcode supported by [Mapbox GL JS](https://docs.mapbox.com/mapbox-gl-js)

README 原文

**Search** supported by [algolia](https://www.algolia.com/), [Fuse.js](https://fusejs.io/) or [Pagefind](https://pagefind.app)

README 原文

**Disqus** comment system supported by [Disqus](https://disqus.com)

README 原文

**[Google Analytics](https://analytics.google.com/analytics)** supported

README 原文

Thanks to the authors of following resources included in the theme:

README 原文
https://github.com/HEIGE-PCloud/DoIt/blob/main/LICENSEhttps://github.com/HEIGE-PCloud/DoIt/blob/main/README.md

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

项目核对记录与介绍依据

模板资料

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

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

这个项目需要核对什么

记录的仓库更新时间
2026-09-30
截图检查日期
2026-09-30

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

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

查看具体选型方法 →

介绍的制作与核对状态

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

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

查看当时使用的来源资料

SHA-256: b3955a3cf032bcae24b7bdb802055f12732f7a333dfa8cd8a087bbe7947a1593

2026-09-30T09:39:38.612Z

来源文件 / 仓库
# DoIt Theme | Hugo

English README | [简体中文说明](https://github.com/HEIGE-PCloud/DoIt/blob/main/README.zh-cn.md)

> **DoIt** is a **clean**, **elegant** and **advanced** blog theme for [Hugo](https://gohugo.io/).

It is based on the [LoveIt Theme](https://github.com/dillonzq/LoveIt), [LeaveIt Theme](https://github.com/liuzc/LeaveIt) and [KeepIt Theme](https://github.com/Fastbyte01/KeepIt).

The DoIt theme inherits the excellent functions of these themes, and adds new functions and optimizations on this basis. Please read [Why Choose DoIt](#why-choose-doit) to learn more.

The goal of DoIt theme is to create a powerful and easy-to-use Hugo theme, so you can go straight into your blog content creation and just **do it** without worrying about the complex technical details.

## Getting started

Head to this [documentation page](https://hugodoit.pages.dev/theme-documentation-basics/) for a complete guidance to get started with the DoIt theme.

## Migrate from LoveIt

If you are currently using the LoveIt theme, it is very easy to migrate to DoIt.

You can add this repo as a submodule of your site directory.

```bash
git submodule add https://github.com/HEIGE-PCloud/DoIt.git themes/DoIt
```

And later you can update the submodule in your site directory to the latest commit using this command:

```bash
git submodule update --remote --merge
```

Alternatively, you can download the [latest release .zip file](https://github.com/HEIGE-PCloud/DoIt/releases) of the theme and extract it in the themes directory. (Not recommended, the repo is being updated frequently so the releases may out of date.)

Next, go to the `config.toml` and change the default theme to `DoIt`.

```diff
- theme = "LoveIt"
+ theme = "DoIt"
```

Now the migration is finished and everything is ready 🎉

Many new features and configurations have been added to the DoIt theme, check the [changelog](https://github.com/HEIGE-PCloud/DoIt/blob/main/CHANGELOG.md) and [documentation](https://hugodoit.pages.dev/) for more information.

## [Demo Site](https://hugodoit.pages.dev/)

To see this theme in action, here is a live [demo site](https://hugodoit.pages.dev/) which is rendered with **DoIt** theme.

## Why choose DoIt

* Custom **Header**
* Custom **CSS Style**
* A new **home page**, compatible with the latest version of Hugo
* A lot of **style detail adjustments,** including color, font size, margins, code preview style
* More readable **dark mode**
* Some beautiful **CSS animations**
* Easy-to-use and self-expanding **table of contents**
* More **social links**, **share sites** and **comment system**
* **Search** supported by [algolia](https://www.algolia.com/), [Fuse.js](https://fusejs.io/) or [Pagefind](https://pagefind.app)
* **Copy code** to clipboard with one click
* Extended Markdown syntax for **[Font Awesome](https://fontawesome.com/) icons**
* Extended Markdown syntax for **ruby annotation**
* Extended Markdown syntax for **fraction**
* **Mathematical formula** supported by [KaTeX](https://katex.org/)
* **Diagram syntax** shortcode supported by [mermaid](https://github.com/knsv/mermaid)
* **Interactive data visualization** shortcode supported by [ECharts](https://echarts.apache.org/)
* **Mapbox** shortcode supported by [Mapbox GL JS](https://docs.mapbox.com/mapbox-gl-js)
* Embedded **music player** supported by [APlayer](https://github.com/MoePlayer/APlayer) and [MetingJS](https://github.com/metowolf/MetingJS)
* **Bilibili** player supported
* Kinds of **admonitions** shortcode supported
* Custom style shortcodes supported
* **CDN** for all third-party libraries supported
* **Multiple Authors** supported
* ...

In short,
if you prefer the design language and freedom of the DoIt theme,
if you want to use the extended Font Awesome icons conveniently,
if you want to embed mathematical formulas, flowcharts, music or Bilibili videos in your posts,
the DoIt theme may be more suitable for you.

## Features

### Performance and SEO

* Optimized for **performance**: 99/100 on mobile and 100/100 on desktop in [Google PageSpeed Insights](https://developers.google.com/speed/pagespeed/insights)
* Optimized SEO performance with a correct **SEO SCHEMA** based on JSON-LD
* **[Google Analytics](https://analytics.google.com/analytics)** supported
* **[Fathom Analytics](https://usefathom.com/)** supported
* **[Baidu Analytics](https://tongji.baidu.com/)** supported
* **[Umami Analytics](https://umami.is/)** supported
* **[Plausible Analytics](https://plausible.io/)** supported
* **[Cloudflare Web Analytics](https://www.cloudflare.com/web-analytics)** supported
* **[Splitbee Analytics](https://splitbee.io)** supported
* **[Matomo Analytics](http://www.matomo.com/)** supported
* Search engine **verification** supported (Google, Bind, Yandex and Baidu)
* **CDN** for third-party libraries supported

### Appearance and Layout

* **Responsive** layout
* **Light/Dark** mode
* Globally consistent **design language**
* **Pagination** supported
* Easy-to-use and self-expanding **table of contents**
* **Multilanguage** supported and i18n ready
* Beautiful **CSS animation**
* Brand new **Page Layout** optimized for wide screens
* Compatibility for **PWA**

### Social and Comment Systems

* **Gravatar** supported by [Gravatar](https://gravatar.com)
* Local **Avatar** supported
* Up to **64** social links supported
* Up to **28** share sites supported
* **Disqus** comment system supported by [Disqus](https://disqus.com)
* **Gitalk** comment system supported by [Gitalk](https://github.com/gitalk/gitalk)
* **Valine** comment system supported by [Valine](https://valine.js.org/)
* **Waline** comment system supported by [Waline](https://waline.js.org/)
* **Facebook comments** system supported by [Facebook](https://developers.facebook.com/docs/plugins/comments/)
* **Telegram comments** system supported by [Telegram Comments](https://comments.app/)
* **Commento** comment system supported by [Commento](https://commento.io/)
* **Utterances** comment system supported by [Utterances](https://utteranc.es/)
* **Twikoo** comment system supported by [Twikoo](https://twikoo.js.org/)
* **Vssue** comment system supported by [Vssue](https://vssue.js.org/)
* **Remark42** comment system supported by[Remark42](https://remark42.com/)
* **giscus** comment system supported by [giscus](https://giscus.app/)
* **Artalk** comment system supported by [Artalk](https://artalk.js.org/)

### Extended Features

* **Search** supported by [algolia](https://www.algolia.com/) or [Fuse.js](https://fusejs.io/)
* **Twemoji** supported
* Automatically **highlighting** code
* **Copy code** to clipboard with one click
* **Images gallery** supported by [lightgallery.js](https://github.com/sachinchoolur/lightgallery.js)
* Extended Markdown syntax for **[Font Awesome](https://fontawesome.com/) icons**
* Extended Markdown syntax for **ruby annotation**
* Extended Markdown syntax for **fraction**
* **Mathematical formula** supported by [KaTeX](https://katex.org/)
* **Diagrams** shortcode supported by [mermaid](https://github.com/knsv/mermaid)
* **Interactive data visualization** shortcode supported by [ECharts](https://echarts.apache.org/)
* **Mapbox** shortcode supported by [Mapbox GL JS](https://docs.mapbox.com/mapbox-gl-js)
* **Music player** shortcode supported by [APlayer](https://github.com/MoePlayer/APlayer) and [MetingJS](https://github.com/metowolf/MetingJS)
* **Bilibili player** shortcode
* Kinds of **admonitions** shortcode
* **Custom style** shortcode
* **Custom script** shortcode
* **Custom friend** shortcode
* **Animated typing** supported by [TypeIt](https://typeitjs.com/)
* **Dynamic scroll** supported by native CSS
* **Cookie consent banner** supported by [cookieconsent](https://github.com/osano/cookieconsent)
* Option to **cache remote images**
* ...

## [Documentation](https://hugodoit.pages.dev/categories/documentation/)

Build Documentation Locally:

```bash
hugo server --source=exampleSite
```

## Multilingual and i18n

DoIt supports the following languages:

* English
* Simplified Chinese
* French
* Polish
* Brazilian Portuguese
* Italian
* Spanish
* German
* Serbian
* Russian
* Romanian
* Vietnamese
* Arabic
* Catalan
* Hindi
* Indonesian
* Korean
* European Portuguese
* Tegulu
* Thai
* Turkish
* Ukrainian
* Traditional Chinese
* [Contribute with a new language](https://github.com/HEIGE-PCloud/DoIt/pulls)

[Languages Compatibility](https://hugodoit.pages.dev/theme-documentation-basics/#language-compatibility)

## [Roadmap](https://github.com/HEIGE-PCloud/DoIt/projects/1)

## [Changelog](https://github.com/HEIGE-PCloud/DoIt/blob/main/CHANGELOG.md)

## Questions, ideas, bugs, pull requests

All feedback is welcome! Head over to the [issue tracker](https://github.com/HEIGE-PCloud/DoIt/issues).

## License

DoIt is licensed under the **MIT** license. Check the [LICENSE file](https://github.com/HEIGE-PCloud/DoIt/blob/master/LICENSE) for details.

Thanks to the authors of following resources included in the theme:

* [Font Awesome](https://fontawesome.com/)
* [Simple Icons](https://github.com/simple-icons/simple-icons)
* [autocomplete.js](https://github.com/algolia/autocomplete.js)
* [algoliasearch](https://github.com/algolia/algoliasearch-client-javascript)
* [Fuse.js](https://fusejs.io/)
* [object-fit-images](https://github.com/fregante/object-fit-images)
* [Twemoji](https://github.com/twitter/twemoji)
* [lightgallery.js](https://github.com/sachinchoolur/lightgallery.js)
* [Sharer.js](https://github.com/ellisonleao/sharer.js)
* [TypeIt](https://typeitjs.com/)
* [KaTeX](https://katex.org/)
* [mermaid](https://github.com/knsv/mermaid)
* [ECharts](https://echarts.apache.org/)
* [Mapbox GL JS](https://docs.mapbox.com/mapbox-gl-js)
* [APlayer](https://github.com/MoePlayer/APlayer)
* [MetingJS](https://github.com/metowolf/MetingJS)
* [Gitalk](https://github.com/gitalk/gitalk)
* [Valine](https://valine.js.org/)
* [Waline](https://waline.js.org/)
* [Twikoo](https://twikoo.js.org/)
* [Vssue](https://vssue.js.org/)
* [Remark42](https://remark42.com/)
* [cookieconsent](https://github.com/osano/cookieconsent)

## Author

[PCloud](https://github.com/HEIGE-PCloud)
反馈内容错误

看看同类模板

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

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