Boucle is an elegant and modern theme for Jekyll, crafted with Tailwind CSS. It's designed for flexibility, easy customization, and supports tags, categories, SEO, pagination, and more. The theme also features a custom JavaScript search functionality which can filter posts by title.
To install the Boucle theme on your Jekyll site, follow these steps:
-
Download or clone this repository
$ git clone https://github.com/exaluc/boucle.git
-
Set the configs vars in your Jekyll site's
_config.yml
-
Build your site:
$ bundle exec jekyll serve
- Modern Design: Boucle is designed with a clean and modern aesthetic in mind, crafted with Tailwind CSS.
- Search Functionality: Custom JavaScript is used to allow users to search for posts by their titles.
- Support for Tags and Categories: Boucle provides built-in support for post tags and categories.
- SEO Ready: The theme has been optimized for search engines.
- Pagination: Pagination is built into the theme for ease of navigation.
After installing the theme, you can customize it to suit your needs. Boucle provides a number of configuration options that are detailed below:
Key | Example Value | Description |
---|---|---|
title |
"boucle ∞" | Your site's title. |
email |
"[email protected]" | Your email address. |
description |
"Awesome description" | The description of your site. |
baseurl |
null | The subpath of your site, e.g. /blog |
url |
"" | The base hostname & protocol for your site. |
twitter_url |
"example_site" | Your Twitter page URL. |
github_url |
"example_site" | Your GitHub page URL. |
linkedin_url |
"example_site" | Your LinkedIn page URL. |
menu_categories |
["devops", "linux", "data", "network"] | The categories you want to show in the menu. |
permalink |
'/:title/' | The permalink structure you want to use for your posts. |
author.name |
'Lucian' | The author's name. |
author.image |
'https://...' | The URL to the author's image. |
author.description |
'Open source enthusiast.' | The author's description. |
author.twitter |
'exaluc' | The author's Twitter handle. |
author.github |
'exaluc' | The author's GitHub username. |
Bug reports and pull requests are welcome on GitHub at https://github.com/exaluc/boucle. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.
The theme is available as open source under the terms of the MIT License.
Everyone interacting in the Boucle project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.
Distributed under the MIT license. See LICENSE
for more information.