Jekyll作品集

portfolio-template (MLH-Fellowship) — Jekyll 作品集模板

作者 MLH-Fellowship

MLH Fellowship 推出的 Jekyll 作品集模板,通过 YAML 数据文件维护项目、经历与教育信息,并支持为每个项目撰写独立的 Markdown 详情页,适合部署在 GitHub Pages 或 Netlify 上展示个人作品。

看看你的网站会是什么样

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

3 个预览视图
桌面端首页1 / 3
桌面端截图首屏预览

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

全部页面与视图 3

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

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

值得关注的模板亮点

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

01

内容与页面分离:项目、经历、教育信息分别由 _data 目录下的三个 YAML 文件管理

02

支持为每个项目创建独立的 Markdown 详情页,并通过 projects.yml 中的 page-name 字段关联

03

README 提供项目、经历、教育三类条目的 YAML 字段示例,便于按格式填写

04

可部署到 Netlify 或 GitHub Pages,但 GitHub Pages 仅支持 username.github.io 形式

05

本地开发依赖 Ruby 与 Bundler,通过 bundle exec jekyll serve 启动预览

模板详细介绍

这是一个基于 Jekyll 的作品集网站模板,由 MLH Fellowship 维护,主要用于 Prep Fellow 展示个人项目、实习经历与教育背景。模板把内容与页面结构分离:项目、经历、教育信息分别存放在 `_data` 目录下的 `projects.yml`、`experience.yml` 和 `education.yml` 中,按 README 给出的字段示例填写即可生成列表内容。

每个项目还可以拥有独立的详情页。做法是在 `projects` 目录下新建 Markdown 文件,在文件头部声明 `title` 与 `layout: page`,然后在 `projects.yml` 对应条目里加上 `page-name` 字段指向该文件。详情页正文可以复用 GitHub README 或 Devpost 页面内容。

部署方面,README 建议使用 Netlify 或 GitHub Pages。需要注意,GitHub Pages 仅支持 `username.github.io` 这种用户主页形式,不支持 `username.github.io/repo-name` 的项目子路径形式。使用前需在 `_config.yml` 中把 `url` 改为实际托管地址,并确保地址以 `/` 结尾。

本地开发需要安装 Ruby 与 Bundler,执行 `bundle install --path vendor/bundle` 安装依赖,再用 `bundle exec jekyll serve` 启动本地预览。模板采用 MIT 许可,允许免费使用、修改、商用和分发代码,但演示图片、字体、图标等第三方素材需单独核对许可。

Jekyll作品集

适合你的项目吗?

适用场景

  • MLH Prep Fellow 按模板结构整理并展示自己的项目、实习经历与教育背景
  • 需要把 GitHub README 或 Devpost 项目页内容整理成独立详情页的个人作品集
  • 希望用 YAML 数据文件而非直接改 HTML 来维护作品集内容的开发者
  • 准备将静态作品集部署到 Netlify 或 GitHub Pages 用户主页的 Jekyll 用户

适合人群

  • 参加 MLH Fellowship 并需要按模板提交作品集的 Prep Fellow
  • 熟悉 Jekyll 与 YAML、希望用数据文件管理作品集内容的开发者
  • 计划把作品集部署到 Netlify 或 GitHub Pages 用户主页的个人用户

上手与定制指南

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

  1. 1

    使用模板按钮创建仓库后,先修改 _config.yml 中的 url 为实际托管地址,并确保以 / 结尾

  2. 2

    在 _data 目录下按 README 示例填写 projects.yml、experience.yml 和 education.yml

  3. 3

    为项目添加详情页时,在 projects 目录新建 Markdown 文件,头部声明 title 与 layout: page,并在 projects.yml 中补上 page-name 字段

  4. 4

    本地预览需安装 Ruby 与 Bundler,执行 bundle install --path vendor/bundle 和 bundle exec jekyll serve

  5. 5

    GitHub Pages 部署仅支持 username.github.io 形式,不支持 username.github.io/repo-name

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

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

使用时需要遵守

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

额外费用与待核对事项

  • 部署到 GitHub Pages 时仅支持 username.github.io 用户主页形式,不支持 username.github.io/repo-name 项目子路径形式;如需子路径托管需改用 Netlify 等其他方式。
  • 本地开发与预览需自行安装 Ruby 和 Bundler 环境,并执行 bundle install 与 bundle exec 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 原文

Make sure to have Ruby and Bundler installed.

README 原文
https://github.com/MLH-Fellowship/portfolio-template/blob/main/LICENSEhttps://github.com/MLH-Fellowship/portfolio-template/blob/main/README.md

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

项目核对记录与介绍依据

模板资料

来源平台
GitHub
资料与维护参考分
资料一般 · 72 / 100
技术栈
Jekyll
网站类型
作品集
这个分数如何计算

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

这个项目需要核对什么

记录的仓库更新时间
2023-08-14
截图检查日期
2026-10-02

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

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

查看具体选型方法 →

介绍的制作与核对状态

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

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

查看当时使用的来源资料

SHA-256: 3b2ebc2e11d5fb87447e6002671326b2312f8fec22e7b7e81eed2aab3d7bd169

2026-10-02T19:55:30.233Z

来源文件 / 仓库
# Portfolio Template

This is a Jekyll website template designed for Prep Fellows.


## 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: Online Shopping Application
  event: MLH Prep - Batch 4.5
  date: Fall 2021
```

Experience example.
```yaml
- role: MLH Prep Fellow
  company: MLH Fellowship
  dates: Summer 2021
  logo: fellowship.svg
```

Education example.
```yaml
- course: Prep Fellow
  institute: MLH Fellowship
  dates: Fall 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: Online Shopping Application
  event: MLH Prep - Batch 4.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
```
反馈内容错误

看看同类模板

对比同技术栈与用途的模板,找到更适合的视觉与内容结构。