Jekyll博客

jekyll-theme-twail — Jekyll 博客模板

作者 leetaewook

jekyll-theme-twail 是一个采用卡片式布局的 Jekyll 博客主题，使用 jekyll-paginate-v2 实现分页，可通过 Rakefile 发布到 GitHub Pages 的 gh-pages 分支。

打开源站下载源码 ZIP

看看你的网站会是什么样

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

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

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

全部页面与视图 2

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

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

值得关注的模板亮点

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

01

卡片式布局的 Jekyll 博客主题

02

使用 jekyll-paginate-v2 实现分页

03

提供在线演示站点

04

通过 Rakefile 与 gh-pages 分支发布到 GitHub Pages

05

README 列出 minimal-mistakes、hugo-theme-stack、github-markdown-css 作为参考项目

06

采用 MIT 许可，可免费使用、修改、商用与分发

模板详细介绍

这是一个面向博客的 Jekyll 主题，整体呈现卡片式（Card style）的版式，仓库自带演示站点。主题依赖 jekyll-paginate-v2 完成分页，该插件并非 GitHub Pages 原生支持，因此作者在 README 中提供了通过 Rakefile 与 gh-pages 分支发布的替代流程。

安装流程要求本地具备 Ruby 与 Jekyll 环境：先 Fork 仓库，在 _config.yml 中设置 title、description 与 baseurl（当站点位于 https://username.github.io/SOMETHING/ 这类子路径时，baseurl 需设为 "/SOMETHING"），再修改 Rakefile 中的 GITHUB_REPONAME 为对应的 GitHub 仓库名，执行 rake publish，最后把 GitHub Pages 的来源分支切换为 gh-pages。

README 的 References 部分列出了 minimal-mistakes、hugo-theme-stack 与 github-markdown-css，说明其设计或实现参考了这些项目。仓库未在 README 中说明主题的浏览器兼容范围、可配置项清单或第三方素材的来源与许可，使用前需自行核对。

Jekyll博客

适合你的项目吗？

适用场景

  • 搭建以文章列表和卡片展示为主的个人博客
  • 需要在 GitHub Pages 上托管静态博客站点
  • 希望用 Jekyll 与 Markdown 撰写并管理文章
  • 愿意在本地配置 Ruby 与 Jekyll 环境后自行构建发布

适合人群

  • 熟悉或愿意学习 Jekyll 的博客作者
  • 使用 GitHub 仓库与 GitHub Pages 托管站点的用户
  • 偏好卡片式文章列表版式的站点
  • 接受通过 Rakefile 与 gh-pages 分支发布流程的开发者

上手与定制指南

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

  1. 1

    本地需先安装 Ruby 与 Jekyll

  2. 2

    Fork 仓库后在 _config.yml 中填写 title、description，并按站点路径设置 baseurl

  3. 3

    修改 Rakefile 中的 GITHUB_REPONAME 为你的 GitHub 仓库名

  4. 4

    执行 rake publish，并将 GitHub Pages 设置为使用 gh-pages 分支

  5. 5

    主题依赖 jekyll-paginate-v2，该插件不被 GitHub Pages 原生支持，需按上述流程发布

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

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

使用时需要遵守

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

额外费用与待核对事项

  • 主题依赖 jekyll-paginate-v2 插件，该插件不被 GitHub Pages 原生支持，因此无法直接使用 GitHub Pages 默认构建流程，需按 README 提供的 Rakefile 与 gh-pages 分支方式自行发布。
  • 使用该主题需在本地安装 Ruby 与 Jekyll 环境，属于额外的外部工具依赖，并非开箱即用。
  • 发布时需将 GitHub Pages 的来源分支手动切换为 gh-pages，涉及 GitHub 平台设置操作。
  • 演示图片、字体、图标及其他第三方素材需按各自许可核对，不能仅凭代码的 MIT 许可判断。
  • 域名、托管、数据库、支付或 AI 等外部服务可能另外收费。
查看原文依据

Permission is hereby granted, free of charge

许可证原文

This theme uses [jekyll-paginate-v2](https://github.com/sverrirs/jekyll-paginate-v2), which is not natively supported by Github Pages.

README 原文

You will need Ruby and Jekyll. [Install Ruby and Jekyll](https://jekyllrb.com/docs/installation/).

README 原文

Change your Github Pages settings to use branch `gh-pages`.

README 原文
https://github.com/leetaewook/jekyll-theme-twail/blob/master/LICENSE.txthttps://github.com/leetaewook/jekyll-theme-twail/blob/master/README.md

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

项目核对记录与介绍依据

模板资料

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

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

这个项目需要核对什么

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

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

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

查看具体选型方法 →

介绍的制作与核对状态

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

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

查看当时使用的来源资料

SHA-256: 7ebc4f8985a537f99a77c0be4941524a53be043f9970cb570d8b99328c21320a

2026-10-03T06:32:06.237Z

来源文件 / 仓库
# Jekyll theme Twail
Card style Jekyll theme for blog.

![jekyll-theme-twail](https://user-images.githubusercontent.com/72855455/149628922-61eaf762-6aba-4bbb-9ee0-f43f49bb8360.png)

<br>

## Demo
[Demo site](https://leetaewook.github.io/jekyll-theme-twail/)

<br>

## Installation
This theme uses [jekyll-paginate-v2](https://github.com/sverrirs/jekyll-paginate-v2), which is not natively supported by Github Pages.  
But don't worry. You can still easily deploy to Github Pages.

### How to Install
1. You will need Ruby and Jekyll. [Install Ruby and Jekyll](https://jekyllrb.com/docs/installation/).
2. Fork [this repo](https://github.com/leetaewook/jekyll-theme-twail).
3. Write your own posts, and make your own settings in `_config.yml`.
   ```yaml   
   title: "Jekyll theme Twail"
   description: "Card stlye Jekyll theme for blog"
   
   baseurl: # TODO: If your Github Pages URL is https://usename.github.io/SOMETHING/, baseurl should be set to "/SOMETHING"
   ```
4. Change `Rakefile`.
   ```ruby
   # TODO: Write your Github Repository name
   GITHUB_REPONAME="github-user-name/repo-name"
   ```
5. Run command `rake publish`.
6. Change your Github Pages settings to use branch `gh-pages`.

<br>

## References

- [minimal-mistakes](https://github.com/mmistakes/minimal-mistakes)
- [hugo-theme-stack](https://github.com/CaiJimmy/hugo-theme-stack)
- [github-markdown-css](https://github.com/sindresorhus/github-markdown-css)
反馈内容错误

看看同类模板

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

al-folio

al-folio

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

Jekyll · 作品集

minimal-mistakes

minimal-mistakes

:triangular_ruler: Jekyll theme for building a personal site, blog, project documentation, or portfolio.

Jekyll · 作品集

Beautiful Jekyll

Beautiful Jekyll

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

Jekyll · 博客

jekyll-TeXt-theme

jekyll-TeXt-theme

💎 🐳 A super customizable Jekyll theme for personal site, team site, blog, project, documentation, etc.

Jekyll · 博客

startbootstrap-clean-blog-jekyll

startbootstrap-clean-blog-jekyll

A Jekyll version of the Clean Blog theme by Start Bootstrap

Jekyll · 博客

So Simple

So Simple

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

Jekyll · 博客