Skip to content

ioluc/boucle

Repository files navigation

Boucle

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.

Installation

To install the Boucle theme on your Jekyll site, follow these steps:

  1. Download or clone this repository

    $ git clone https://github.com/exaluc/boucle.git
    
  2. Set the configs vars in your Jekyll site's _config.yml

  3. Build your site:

    $ bundle exec jekyll serve

Features

  • 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.

Usage

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 "your-email@example.com" 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.

Contributing

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.

License

The theme is available as open source under the terms of the MIT License.

Code of Conduct

Everyone interacting in the Boucle project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.

Author

Distributed under the MIT license. See LICENSE for more information.

Boucle