Awesome Jekyll Theme

A clean, versatile Jekyll theme with minimalist design and robust features. Ideal for portfolios, blogs, and project showcases with responsive layouts and easy customization.

ScreenShots

Home Layout

main page of theme

Blog Layout

blog page of theme

Projects Layout

projects page of theme

Features

  1. Clean and minimalist design with ample white space, focusing on content readability and visual appeal.

  2. Versatile layout options including a grid-style projects page, a blog listing with featured posts, and a simple yet elegant home page with a circular profile image.

  3. Consistent navigation with a header menu and social media integration in the footer, providing a cohesive user experience across different page types.

  4. Responsive design that appears to adapt well to different screen sizes, ensuring a good viewing experience on various devices.

  5. Category-based organization for blog posts, allowing for easy content discovery and improved site structure.

Installation

Add this line to your Jekyll site's Gemfile:

gem "awesome-jekyll-theme"

And add this line to your Jekyll site's _config.yml:

theme: awesome-jekyll-theme

And then execute:

bundle

Or install it yourself as:

gem install awesome-jekyll-theme

Usage

This theme provides several layouts for different types of pages. Each layout has specific front matter variables to customize the content and appearance.

  • Home Layout: Main landing page layout. Displays a profile image, main content area, and reference to blog and project section.

  • Projects Layout: Used to list a collection of projects. Requires collection configuration in your _config.yml.

  • Blog Layout: Builds a blog page with posts. Displays posts sorted by date with optional category filtering.

  • Post Layout: Used for individual blog posts. Supports various metadata like categories, excerpts, and author information.

  • Project Layout: Designed for individual project pages. Includes project image, description, and tags.

I will be describing each layout on a near future, if you have a question just ask.

Configuration

The navbar filters pages to be displayed based on a front matter called nav. These pages will appear in the navbar listed by the front matter title. If there is no title, then the filename is used. So, if you want to add a page to the navbar, don't forget to add nav: true.

Similarly, the same applies to footer pages. For example, if you add a privacy-policy.markdown page, you may want to add it to the footer but not to the navbar. The front matter will look like this:

---
nav: false
footer: true
....
---

Posts and Projects not count like pages.

Contact Channels

Contact channels are displayed in the home layout and the footer. To configure this, please add each one to your _config.yml file like this:

rrss:
  email: "[email protected]"
  github: "https://github.com/a-chacon"
  telegram: "https://t.me/a_chacon"
  stackoverflow: "https://stackoverflow.com/users/16847024/andr%c3%a9s"
  discord: "https://discord.com/users/673943171369140252"
  mastodon: "https://lile.cl/@achacon"

If you need to add a new one, just ask or send a PR

Plugins

The Awesome Jekyll theme comes with the jekyll-seo-tag plugin preinstalled to ensure your website gets the most useful meta tags. See usage to learn how to set it up.

It also includes jekyll-archives to generate category web pages.

This theme is built with multi-language support by default, based on the excellent gem jekyll-polyglot. It is also included as a plugin. The default site language is English, but if you want to use this in Spanish, simply set this in your config file: default_lang: es. And if you want to set a different language other than English or Spanish, please create a file in _data/[your lang]/strings.yml, using an existing file as template.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/a-chacon/awesome-jekyll-theme. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

Development

To set up your environment to develop this theme, run bundle install.

Your theme is setup just like a normal Jekyll site! To test your theme, run bundle exec jekyll serve and open your browser at http://localhost:4000. This starts a Jekyll server using your theme. Add pages, documents, data, etc. like normal to test your theme's contents. As you make modifications to your theme and to your content, your site will regenerate and you should see the changes in the browser after a refresh, just like normal.

When your theme is released, only the files in _layouts, _includes, _sass and assets tracked with Git will be bundled. To add a custom directory to your theme-gem, please edit the regexp in awesome-jekyll-theme.gemspec accordingly.

License

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