Jekyll作品集文档

folio — Jekyll 作品集模板

作者 felipejoglar

Folio 是一个基于 Jekyll 的极简模板，用于在线撰写和发布书籍，章节以 Markdown 文件形式放在 _chapters 目录中。

打开源站下载源码 ZIP

看看你的网站会是什么样

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

3 个预览视图

桌面端首页1 / 3

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

桌面端截图首屏预览

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

全部页面与视图 3

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

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

值得关注的模板亮点

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

基于 Jekyll collection 的章节式内容，_chapters/ 中的 Markdown 文件各自成为一页

侧边栏导航带目录，便于在书中定位

通过 _config.yml 的 color_theme 着色，可选 default、blue、green、sepia、violet、rose、teal、crimson 或 random

支持继续阅读，回到上次离开的位置

支持社交分享

静态站点，README 称其易于部署

模板详细介绍

Folio 是一个基于 Jekyll 的静态站点模板，定位是“干净、极简”，用于在线撰写和发布书籍。README 说明章节内容通过 Jekyll collection 管理：在 _chapters/ 目录中添加 Markdown 文件，每个文件成为书中的一页，标题、顺序和元数据通过 front matter 配置。站点提供带目录的侧边栏导航、可自定义的主题与样式、继续阅读（记录上次阅读位置）、社交分享，以及静态站点的部署方式。

配置集中在 _config.yml，可设置书名、作者、副标题、语言等选项。color_theme 可为整站着色，可选 default、blue、green、sepia、violet、rose、teal、crimson，也可设为 random 让每次页面加载随机换主题；这些主题叠加在内置的明暗切换之上。项目结构包含 _chapters/、_includes/、_layouts/、assets/、index.html 和 _config.yml。

本地运行需要 Ruby 和 Bundler，执行 bundle install 安装依赖，再用 bundle exec jekyll serve 启动，站点位于 http://localhost:4000。README 说明 _config.yml 中 baseurl 留空以便本地在根路径开发，GitHub Pages 工作流会在构建时注入正确的项目路径（如 /folio），部署细节见部署章节。README 未提供关于性能、浏览器兼容性或生产就绪程度的说明。

Jekyll作品集文档

适合你的项目吗？

适用场景

用 Markdown 撰写并在线发布一本分章节的书
为已有书稿搭建带目录和章节导航的阅读站点
通过 color_theme 与明暗切换调整整站配色
在本地用 Jekyll 预览书稿，再部署到 GitHub Pages

适合人群

希望以 Markdown 写作、用 Jekyll 发布书籍的作者
需要章节导航、目录和继续阅读功能的在线书籍项目
希望整站配色可切换（含随机主题）的静态站点使用者
使用 Ruby 与 Bundler 工具链的 Jekyll 用户

上手与定制指南

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

1
前置条件：Ruby 和 Bundler
2
运行 bundle install 安装依赖
3
运行 bundle exec jekyll serve 本地启动，站点位于 http://localhost:4000
4
_config.yml 中 baseurl 留空以支持本地根路径开发；GitHub Pages 工作流会在构建时注入项目路径，部署细节见 README 提到的部署章节
5
在 _chapters/ 目录添加 Markdown 章节文件，并通过 front matter 配置标题、顺序和元数据

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

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

使用时需要遵守

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

额外费用与待核对事项

演示图片、字体、图标及其他第三方素材需按各自许可核对，不能仅凭代码的 MIT 许可判断。
域名、托管、数据库、支付或 AI 等外部服务可能另外收费。

查看原文依据

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

https://github.com/felipejoglar/folio/blob/main/LICENSE https://github.com/felipejoglar/folio/blob/main/README.md

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

项目核对记录与介绍依据

模板资料

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

这个分数如何计算

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

这个项目需要核对什么

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

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

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

查看具体选型方法 →

介绍的制作与核对状态

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

审核声明: codex-user-requested-batch-review-20261015 · 2026-10-15

查看当时使用的来源资料

SHA-256: 544c5bcacf63bbaa2ee7c58485210e49771d6d71f9f2f7b9375726877c236756

2026-10-13T09:40:59.170Z

来源文件 / 仓库

<p align="center">
  <img src="assets/favicon.svg" alt="Folio logo" width="96" height="96">
</p>

<h1 align="center">Folio</h1>

A clean, minimal [Jekyll](https://jekyllrb.com/) template for writing and publishing books online.

📖 **[Read the documentation](https://felipejoglar.github.io/folio/)** — built with Folio itself.

<p align="center">
  <img src="assets/img/cover.png" alt="Folio book cover page" width="640">
  <br>
  <em>The Folio landing page with cover, resume bookmark, and start-reading button.</em>
</p>

## Features

- 📖 Chapter-based content using a Jekyll collection
- 🧭 Sidebar navigation with table of contents
- 🎨 Customizable theming and styling
- 🔖 Resume reading where you left off
- 🔗 Social sharing support
- ⚡ Fast, static, and easy to deploy

## Getting started

### Prerequisites

- [Ruby](https://www.ruby-lang.org/) and [Bundler](https://bundler.io/)

### Installation

```bash
bundle install
```

### Run locally

```bash
bundle exec jekyll serve
```

The site will be available at `http://localhost:4000`.

> `baseurl` is left empty in `_config.yml` so local development works at the
> root. The GitHub Pages workflow injects the correct project path (e.g.
> `/folio`) at build time, so deployment still resolves correctly — see the
> deployment chapter for details.

## Writing chapters

Add your chapters as Markdown files in the `_chapters/` directory. Each file
becomes a page in the book. Configure titles, ordering, and metadata via front
matter.

## Configuration

Edit `_config.yml` to set the book title, author, subtitle, language, and other
options.

Set `color_theme` to tint the whole site with a color theme — `default`, `blue`,
`green`, `sepia`, `violet`, `rose`, `teal`, or `crimson` — on top of the
built-in light/dark toggle. Use
`random` to pick a different theme on every page load. See the
[theming documentation](https://felipejoglar.github.io/folio/theming/) for details.

## Project structure

```
.
├── _chapters/    # Book chapters (Markdown)
├── _includes/    # Reusable HTML partials
├── _layouts/     # Page layouts
├── assets/       # CSS and JS
├── index.html    # Landing page
└── _config.yml   # Site configuration
```

## License

Released under the [MIT License](LICENSE).

反馈内容错误