HugoBlog

hugo-theme-moments — Hugo Blog Template

By FarseaSH

Moments is a Hugo theme designed for short posts, supporting dynamic formats such as images, links, and videos, and is suitable for building an independent sharing space for individuals or small groups.

Explore the design

Compare the page layouts and mobile experience. Open any screenshot for a closer look.

2 previews
Desktop homepage1 / 2
Desktop captureTop of page

Actual screenshot captured by the server browser.

All pages & views 2

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-10-02View source

What stands out

A quick read of the recorded project description.

01

A Hugo theme designed for short posts, with content presented in dynamic formats

02

Responsive layout, adapted separately for desktop and mobile

03

Image browsing experience close to that of social platforms

04

Supports three types of Moments: with images, sharing article links, and embedded videos

05

By design, supports multiple users, and different publishers can set their own names and avatars

06

A free version under the MIT license

Template Details

Moments is a Hugo theme for short-post scenarios, originally developed to provide a space for short texts and updates independent of social platforms. It can be used for personal records of daily life, thoughts, and discoveries, and is also suitable for friends, teams, or couples to maintain a shared space together. The theme is responsive on desktop and mobile, and offers an image browsing experience close to that of social platforms.

In terms of content, the theme supports Moments with images, Moments that share external articles, and Moments with embedded videos, organizing content through front matter fields such as name, signature, avatar, date, tags, pictures, link, and link_text. By design, it supports multiple users, and different publishers can have their own names and avatars.

The theme requires the extended version of Hugo. Installation involves cloning the theme repository into themes/moments in a Hugo site and setting baseURL, languageCode, theme, pagination, as well as title, signature, cover, name, avatar, and other parameters in config.yaml. Create a new Moment with hugo new moments/your_moment_name.md, and refer to the official Hugo documentation for deployment. The anniversary/countdown day, text excerpt quotation, habit check-in, lyrics, map format types, as well as RSS, comments, and card-style themes listed in the README are all marked as under development and are not included in the current version.

HugoBlog

Is it right for your project?

Use Cases

  • Personal records of daily life, thoughts, discoveries, and ideas
  • Building a shared short-update space among friends
  • Teams or couples maintaining a dedicated Moments space
  • Publishing image-and-text updates with multiple pictures
  • Sharing external article links or embedding video content

Suitable For

  • Users familiar with Hugo who want to build a short-post site
  • Individuals who need to record updates independently of social platforms
  • Users who want to build a shared space for friends, teams, or couples
  • Publishers who need mixed dynamic formats of images, links, and videos

Getting started & customization

Use these recorded setup notes alongside the repository instructions for your chosen version.

  1. 1

    Requires the extended version of Hugo

  2. 2

    Use git clone to place the theme repository into the site's themes/moments directory

  3. 3

    Set baseURL, languageCode, theme, pagination, and title, signature, cover, name, avatar, and other parameters in config.yaml

  4. 4

    Use hugo new moments/your_moment_name.md to create a new Moment

  5. 5

    Refer to the official Hugo hosting-and-deployment documentation for deployment

Read repository instructions

License & source material

Usage conditions & limitations

Free to use · keep license notice

This entry covers the free version under the MIT license in the public repository; the free scope is the code of this version and does not mean that external services or third-party assets are free.

Must comply with when using

  • Allows free use, modification, commercial use, and distribution of the code of this version.
  • When distributing copies or substantial portions of the code, retain the original author's copyright notice and the complete MIT license notice.
  • The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.

Additional costs & items to verify

  • Using this theme requires the extended version of Hugo; the regular version cannot be used normally.
  • Demo images, fonts, icons, and other third-party assets must be checked against their respective licenses and cannot be judged solely by the code's MIT license.
  • External services such as domains, hosting, databases, payments, or AI may incur additional charges.
View Original Text Basis

Compiled by DeepSeek based on repository license and README ·2026-10-02. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.

Project checks & description sources

Template Information

Source platforms
Hugo Themes
Documentation and maintenance reference score
More documented · 91 / 100
Technologies
Hugo
Website type
Blog
How this score is calculated

Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.

What to verify for this project

Repository update recorded
2026-07-26
Screenshot last checked
2026-10-02

A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.

The catalog identifies Hugo as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.

Use a selection guide →

How this description was prepared

AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.

Automatically checked against source and license rules; no manual editorial review.

Inspect the recorded source material

SHA-256: 44787cc49ecf860f86f64252bbfbb1540126f2514667f71e7a18711587c771d1

2026-10-02T20:19:31.331Z

Source file / repository
<h1 align=center>Hugo 主题 Moments | <a href="https://farseash.github.io/demo-hugo-theme-moments/demo/">Demo</a></h1>

<p align="center">
    <img src="https://s1.ax1x.com/2023/07/22/pCqEWOx.png" alt="logo" style="width: 60%" />
</p>

