Jekyll 静态站点,内容以 YAML 数据文件与 Markdown 文件维护
portfolio-website — Jekyll 作品集模板
作者 iamHrithikRaj
基于 Jekyll 的个人作品集与博客模板,通过 YAML 数据文件维护项目、经历与教育信息,可部署到 Netlify 或 GitHub Pages。
看看你的网站会是什么样
浏览真实页面截图,比较内容排版与手机效果。点击下方缩略图切换,放大查看整页细节。
全部页面与视图 2
截图用于了解视觉与布局,交互效果请以实际项目为准。
值得关注的模板亮点
从已有项目资料中,快速了解它的特点。
`_data` 下 projects.yml、experience.yml、education.yml 分别管理项目、经历与教育信息
项目详情页为 projects 目录中的 Markdown 文件,通过 page-name 字段与列表条目关联
README 提供 Netlify 与 GitHub Pages 两种部署路径
采用 MIT 许可,可免费使用、修改、商用与分发代码
模板详细介绍
这是一个 Jekyll 静态网站模板,用于搭建个人作品集网站,同时包含博客/项目文章功能。站点内容主要由 `_data` 目录下的 `projects.yml`、`experience.yml` 和 `education.yml` 三个数据文件驱动,分别填写项目、工作经历和教育背景,模板会据此渲染列表。项目详情页则以 Markdown 文件形式放在 `projects` 目录中,文件头部使用 `title` 与 `layout: page`,并在 `projects.yml` 对应条目里通过 `page-name` 字段关联。
使用前需要修改 `_config.yml` 填入个人信息,并把 `url` 改为实际托管地址(需保留结尾的斜杠)。README 说明可部署到 Netlify 或 GitHub Pages,但 GitHub Pages 仅支持 `username.github.io` 这种用户主页形式,不支持 `username.github.io/repo-name` 的项目子路径。本地开发需安装 Ruby 与 Bundler,执行 `bundle install --path vendor/bundle` 后运行 `bundle exec jekyll serve`。
模板采用 MIT 许可,允许免费使用、修改、商用和分发代码,但演示图片、字体、图标等第三方素材需单独核对许可,域名、托管等外部服务也可能产生费用。仓库未提供更细的样式与组件说明,具体视觉与交互以演示站点和源码为准。
适合你的项目吗?
适用场景
- 搭建个人作品集主页,集中展示项目、工作经历与教育背景
- 为每个项目撰写独立的 Markdown 详情页并链接到项目列表
- 在 GitHub Pages 用户主页或 Netlify 上托管静态站点
- 本地使用 Ruby 与 Bundler 运行 Jekyll 服务进行开发调试
适合人群
- 有 Jekyll 或静态站点使用经验、愿意直接编辑 YAML 与 Markdown 的开发者
- 需要同时呈现作品集与项目文章的个人开发者或学生
- 计划使用 Netlify 或 GitHub Pages 用户主页部署站点的人
上手与定制指南
结合仓库当前版本的说明,按下面的资料检查内容、配置与运行要求。
- 1
点击仓库的 Use the Template 按钮创建自己的副本
- 2
修改 `_config.yml` 填入个人信息,并将 `url` 改为实际托管地址且保留结尾斜杠
- 3
在 `_data` 目录填写 `projects.yml`、`experience.yml`、`education.yml`
- 4
项目详情页需在 `projects` 目录新建 Markdown 文件,并在 `projects.yml` 中添加对应 `page-name`
- 5
本地开发需安装 Ruby 与 Bundler,执行 `bundle install --path vendor/bundle` 和 `bundle exec jekyll serve`
授权与来源资料
使用条件与限制
免费使用 · 保留许可声明本次收录的是公开仓库中采用 MIT 许可的免费版本;免费范围为该版本代码,不代表外部服务或第三方素材免费。
使用时需要遵守
- 允许免费使用、修改、商用和分发该版本代码。
- 分发代码副本或实质性部分时,保留原作者版权声明和完整 MIT 许可声明。
- 代码按现状提供;担保与责任限制以原许可证及适用法律为准。
额外费用与待核对事项
- 部署到 GitHub Pages 时仅支持用户主页形式(username.github.io),不支持项目子路径(username.github.io/repo-name);如需子路径托管需改用 Netlify 等其他方式。
- 本地开发或预览需自行安装 Ruby 与 Bundler 环境,并执行 bundle install 与 jekyll serve,非纯静态即开即用。
- 演示图片、字体、图标及其他第三方素材需按各自许可核对,不能仅凭代码的 MIT 许可判断。
- 域名、托管、数据库、支付或 AI 等外部服务可能另外收费。
查看原文依据
Permission is hereby granted, free of charge
许可证原文
Use something like Netlify or GitHub Pages to deploy (note, this only works on username.github.io, not username.github.io/repo-name)
README 原文
https://github.com/iamHrithikRaj/portfolio-website/blob/main/LICENSEhttps://github.com/iamHrithikRaj/portfolio-website/blob/main/README.mdMake sure to have Ruby and Bundler installed.
README 原文
DeepSeek 根据仓库许可证和 README 整理 ·2026-10-03。结果仅覆盖已读取资料,依赖、图片、字体及后续条款变更以各自原文为准。
项目核对记录与介绍依据
模板资料
- 来源平台
- GitHub
- 资料与维护参考分
- 资料一般 · 73 / 100
- 技术栈
- Jekyll
- 网站类型
- 作品集 · 博客
这个分数如何计算
本站按许可资料(最高30分)、演示链接(12分)、预览图(10分)、Star数(15分)、记录的维护时间(15分)、描述完整度(8分)、功能记录(5分)和分类资料(5分)计算。它不是代码、安全或性能测试,也不是 Google 评分;有链接不代表已实测可用。
这个项目需要核对什么
- 记录的仓库更新时间
- 2021-08-21
- 截图检查日期
- 2026-10-03
已收录演示链接。请用你的内容与屏幕尺寸检查;有演示不代表表单、认证或支付已经可用。
目录记录的主要技术栈是 Jekyll。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料,不代表代码审计或部署实测。
查看具体选型方法 →介绍的制作与核对状态
介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。
审核声明: [email protected] · 2026-10-04
查看当时使用的来源资料
SHA-256: 340cb5031197c7c39523cac89289dca8f96b9420162116a5cc7aef2589dae8df
2026-10-03T23:26:17.437Z
来源文件 / 仓库# Portfolio Template
[](https://bug-busters-portfolio.netlify.app/)
## Make your own!
1. Use the Template button.
2. Update `_config.yml` to contain your information.
1. Change `url` to the URL you'll be hosting it at
2. Make sure it has the /
3. Use something like Netlify or GitHub Pages to deploy (note, this only works on username.github.io, not username.github.io/repo-name)
## Add your portfolio
Head to `_data` and fill out either `projects.yml`, `experience.yml` and `education.yml`.
Project example.
```yaml
- title: Machine Learning Project
event: MLH Fellowship Pre Fellowship - Batch 3.5
date: Fall 2020
```
Experience example.
```yaml
- role: Pre Fellowship Fellow
company: MLH Fellowship
dates: Summer 2021
logo: fellowship.svg
```
Education example.
```yaml
- course: Pre Fellowship Fellow
institute: MLH Fellowship
dates: Summer 2021
logo: fellowship.svg
```
## Add project posts
1. Make a new `.md` file inside of `projects`.
2. Add the header to your markdown file (see below) and change the title to the name of your blog post.
3. Write your project page! Can be a README from GitHub or your Devpost page.
4. Add the `page-name` field to your `projects.yml` (see below).
Top of post markdown file post.
```
---
title: Project
layout: page
---
```
`projects.yml` with the `page-name` field.
```yaml
- title: Machine Learning Project
event: MLH Fellowship Pre Fellowship - Batch 3.5
date: Summer 2021
page-name: project
```
## Development
If you want to test it locally or add some new features, run the below commands. Make sure to have Ruby and Bundler installed.
```
bundle install --path vendor/bundle
bundle exec jekyll serve
```
看看同类模板
对比同技术栈与用途的模板,找到更适合的视觉与内容结构。

al-folio
al-folio 是一个面向学者与研究人员的 Jekyll 作品集主题,设计简洁、响应式,适合搭建个人学术主页。
Jekyll · 作品集

minimal-mistakes
:triangular_ruler: Jekyll theme for building a personal site, blog, project documentation, or portfolio.
Jekyll · 作品集

Beautiful Jekyll
Beautiful Jekyll 是一个在 Jekyll 生态中经过长期打磨的博客主题,由 Dean Attali 维护,自 2015 年起积累了超过 5 万用户。
Jekyll · 博客

jekyll-TeXt-theme
💎 🐳 A super customizable Jekyll theme for personal site, team site, blog, project, documentation, etc.
Jekyll · 博客

startbootstrap-clean-blog-jekyll
A Jekyll version of the Clean Blog theme by Start Bootstrap
Jekyll · 博客

So Simple
So Simple 是 Michael Rose 开发的 Jekyll 主题,定位清晰:为文字和图片提供一个干净、可读性强的展示框架。
Jekyll · 博客
