Hugo作品集

iammiti99 — Hugo 作品集模板

作者 tiennm99

iammiti99 是一个用 Hugo 和仓库内置 bonsai 主题搭建的个人 link-in-bio 页面，作为自托管的 Linktree 替代品，通过 GitHub Actions 部署到 GitHub Pages。

打开源站下载源码 ZIP

看看你的网站会是什么样

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

2 个预览视图

桌面端首页1 / 2

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

桌面端截图首屏预览

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

全部页面与视图 2

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

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

值得关注的模板亮点

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

用 Hugo 与仓库内置的 bonsai 主题生成静态 link-in-bio 页面

页面内容集中在 hugo.yml 的 params 块，改完推送 main 即触发构建

GitHub Actions 构建并部署到 GitHub Pages，首次运行自动启用 Pages

支持 Cloudflare Pages、Netlify、Vercel 等静态托管，需设置 HUGO_VERSION 环境变量

可选自定义域名，通过 static/CNAME 文件传递

采用 Apache-2.0 许可，仓库内保留 bonsai 主题完整历史

模板详细介绍

这是一个个人链接聚合页面模板，作者用它替代 Linktree 这类第三方服务。页面内容集中在 hugo.yml 的 params 块中，修改后推送到 main 分支即可触发 GitHub Actions 构建，由 Hugo 加 bonsai 主题生成静态站点并部署到 GitHub Pages。仓库自带 bonsai 主题（保留完整历史），并包含 content/_index.md 占位文件、static/images/ 头像目录和部署工作流。本地开发需要 Hugo Extended 0.128 或更高版本，可用 hugo server 预览、hugo --gc --minify 构建到 public 目录。部署方面，工作流首次运行会通过 actions/configure-pages 自动启用 Pages，前提是仓库的 Actions 工作流权限设为读写；可选自定义域名只需在 static/CNAME 写入域名。hugo.yml 的 baseURL 设为 /，GitHub Pages 工作流会覆盖为 Pages 地址，因此只有该主机使用 /iammiti99/ 子路径。也可部署到 Cloudflare Pages、Netlify 或 Vercel，构建命令为 hugo --gc --minify，输出目录 public，需设置 HUGO_VERSION 环境变量；不设置 HUGO_BASEURL 时站点从主机根路径提供，但 og:image 和 canonical 链接保持相对路径。

Hugo作品集

适合你的项目吗？

适用场景

个人在 GitHub Pages 上托管一个链接聚合页面
把 Linktree 类页面迁移到自有域名和自有仓库
作为 Hugo 静态站点部署流程（Actions + Pages）的参考
在 Cloudflare Pages、Netlify 或 Vercel 上部署同一套 Hugo 构建

适合人群

希望自托管 link-in-bio 页面的个人用户
熟悉或愿意使用 Hugo 与 Git 工作流的开发者
需要把链接页部署到 GitHub Pages 或其他静态托管的人
想基于现成 bonsai 主题修改页面内容的使用者

上手与定制指南

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

1
本地开发需要 Hugo Extended 0.128 或更高版本
2
编辑 hugo.yml 的 params 块以修改页面内容
3
推送到 main 分支后由 GitHub Actions 构建并部署到 GitHub Pages
4
仓库需将 Settings → Actions → General → Workflow permissions 设为 Read and write
5
部署到其他托管平台时构建命令用 hugo --gc --minify，输出目录为 public，并设置 HUGO_VERSION 环境变量

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

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

使用时需要遵守

允许免费使用、修改、商用和分发；分发时需随附 Apache-2.0 许可证。
修改过的文件需显著标明改动，并保留相关版权、专利、商标及归属声明。
若原项目附有 NOTICE 文件，分发衍生作品时需保留其中适用的归属声明。
许可包含适用的贡献者专利授权；发起许可所述专利诉讼会终止该专利授权，且不授予商标使用权。
代码按现状提供；担保与责任限制以原许可证及适用法律为准。

额外费用与待核对事项

