Card-style Jekyll blog theme
JekyllBlog
jekyll-theme-twail — Jekyll Blog Template
By leetaewook
jekyll-theme-twail is a card-style Jekyll blog theme that uses jekyll-paginate-v2 for pagination and can be published to the gh-pages branch of GitHub Pages via a Rakefile.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Desktop homepage1 / 2
Desktop captureTop of page
Actual screenshot captured by the server browser.
All pages & views 2
Screenshots show visual appearance; interactive behavior may differ.
Recorded 2026-10-03View source
What stands out
A quick read of the recorded project description.
Uses jekyll-paginate-v2 for pagination
Provides an online demo site
Publishes to GitHub Pages via a Rakefile and the gh-pages branch
README lists minimal-mistakes, hugo-theme-stack, and github-markdown-css as reference projects
Licensed under MIT, free to use, modify, commercialize, and distribute
Template Details
This is a Jekyll theme for blogs, presenting an overall card-style layout, and the repository includes a demo site. The theme relies on jekyll-paginate-v2 for pagination; this plugin is not natively supported by GitHub Pages, so the author provides an alternative publishing workflow via a Rakefile and the gh-pages branch in the README.
The installation process requires a local Ruby and Jekyll environment: first fork the repository, set title, description, and baseurl in _config.yml (when the site is located at a subpath such as https://username.github.io/SOMETHING/, baseurl must be set to "/SOMETHING"), then change GITHUB_REPONAME in the Rakefile to the corresponding GitHub repository name, run rake publish, and finally switch the GitHub Pages source branch to gh-pages.
The References section of the README lists minimal-mistakes, hugo-theme-stack, and github-markdown-css, indicating that its design or implementation references these projects. The repository does not state in the README the theme's browser compatibility range, list of configurable options, or the sources and licenses of third-party assets, so users must verify these themselves before use.
JekyllBlog
Is it right for your project?
Use Cases
- Building a personal blog focused on article lists and card displays
- Needing to host a static blog site on GitHub Pages
- Wanting to write and manage articles with Jekyll and Markdown
- Willing to set up a local Ruby and Jekyll environment and build and publish it yourself
Suitable For
- Blog authors familiar with or willing to learn Jekyll
- Users hosting sites with GitHub repositories and GitHub Pages
- Sites that prefer a card-style article list layout
- Developers who accept the publishing workflow via a Rakefile and the gh-pages branch
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
Ruby and Jekyll must be installed locally first
- 2
After forking the repository, fill in title and description in _config.yml, and set baseurl according to the site path
- 3
Change GITHUB_REPONAME in the Rakefile to your GitHub repository name
- 4
Run rake publish, and set GitHub Pages to use the gh-pages branch
- 5
The theme depends on jekyll-paginate-v2, which is not natively supported by GitHub Pages, so it must be published using the above workflow
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version under the MIT license in the public repository; the free scope is the code of this version and does not mean that external services or third-party assets are free.
Must comply with when using
- Free use, modification, commercialization, and distribution of this version's code are permitted.
- When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
- The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.
Additional costs & items to verify
- The theme depends on the jekyll-paginate-v2 plugin, which is not natively supported by GitHub Pages, so the default GitHub Pages build process cannot be used directly; it must be published using the Rakefile and gh-pages branch method provided in the README.
- Using this theme requires installing Ruby and Jekyll locally, which is an additional external tool dependency and not ready to use out of the box.
- When publishing, the GitHub Pages source branch must be manually switched to gh-pages, involving GitHub platform settings.
- Demo images, fonts, icons, and other third-party assets must be checked against their respective licenses and cannot be judged solely by the code's MIT license.
- External services such as domains, hosting, databases, payments, or AI may incur additional charges.
View Original Text Basis
Permission is hereby granted, free of charge
Original License Text
This theme uses [jekyll-paginate-v2](https://github.com/sverrirs/jekyll-paginate-v2), which is not natively supported by Github Pages.
Original README
You will need Ruby and Jekyll. [Install Ruby and Jekyll](https://jekyllrb.com/docs/installation/).
Original README
https://github.com/leetaewook/jekyll-theme-twail/blob/master/LICENSE.txthttps://github.com/leetaewook/jekyll-theme-twail/blob/master/README.mdChange your Github Pages settings to use branch `gh-pages`.
Original README
Compiled by DeepSeek based on repository license and README ·2026-10-03. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.
Project checks & description sources
Template Information
- Source platforms
- GitHub
- Documentation and maintenance reference score
- Partly documented · 65 / 100
- Technologies
- Jekyll
- Website type
- Blog
How this score is calculated
Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.
What to verify for this project
- Repository update recorded
- 2022-01-15
- Screenshot last checked
- 2026-10-03
A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.
The catalog identifies Jekyll as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.
Use a selection guide →How this description was prepared
AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.
Automatically checked against source and license rules; no manual editorial review.
Inspect the recorded source material
SHA-256: 7ebc4f8985a537f99a77c0be4941524a53be043f9970cb570d8b99328c21320a
2026-10-03T06:32:06.237Z
Source file / repository# Jekyll theme Twail Card style Jekyll theme for blog.  <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)
Explore similar templates
Compare previews and descriptions within the same stack and category.
al-folio
A Jekyll academic homepage theme for scholars and researchers, with a clean responsive design and out-of-the-box support for publication lists, project showcases, CVs, and blogs.
Jekyll · Portfolio
minimal-mistakes
Minimal Mistakes is a two-column Jekyll theme for personal sites, blogs, project documentation, or portfolios.
Jekyll · Portfolio
Beautiful Jekyll
Beautiful Jekyll is a mature, easy-to-use Jekyll blog theme maintained by Dean Attali since 2015, with over 50,000 users.
Jekyll · Blog
jekyll-TeXt-theme
A customizable Jekyll theme for personal sites, team sites, blogs, projects, and documentation.
Jekyll · Blog
startbootstrap-clean-blog-jekyll
The official Jekyll version of Start Bootstrap's Clean Blog theme, offering a blog home page, about page, contact page, and sample post pages, with a Formspree-powered contact form.
Jekyll · Blog
So Simple
A minimal reading-oriented Jekyll theme by Michael Rose for personal blogs, portfolios, and long-form reading. It offers multiple layouts, microformat markup, Disqus comments, Google Analytics, Jekyll SEO Tag, three skins, and aggregation by year, category, and tag with a grid view.
Jekyll · Blog