Hugo作品集博客

hugo-theme-sangai — Hugo 作品集模板

作者 Koustubha-naik

Sangai 是一个基于 Hugo 的博客与作品集主题，强调可读性排版，提供明暗模式、图片灯箱、左侧导航和精选内容滑块等布局能力。

打开源站下载源码 ZIP

看看你的网站会是什么样

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

3 个预览视图

桌面端首页1 / 3

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

桌面端截图首屏预览

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

全部页面与视图 3

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

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

值得关注的模板亮点

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

提供博客、作品集与文档友好的页面布局

内置明暗模式切换、图片灯箱与左侧导航菜单

首页含精选内容滑块，适合展示重点文章或作品

样式基于 SCSS 与 Hugo Pipes 构建

Markdown 图片默认懒加载与异步解码，无需额外配置

支持目录与社交图标

模板详细介绍

Sangai 是一个面向博客、作品集和笔记类内容的 Hugo 主题，定位在清晰、易读的正文呈现。仓库 README 说明它提供博客、作品集与文档友好的布局，并内置左侧导航菜单、精选内容滑块、明暗模式切换和图片灯箱。样式通过 SCSS 与 Hugo Pipes 组织，Markdown 中的图片默认带懒加载与异步解码，无需额外配置。主题使用标准 Hugo 配置，仓库中的 exampleSite/hugo.toml 提供了完整可用的配置示例。安装方式为 Git 子模块或直接克隆到 themes/sangai，然后在 Hugo 配置中设置 theme = "sangai"。使用要求为 Hugo extended v0.120.0 或更高版本，说明该主题依赖扩展版 Hugo 的 SCSS 处理能力。代码以 MIT 许可发布，可免费使用、修改、商用和分发，但演示图片、字体、图标等第三方素材需单独核对许可。

Hugo作品集博客

适合你的项目吗？

适用场景

搭建以长文阅读为主的个人博客
展示图文作品集或项目记录
整理并发布笔记、文档类内容
需要明暗模式与图片灯箱的静态站点

适合人群

使用 Hugo 并希望快速获得可读性排版主题的开发者
需要博客与作品集混合内容的个人站点作者
偏好通过配置文件与示例站点上手主题的用户

上手与定制指南

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

1
需要 Hugo extended v0.120.0 或更高版本
2
推荐以 Git 子模块方式将主题放入 themes/sangai，也可直接克隆
3
在 Hugo 配置中设置 theme = "sangai"
4
可参考仓库 exampleSite/hugo.toml 的完整配置示例
5
演示图片、字体、图标等第三方素材需按各自许可单独核对

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

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

使用时需要遵守

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

额外费用与待核对事项

使用该主题必须安装 Hugo extended 扩展版，且版本不低于 v0.120.0；标准版 Hugo 无法处理其 SCSS 样式，无法正常构建。
演示图片、字体、图标及其他第三方素材需按各自许可核对，不能仅凭代码的 MIT 许可判断。
域名、托管、数据库、支付或 AI 等外部服务可能另外收费。

查看原文依据

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

**Hugo extended** v0.120.0 or later
README 原文

https://github.com/Koustubha-naik/hugo-theme-sangai/blob/main/LICENSE https://github.com/Koustubha-naik/hugo-theme-sangai/blob/main/README.md

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

项目核对记录与介绍依据

模板资料

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

这个分数如何计算

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

这个项目需要核对什么

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

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

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

查看具体选型方法 →

介绍的制作与核对状态

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

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

查看当时使用的来源资料

SHA-256: 084f1c0b47cbfa4d0879b70866050fedaa670e5e58db14a977515a9a65f4297f

2026-10-01T00:16:24.969Z

来源文件 / 仓库


---

# Sangai

Sangai is a clean, modern Hugo theme focused on readable content for blogs, portfolios, and notes.

![Sangai Hugo Theme Screenshot](https://raw.githubusercontent.com/Koustubha-naik/Sangai/main/images/screenshot.png)

---

## Live Demo

👉 https://sangai.koustubha.com/

---

## Features

- Blog, portfolio, and documentation–friendly layouts
- Dark / Light mode toggle
- Built-in image lightbox
- Left-side navigation menu
- Featured content slider
- Responsive design
- Clean and readable typography
- SCSS-based styling with Hugo Pipes
- Optimized for Lighthouse performance
- Table of contents support
- Social icons support

---

## Installation

### Using Git submodule (recommended)

```bash
git submodule add https://github.com/Koustubha-naik/Sangai themes/sangai
````

### Or clone directly

```bash
git clone https://github.com/Koustubha-naik/Sangai themes/sangai
```

Then enable the theme in your Hugo configuration:

```toml
theme = "sangai"
```

---

## Configuration

Sangai uses standard Hugo configuration.

You can refer to the **`exampleSite/hugo.toml`** file in this repository for a complete, working configuration example.

---

## Images

Images used in Markdown benefit from:

* Lazy loading
* Async decoding
* Built-in image lightbox

No additional configuration is required.

---

## Requirements

* **Hugo extended** v0.120.0 or later

---
## License

MIT License © Koustubha Naik

---

反馈内容错误