Oscailte

Overview

Oscailte is a light and clean theme for use on Jekyll sites, released under the MIT Licence. It is designed to be easy to install and customize, and offers features such as comments via Disqus, integration with social networks, Google Analytics support, and the ability to display post-excerpts on the home page. Oscailte also provides a guide for customizing the site’s colors and encourages collaboration with bug reports and pull requests on GitHub.

Features

• Installation: Provides instructions for installing Oscailte either as a remote theme or via a Gemfile.
• Usage: Explains how to configure Oscailte using settings nested under the ‘oscailte’ key in the site’s configuration file.
• Enabling Comments (via Disqus): Guides users on how to enable Disqus comments for each post on their Jekyll site.
• Social Networks: Allows users to add links to their accounts on other sites and display respective icons on the site.
• Enabling Google Analytics: Offers instructions for integrating Google Analytics into the Jekyll site for tracking user activity.
• Enabling Excerpts on the Home Page: Shows how to display post-excerpts on the home page of the Jekyll site.
• Customizing Oscailte Site Colors: Provides a list of CSS custom properties used for styling the theme, allowing users to customize the site’s colors.
• Contributing: Encourages collaboration and provides guidelines for contributing to the Oscailte project on GitHub.

Installation

There are two ways to install Oscailte: as a remote theme or via a Gemfile.

To install Oscailte as a remote theme, add the following code to your site’s _config.yml file:

remote_theme: coogie/oscailte

If you prefer to install Oscailte via a Gemfile, add the following line to the Gemfile:

gem 'oscailte'

Then, in your Jekyll site’s _config.yml file, add the following line:

theme: oscailte

Finally, execute the following command in your terminal to install Oscailte:

bundle install

Alternatively, you can install Oscailte manually by executing:

gem install oscailte

Summary

Oscailte is a light and clean theme for Jekyll sites, offering easy installation and customization options. With features such as comments via Disqus, social network integration, Google Analytics support, and the ability to display post-excerpts on the home page, Oscailte provides a comprehensive solution for users looking to enhance their Jekyll sites. The theme also encourages collaboration and contributions from the community, making it a versatile and community-driven option for Jekyll users.