Moments是一款专门为短博文设计的[Hugo](https://gohugo.io/)主题。开发初衷是在微信朋友圈之外做一个纯粹写给自己的,独立的短文/动态空间,去记录生活点滴,个人思绪,发现与想法。后面发现Moments的使用对象不仅仅可以是自己,还可以是一群人,你可以为是朋友、团队,亦或情侣搭建一个专有的Moments空间。

Moments is a hugo theme designed for micro-blogging. The original intention is to create a personal space for sharing daily life, thoughts, discoveries & ideas, outside Wechat. Later on, it came to my mind that Moments can be a sharing space not only for a single individual, but also for friends, teams or even couples.

> 我正开发另一个项目——使用Notion,结合Moments主题,免费、快速搭建短博文平台。即将发布。
> 
> I'm currently working on another project: with the help of Notion, together with this Moments theme, build a micro-blogging platform, simple and free. It will be released soon.

## Screenshot

![demo](https://s11.ax1x.com/2024/01/07/pFSuyPU.png)

Check it out 👉 [Moments Demo](https://farseash.github.io/demo-hugo-theme-moments/demo/)

更多Moments用例: [情侣点滴](https://farseash.github.io/demo-hugo-theme-moments/showcases/couple/) | 朋友分享 | 个人成长 | 产品更新

## 特点 Feature

1. 专门支持短博文的 Hugo 主题
2. 响应式设计,桌面端&手机端精心适配
3. 拥有和社交平台一致的图片浏览体验
4. 简洁的设计,纯净的体验,摆脱社交平台广告
5. 支持在 Moments 中分享主流互联网平台的信息(朋友圈文章,知乎,哔哩哔哩, 网易云音乐,等等)
6. 设计上支持多用户,和不同的人一起搭建不同的 Moments 空间


## 不同类型的 Moment 示例

### 附加图片的 Moment

<img src="https://s11.ax1x.com/2024/01/11/pFCm8Et.png" alt="图片集的Moment" style="width: 400px">

```
---
name: Frank
signature: '@Moments 向导 002'
avatar: https://s11.ax1x.com/2024/01/07/pizHZLV.png
date: 2024-01-06T23:04:00+08:00
tags:
  - 美食
pictures:
 - https://s11.ax1x.com/2024/01/07/pizO3tO.png
 - https://s11.ax1x.com/2024/01/07/pizOBAf.png
 - https://s11.ax1x.com/2024/01/07/pizOy9g.png
 - https://s11.ax1x.com/2024/01/07/pizORun.png
 - https://s11.ax1x.com/2024/01/07/pizOI4U.png
 - https://s11.ax1x.com/2024/01/07/pizOTCF.png
 - https://s11.ax1x.com/2024/01/07/pizjpd0.png
 - https://s11.ax1x.com/2024/01/07/pizjiJU.png
 - https://s11.ax1x.com/2024/01/07/pFSkNid.png
note:
---

好嘞~众所周知,美食能治愈一切!以下图片不建议睡前点开。
```

### 分享文章的 Moment

<img src="https://s11.ax1x.com/2024/01/11/pFCmUgg.png" alt="分享链接Moment" style="width: 400px">

```
---
name: Frank
signature: '@Moments 向导 002'
avatar: https://s11.ax1x.com/2024/01/07/pizHZLV.png
date: 2024-01-06T23:07:00+08:00
tags:
  - 好文收藏
link: https://mp.weixin.qq.com/s/T2oxRagwfAAtHao5YqAY1A
link_text: 「好的友谊」的10点标志,你拥有过几点?
note:
---

这篇公众号文章也挺不错的,推荐给大家。
```


### 分享视频的 Moment

<img src="https://s11.ax1x.com/2024/01/14/pFPvjfI.png" alt="分享视频Moment" style="width: 400px">

```
---
name: Frank
signature: '@Moments 向导 002'
avatar: https://s11.ax1x.com/2024/01/07/pizHZLV.png
date: 2024-01-06T23:07:00+08:00
tags:
  - 好看的视频分享
link: //player.bilibili.com/player.html?aid=535243818&bvid=BV1cM41197ui&cid=1312553206&p=1
note:
---

我是B站木鱼水心的粉丝,最近更新的史记系列超级好看。
```

### 更多正在设计开发中的 Moment 类型

- 纪念日 / 倒数日
- 文字摘录引用
- 习惯打卡
- 歌词
- 地图格式

(如果您有任何其它想要添加的类型,欢迎在 [issue](https://github.com/FarseaSH/hugo-theme-moments/issues) 区域提出)

## 安装与部署

### 安装

<!-- todo 要求 -->
**注意:** 主题的使用需要安装 extended 版本的 Hugo,详见 [https://gohugo.io/installation/](https://gohugo.io/installation/)

```bash
$ hugo new site my_moments_name
$ cd my_moments_name
$ git clone https://github.com/FarseaSH/hugo-theme-moments.git themes/moments
```

### 第一次配置

将以下设置覆盖到`config.yaml`文件中

```
baseURL: https://YOUR-MOMENTS-PATH.com
languageCode: zh-Hans
theme: moments
pagination:
    path: .
    pagerSize: 10

params:
    title: "Moments Demo"
    signature: "人生如逆旅,我亦是行人。"
    cover: "default-background.png"

    name: "Me"
    avatar: "avatar.png"
```


#### (Optional) config.yaml 的配置

上面配置文件`config.yaml`中的参数,建议修改以下几项,以满足你的要求。

- `baseURL`: 你所部署发布的网站地址。如果你的主页url是在域名子路径下(如 http://site.com/subpath/),请务必设定此项。
- `paginate`: 单一页面上,显示的Moment的数量
- `title`: 页面顶端的标题
- `signature`: 页面顶端的网站slogan/签名
- `cover`: 页面顶端的封面图
- `name`: Moment默认发布者的名称
- `avatar`: Moment默认发布者的头像(可以为http链接)

### 创建新的Moment

```
hugo new moments/your_moment_name.md
```

### 将自己的Moments发布到网上

请参考Hugo文档deploy部分[Hugo Deploy | Hugo](https://gohugo.io/hosting-and-deployment/hugo-deploy/)

## 更多正在开发的功能

- 更多 Moment 类型支持
- RSS 支持
- Moment 评论功能
- 卡片样式 Moments 主题开发
Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.