Hugo作品集

hugo-starting-point — Hugo 作品集模板

作者 Westley-Winks

基于 Hugo 的作品集起步模板，克隆后修改配置即可使用，并可通过脚本从 GitHub 拉取项目展示。

打开源站下载源码 ZIP

看看你的网站会是什么样

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

3 个预览视图

桌面端首页1 / 3

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

桌面端截图首屏预览

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

全部页面与视图 3

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

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

值得关注的模板亮点

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

克隆仓库后修改 config.toml 中的 baseURL、作者、标题、简介、描述和版权等参数即可使用

通过 repos-to-include.txt 指定要展示的 GitHub 仓库，由 fetch_projects.py 脚本抓取项目信息

附带 GitHub Actions 工作流，推送到 main 分支时自动构建并部署到 GitHub Pages

定时任务每周运行一次抓取脚本并重新构建站点，保持项目列表更新

基于 Goa 主题构建，并参考了开源 Twitter 项目站点的部分代码

模板详细介绍

这是一个用于搭建个人作品集网站的 Hugo 起步模板。它不依赖外部主题安装流程，仓库内已包含完整站点结构，克隆后修改配置即可运行。模板基于 Goa 主题构建，并参考了开源 Twitter 项目站点的部分代码。

内容方面，模板提供首页、关于页和项目页等基本页面。项目页的数据来自仓库根目录的 repos-to-include.txt 列表，由 scripts/fetch_projects.py 脚本调用 GitHub API 抓取对应仓库信息生成。仓库同时附带 GitHub Actions 工作流：推送到 main 分支时自动构建并部署到 GitHub Pages，另有定时任务每周运行一次抓取脚本并重新构建站点。

使用前需要准备 GitHub 用户名和个人访问令牌，写入 .env 文件，并替换 static/img/headshot.jpg 为本人照片。README 也说明该模板除作品集外可用于博客等其他用途，但仓库未提供博客相关的具体配置或示例。

Hugo作品集

适合你的项目吗？

适用场景

个人开发者搭建展示 GitHub 项目的作品集页面
需要自动同步 GitHub 仓库信息到网站的项目展示场景
使用 Hugo 并希望直接部署到 GitHub Pages 的静态站点

适合人群

熟悉 Hugo 基本配置、愿意手动修改配置文件的开发者
希望用脚本自动从 GitHub 拉取项目列表并定期更新的用户
计划将站点托管在 GitHub Pages 上的个人用户

上手与定制指南

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

1
克隆仓库后需修改 config.toml 中的 baseURL、author、title、intro、description、copyright，并取消注释所需社交账号并填写用户名
2
将 static/img/headshot.jpg 替换为本人照片
3
在 repos-to-include.txt 中列出要展示的 GitHub 仓库
4
创建 .env 文件并填入 GH_USERNAME 与 OAUTH_TOKEN（GitHub 个人访问令牌）
5
运行 python scripts/fetch_projects.py 抓取项目数据，再用 hugo server 本地预览

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

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

使用时需要遵守

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

额外费用与待核对事项

使用项目页自动抓取功能需自备 GitHub 账号并创建个人访问令牌（OAUTH_TOKEN），写入 .env 文件；无令牌则无法运行 fetch_projects.py 获取仓库数据。
默认部署配置面向 GitHub Pages，推送到 main 分支时由 GitHub Actions 自动构建部署；若改用其他托管平台需自行调整工作流。
定时工作流每周自动运行抓取脚本并重建站点，会持续调用 GitHub API，需注意令牌有效期与 API 调用额度。
演示图片、字体、图标及其他第三方素材需按各自许可核对，不能仅凭代码的 MIT 许可判断。
域名、托管、数据库、支付或 AI 等外部服务可能另外收费。

查看原文依据

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

Create file called `.env` with these keys: - GH_USERNAME=\<your GitHub username> - OAUTH_TOKEN=\<your personal access token>
README 原文

It is currently setup for GitHub Pages. A GH Action builds and deploys whenever code gets pushed to the `main` branch.
README 原文

Another Action is on cron and will run `fetch_projects.py` and rebuild the site once a week.
README 原文

https://github.com/Westley-Winks/hugo-starting-point/blob/main/LICENSE https://github.com/Westley-Winks/hugo-starting-point/blob/main/README.md

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

项目核对记录与介绍依据

模板资料

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

这个分数如何计算

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

这个项目需要核对什么

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

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

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

查看具体选型方法 →

介绍的制作与核对状态

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

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

查看当时使用的来源资料

SHA-256: 03347b01d1687051382763102887eca86dacb32adf281f8f0615bbe167b22e24

2026-10-01T00:21:35.586Z

来源文件 / 仓库

# Template for basic portfolio using Hugo

Easy starting point for a Hugo website. No setting up complicated themes and easy to change and modify. Contains scripts for automatically pulling GitHub projects but can also be used for a blog or anything else. Demo is located [here](https://westley-winks.github.io/hugo-starting-point/).

Built using [Goa theme](https://github.com/kaapiandcode/hugo-goa) and some code from [open source Twitter](https://opensource.twitter.dev/).

## Usage
1. First, clone this repo to your machine:
`git clone https://github.com/Westley-Winks/hugo-starting-point.git`

2. Then, go into `config.toml` and change parameters. Specifically, change the following:
- baseURL
- author
- title
- intro
- description
- uncomment whichever social accounts and add in the corresponding usernames
- copyright

3. Navigate to `static/img/` and replace `headshot.jpg` with a photo of yourself.

4. Change `repos-to-include.txt` to your GitHub repos that you want to display on the projects page

5. Create file called `.env` with these keys:
- GH_USERNAME=\<your GitHub username>
- OAUTH_TOKEN=\<your personal access token>

OAUTH_TOKEN is your Personal Access Token for GitHub

6. Run `fetch_projects.py`:
`python scripts/fetch_projects.py`

7. Check it out by running `hugo server`!

8. Deploy.
It is currently setup for GitHub Pages. A GH Action builds and deploys whenever code gets pushed to the `main` branch. Another Action is on cron and will run `fetch_projects.py` and rebuild the site once a week.

反馈内容错误