Jekyll Theme Hydrogen

Overview

Hydrogen is a lightweight and clean theme for blogging that provides a simple and fast reading experience. It uses lightweight modules to render everything displayed on your screen. Hydrogen offers a streamlined design and quick loading times, making it ideal for those who are tired of endless loading and complex page content. This theme is available in Simplified Chinese and English languages.

Features

• Lightweight and clean design
• Fast reading experience
• Customizable options for blog name, description, keywords, and more
• Pagination for displaying a set number of articles on the homepage
• Customizable background image for the homepage
• Customizable theme color for the top bar
• Option to enable or disable MathJax for mathematical equations
• Option to enable or disable PJAX for seamless page loading

Installation

To install the Hydrogen theme, follow these steps:

1. Open the root directory of your theme.
2. Modify the _config.yml file according to your requirements:
   • Change the title to your desired blog name.
   • Change the description to your desired blog description.
   • Enter relevant keywords for SEO purposes.
   • Set the baseurl to the directory folder where your blog is located. If your blog is in the root directory, leave it blank.
   • Enter your domain name in the url field without adding “http://” or “https://”.
   • If desired, enter a build time in the bulidtime field for calculating the blog’s establishment time.
   • Set the maximum number of articles to display on the homepage in the paginate field.
   • Specify the path for the background image of the homepage in the background field.
   • Set the theme color for the top bar by entering the color code in the theme_color field (without the “#” symbol).
   • Choose whether to enable MathJax by setting the MathJax field to true or false.
   • Enter your name in the author field.
   • Choose whether to enable PJAX by setting the PJAX field to true or false.
3. If you have your own domain, modify the CNAME file in the root directory with your domain name.
4. To add friend links, open the friends.yml file in the _data directory and add the relevant code according to the provided template.
5. To make a post sticky, add stickie: true to the Front Matter of the post.
6. To enable comments, make sure you have read the Valine documentation and:
   • Configure the _data/social.yml file with your app id, key, and relevant comment information.
   • Modify the comments.html file in the _includes directory for comment settings.
   • Change the enable value in the _data/social.yml file from false to true.
   • Note that Valine compatibility may conflict with PJAX functionality, so it is recommended to disable PJAX if comments are enabled.
7. Finally, thoroughly read the documentation for any further issues or difficulties. Feel free to raise issues for assistance or bug reports.

Summary

Hydrogen is a lightweight and clean theme for blogging that offers a streamlined and fast reading experience. It provides customizable options for blog name, description, keywords, background image, theme color, and more. With built-in features such as pagination and the ability to make posts sticky, Hydrogen makes it easy to create and customize a blog. Additionally, it offers options to enable MathJax for mathematical equations and PJAX for seamless page loading. However, users are advised to carefully read the documentation for proper installation and configuration.