JekyllHTML作品集博客

friday-theme — Jekyll 作品集模板

作者 sfreytag

Friday Theme 是一个基于 Jekyll 与 Bootstrap 5 的作品集与博客主题，仓库直接构建到 GitHub Pages，可同时用于个人作品展示与文章发布。

打开源站下载源码 ZIP

看看你的网站会是什么样

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

3 个预览视图

桌面端首页1 / 3

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

桌面端截图首屏预览

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

全部页面与视图 3

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

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

值得关注的模板亮点

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

基于 Jekyll 与 Bootstrap 5 构建，同时面向作品集与博客两类内容

模板统一使用 {{site.baseurl}} 生成链接，兼容 GitHub Pages 的 Jekyll 3.9/3.10 子目录部署

仓库直接构建到 GitHub Pages，提供可访问的在线演示

README 提供从 Bootstrap 4 旧版升级到 Bootstrap 5 的具体步骤

代码以 MIT 许可发布，允许使用、修改、商用与分发

作者已声明 2025 年 11 月起不再主动维护或扩展，但主题仍可运行

模板详细介绍

Friday Theme 是 sfreytag 维护的 Jekyll 主题，定位为作品集与博客两用站点。它使用 Bootstrap 5 作为前端样式基础，模板中统一通过 {{site.baseurl}} 生成链接，因此既能在 GitHub Pages 默认的 Jekyll 3.9/3.10 环境下以子目录形式发布，也能在 Jekyll 4 下从域名根目录运行。仓库自带 GitHub Pages 构建，可直接查看在线演示。

使用上有明确限制：Jekyll 4 与子目录部署不能同时成立，否则 baseurl 会在链接中重复；Jekyll 4 必须从域名根目录提供服务。主题在 2025 年 5 月升级到 Bootstrap 5，旧版本升级需要替换 SCSS 与 JS 文件、把 ml-/mr-/border-left-/border-right-/sr-only 等类改为 Bootstrap 5 对应写法、把 data-toggle 改为 data-bs-toggle，并移除 Bootstrap 5 不再支持的 Masonry/.card-columns 布局。

作者在 README 中注明，2025 年 11 月起该主题不再主动维护或扩展，但当前仍可正常工作。代码采用 MIT 许可，可免费使用、修改、商用和分发；演示中的图片、字体、图标等第三方素材需单独核对许可。

JekyllHTML作品集博客

适合你的项目吗？

适用场景

搭建个人作品集页面，集中展示项目与个人介绍
建立以文章为主的 Jekyll 博客站点
在 GitHub Pages 上以子目录形式发布站点
从域名根目录运行 Jekyll 4 站点
将已有的旧版 Friday Theme 升级到 Bootstrap 5

适合人群

使用 Jekyll 构建静态站点的开发者
需要同时展示作品与博客内容的个人
在 GitHub Pages 上托管站点的用户
希望基于 Bootstrap 5 定制前端样式的使用者

上手与定制指南

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

1
本地使用 Jekyll 4 时，克隆仓库后把 _config.yml 中的 baseurl 设为 ""
2
运行 bundle install 与 bundle exec jekyll serve 启动本地服务
3
Jekyll 4 必须从域名根目录提供服务，不能与子目录部署同时使用
4
更多安装说明见主题的 install notes 页面
5
升级旧版主题需按 README 步骤替换 Bootstrap 5 的 SCSS 与 JS，并更新相关类名与 data 属性

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

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

使用时需要遵守

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

额外费用与待核对事项

演示图片、字体、图标及其他第三方素材需按各自许可核对，不能仅凭代码的 MIT 许可判断。
域名、托管、数据库、支付或 AI 等外部服务可能另外收费。
使用 Jekyll 4.* 时不能以子目录形式部署，必须从域名根目录提供服务，否则 baseurl 会在链接中重复。
作者声明自 2025 年 11 月起不再主动维护或扩展该主题，但当前仍可正常运行。
升级到 Bootstrap 5 后必须移除 Masonry / .card-columns 布局，因为 Bootstrap 5 已不再支持该布局。

查看原文依据

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

However, this means you cannot use Jekyll 4.* and a folder - the base URL will get repeated in the links. For Jekyll 4.* you *must* serve it from the root of the domain.
README 原文

November 2025: This theme is not being actively maintained or extended. However, it still works!
README 原文

7. Remove the Masonry / `.card-columns` layout if you were using it Unfortunately Bootstrap5 no longer supports it.
README 原文

https://github.com/sfreytag/friday-theme/blob/main/LICENSE.md https://github.com/sfreytag/friday-theme/blob/main/README.md

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

项目核对记录与介绍依据

模板资料

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

这个分数如何计算

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

这个项目需要核对什么

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

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

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

查看具体选型方法 →

介绍的制作与核对状态

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

审核声明: codex-user-requested-batch-review-20261017 · 2026-10-16

查看当时使用的来源资料

SHA-256: ac4b0eff5a9cc23c2e79698e610d70ee979125a290cfd7ccecfb863afcf89e77

2026-10-08T12:16:05.005Z

来源文件 / 仓库

# Friday Theme

> [!WARNING]
> November 2025: This theme is not being actively maintained or extended. However, it still works!

## A Bootstrap 5 portfolio and blog theme for Jekyll

This repo builds directly to GitHub pages, so you can see a demo of it here: https://sfreytag.github.io/friday-theme/

## Quick Start

For Jekyll 4.* on localhost, clone this repo then edit `_config.yml` and set baseurl to `""`

Then run:

```
bundle install
bundle exec jekyll serve
```

## More Information

There's more installation information in the [install notes](https://sfreytag.github.io/friday-theme/projects/install.html).

## Usage

The theme is free to use, but if you do use it, it would be great to hear from you. Email [email protected] - thanks!

## Compatible with Jekyll 4, and also 3.10 for GitHub pages

This theme uses `{{site.baseurl}}` throughout for compatibility with GitHub Pages running Jekyll 3.9 or 3.10 where the site is served out of a folder - eg https://sfreytag.github.io/friday-theme/. The current GitHub versions are [here](https://pages.github.com/versions.json).

It also works with Jekyll 4.* and where the site is served out of the root of the domain.

However, this means you cannot use Jekyll 4.* and a folder - the base URL will get repeated in the links. For Jekyll 4.* you *must* serve it from the root of the domain.

Look at `_config.yml` and the `baseurl` setting and read the [install notes](https://sfreytag.github.io/friday-theme/projects/install.html).

## Bootstrap 5

In May 2025 this theme was upgraded to use Bootstrap 5. To upgrade your older FridayTheme to also use Bootstrap 5, look back through the commits on the main branch. In brief, you need to:

1. Add the Bootstrap 5.2.3 SCSS files
2. Update site.scss to load Boostrap 5
3. Update classes. The theme needs `ml-`, `mr-`, `border-left-` and `border-right-` to be updated to `ms-`, `me-`, `border-start-`, and `border-end-`. You might have added other classes that need updating.
4. Replace the JS with the Bootstrap 5.3 compiled JS files
5. Update the class `sr-only` to `visually-hidden`
6. Fix the components that use JS. This mostly requires attributes like `data-toggle` to become `data-bs-toggle`
7. Remove the Masonry / `.card-columns` layout if you were using it Unfortunately Bootstrap5 no longer supports it.
8. Add a rule to `_variables.scss` to remove link underlines
9. Remove the old Boostrap SCSS files

You may be able to achieve this by merging this up into your own homepage, if it has not diverged too far away from it.

反馈内容错误