Hydeout

Overview:

Hydeout is an updated version of the original Hyde theme for Jekyll 3.x and 4.x. It adds new functionality and aims to keep the overall design lightweight and plugin-free. Hydeout utilizes Flexbox in its CSS and provides customization options through SASS variables. It also introduces new features such as tags and category pages, with automatic sidebar inclusion for category pages.

Features:

• Lightweight Design: Hydeout aims to keep the overall design lightweight and plugin-free.
• Flexbox CSS: Hydeout makes heavy use of Flexbox in its CSS, providing a responsive layout.
• SASS Customization: Hydeout allows customization through the use of SASS variables, allowing users to create their own assets/css/main.scss file and override default variables.
• Tags Page: Hydeout introduces a new tags page, which can be accessed through the sidebar by creating a new page with the tags layout.
• Category Pages: Hydeout offers a new “category” layout for dedicated category pages. Category pages are automatically added to the sidebar, while other pages need to specify sidebar_link: true in their front matter to appear in the sidebar.
• Pagination: Hydeout uses pagination, requiring users to swap the index.md file with an index.html file that utilizes the index layout. The number of posts to include per page can be specified in the _config.yml file.
• Customization Options: Hydeout provides various customizable partials in the _includes folder, allowing users to customize elements such as copyright, custom head tags, custom foot elements, additional nav links, and custom icon links.

Installation:

To install Hydeout, follow these steps:

1. Add the Hydeout Ruby Gem to your Gemfile by including gem "jekyll-theme-hydeout", "~> 4.1" and run bundle install.
2. If installing on Github Pages, add remote_theme: fongandrew/hydeout to your _config.yml file. Refer to the Github instructions for more details.
3. If you have an index.md file, swap it with an index.html file that uses the index layout.
4. In the _config.yml file, specify the number of posts to include per page by adding paginate: 5.

For customization, override the SASS variables by creating your own assets/css/main.scss file and importing Hydeout’s SCSS. Additional customization options can be found in the _variables file and various partials in the _includes folder.

Summary:

Hydeout is an updated version of the Hyde theme for Jekyll, providing new functionality and customization options. It aims to maintain a lightweight and plugin-free design, utilizing Flexbox for responsive layouts. Hydeout offers features such as tags and category pages, as well as customization through SASS variables and partials. Installation is done through adding the Hydeout Ruby Gem and configuring the necessary files.