README 明确说明该页面是作者自用的自托管 Linktree 替代品，属于个人用途项目，并非面向通用场景的成品模板。
本地开发与构建必须使用 Hugo Extended 0.128 或更高版本，普通版 Hugo 无法满足要求。
使用 GitHub Actions 自动部署到 GitHub Pages 时，需将仓库的 Workflow permissions 设为 Read and write，否则首次运行无法自动启用 Pages。
部署到 Cloudflare Pages、Netlify、Vercel 等其他托管平台时，需设置 HUGO_VERSION 环境变量为 0.154.0（Hugo Extended）。
若不设置 HUGO_BASEURL 环境变量，站点虽可从主机根路径访问，但 og:image 与 canonical 链接会保持相对路径，影响社交预览。
演示图片、字体、图标及其他第三方素材需按各自许可核对，不能仅凭代码的 Apache-2.0 许可判断。
域名、托管、数据库、支付或 AI 等外部服务可能另外收费。

查看原文依据

no-charge, royalty-free, irrevocable copyright license
许可证原文

Self-hosted Linktree alternative for my own use.
README 原文

Requires Hugo Extended ≥ 0.128.
README 原文

provided **Settings → Actions → General → Workflow permissions** is set to "Read and write"
README 原文

Env `HUGO_VERSION` | `0.154.0` (Hugo Extended)
README 原文

Without `HUGO_BASEURL` the site is served from the host's root URL, but `og:image` and the canonical link stay relative.
README 原文

https://github.com/tiennm99/iammiti99/blob/main/LICENSE https://github.com/tiennm99/iammiti99/blob/main/README.md

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

项目核对记录与介绍依据

模板资料

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

这个分数如何计算

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

这个项目需要核对什么

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

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

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

查看具体选型方法 →

介绍的制作与核对状态

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

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

查看当时使用的来源资料

SHA-256: 498d686195ca25cdb3479218b9b0e4da71d232dd4209223330813aad6827e22d

2026-10-03T07:24:18.932Z

来源文件 / 仓库

# iammiti99

Personal link-in-bio page — built with [Hugo](https://gohugo.io) and the
[bonsai](themes/bonsai) theme. Self-hosted Linktree
alternative for my own use.

## How it works

Edit [`hugo.yml`](hugo.yml) (`params:` block) → push to `main` → GitHub
Actions builds with Hugo + bonsai → output deploys to GitHub Pages.

## Local development

Requires Hugo Extended ≥ 0.128.

```bash
hugo server          # http://localhost:1313
hugo --gc --minify   # build to ./public
```

## Deployment

Every push to `main` deploys to GitHub Pages. The workflow self-enables Pages
on first run via `actions/configure-pages@v5` with `enablement: true`, so no
manual UI setup is required for fresh forks (provided **Settings → Actions →
General → Workflow permissions** is set to "Read and write").

(Optional) Custom domain: drop a `static/CNAME` file containing your apex
domain — Hugo will copy it through to the deployed site.

### Base URL

`hugo.yml` sets `baseURL: /`, so a plain `hugo` build serves from the domain
root. The GitHub Pages workflow overrides it with the Pages URL
(`https://<owner>.github.io/iammiti99/`), so only that host gets the
`/iammiti99/` subpath.

### Other hosts (Cloudflare Pages, Netlify, Vercel)

| Setting | Value |
|---|---|
| Build command | `hugo --gc --minify` |
| Output directory | `public` |
| Env `HUGO_VERSION` | `0.154.0` (Hugo Extended) |
| Env `HUGO_BASEURL` (optional) | the site's full URL, e.g. `https://iammiti99.pages.dev/` |

Without `HUGO_BASEURL` the site is served from the host's root URL, but
`og:image` and the canonical link stay relative. Set it so social link previews
get absolute URLs.

## Project layout

```
hugo.yml                 # site content — edit params here
content/_index.md        # placeholder so Hugo renders the index
static/images/           # avatar etc.
themes/bonsai/           # bonsai theme (in-repo, full history)
.github/workflows/deploy.yml
public/                  # build output (gitignored)
```

## License

[Apache License 2.0](LICENSE)

反馈内容错误