classic-spirits

Classic Spirits Theme for Jekyll

A classic sidebar Jekyll theme for old-school blogging, created with the Bulma framework. Built on Soot Spirits by Abhishek Nagekar.
Explore the docs »

View Demo · Report Bug · Request Feature

About The Project

Classic Spirits is a classic sidebar Jekyll theme for old-school blogging, created with the Bulma framework. Original theme Soot Spirits by Abhishek Nagekar.

As of June 23rd, 2021, with >70 posts on Classic Spirits, the website scores a perfect 100 in Performance, Accessibility, Best Practices, and SEO on an audit with Google Lighthouse.

Features

• Completely reworked CSS styles to improve website speeds.
• Two-column layout with responsive design, suitable for a wide range of blogging habits.
• Simple integration with the Jekyll Twitter plug-in.
• Modular components in the _includes folder. (01_head.html, 02_header.html, etc.)
• Auto-generated RSS feed, sitemap, accessibility features, and search-engine optimization.

Installation

Prerequisites

Jekyll requires the following:

• Ruby version 2.5.0 or higher
• RubyGems
• GCC and Make

See Requirements for guides and details.

Instructions

1. Install all prerequisites.
2. Install the jekyll and bundler gems.

gem install jekyll bundler

3. Clone this repository.

git clone https://github.com/brennanbrown/classic-spirits.git

4. Change into your new directory.

cd classic-spirits

5. Install gems from the Gemfile.

bundle install

6. Build the site and make it available on a local server.

bundle exec jekyll serve

7. Browse to http://localhost:4000

If you encounter any errors during this process, check that you have installed all the prerequisites in Requirements.

If you still have issues, see Troubleshooting.

Getting Started

Once you have Jekyll up-and-running, there are only a few steps needed to make this theme your own:

1. Fill out the _BLANK_config.yml configuration file and replace the current _config.yml
2. Remove the example_posts folder in _posts and start writing your own!
3. Modify or remove the pages in _pages to however you see fit.
4. (Optional) Modify or remove this README.md with information about your own project or blog.
5. (Optional) Modify the CSS files in the assets folder to customize the site.

Roadmap

There are several features that I'm still planning to create and integrate, including:

• Clean up and organize the structure of assets/custom.css even further.
• Create a Theme Gem
• Add easy and automatic buttons to "Deploy to Netlify", Heroku, etc.
• Add Travis continious integration checks

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the MIT License. You can use this project however you see fit without needing to give attribution.

See LICENSE for more information.

Resources

While creating this theme, I came across a lot of helpful and hard-to-find resources. If you'd like to dive deeper into Jekyll, check them out:

• Jumping Into Jekyll: https://dev.to/brennan/jumping-into-jekyll-4o9h
• Jekyll Cheatsheet: https://devhints.io/jekyll
• Course on Jekyll: https://learn-the-web.algonquindesign.ca/topics/jekyll/
• Jekyll for Designers: http://simpleprimate.com/jekyll-for-designers/index.html
• Dynamic Copyright on Jekyll: https://michaelsoolee.com/jekyll-copyright/
• Creating breadcrumbs in Jekyll: https://jekyllcodex.org/without-plugin/breadcrumbs/
• Display all items from ALL collections: https://stackoverflow.com/questions/31171041/listing-all-collections-in-jekyll

Other Resources

• For markdown previews: https://jaspervdj.be/lorem-markdownum/
• Case Study on webfont performance: https://www.keycdn.com/blog/web-font-performance
• An extensive .gitignore: https://miguelmota.com/bytes/extensive-gitignore/
• The inspriation for this project: http://motherfuckingwebsite.com/

Credit

• Bulma CSS