Overview

Hydrogen is a lightweight and clean blogging theme that provides a fast and clutter-free reading experience. It offers a simple and sleek design for users to create and manage their blogs easily.

Features

• Lightweight: Hydrogen uses lightweight modules to render content on the screen, resulting in a fast and efficient browsing experience.
• Customizable: Users can modify various options in the _config.yml file, such as blog name, description, keywords, URL, and more, to personalize their blog.
• Theme Color: The theme allows users to customize the color of the top bar of their blog.
• MathJax Support: Hydrogen offers the option to enable MathJax for rendering math equations on the blog.
• PJAX: Users can enable PJAX for seamless loading of new content without refreshing the page.
• Friend Links: The theme provides a template to add friend links to the blog easily.
• Sticky Posts: Users can make certain posts sticky by adding the “stickie: true” option in the article’s Front Matter.
• Comments: Hydrogen supports Valine comments for engaging with readers. Users can configure the comments in the _data/social.yml file and enable them by changing the “enable” value.
• Developer-friendly: Hydrogen offers detailed documentation and encourages users to provide feedback and report any bugs they encounter.

Installation

1. Open the theme’s root directory and locate the _config.yml file.
2. Modify the following options according to your requirements:
   • title: Change your blog’s name.
   • description: Change your blog’s description.
   • keywords: Add keywords relevant to your blog for SEO purposes.
   • baseurl: Specify the folder for your blog. Leave it blank if your blog is in the root directory.
   • url: Enter your domain name (e.g., example.com) without “http://” or “https://”.
   • bulidtime: Enter the timestamp when your blog was established.
   • paginate: Set the maximum number of articles to be displayed on the homepage.
   • background: Specify the path for the homepage theme image.
   • theme_color: Set the color of the top bar of your blog.
   • MathJax: Enable or disable MathJax support (true/false).
   • author: Specify your name as the author.
   • PJAX: Enable or disable PJAX functionality (true/false).
3. Save the changes.

To add friend links:

1. Open the _data/friends.yml file.
2. Add the necessary code following the template provided in the file.
3. Save the changes.

To make a post sticky:

1. Add “stickie: true” in the Front Matter of the article.
2. Save the changes.

To enable comments:

1. Make sure you have read the Valine documentation and configured the necessary files.
2. Open the _data/social.yml file.
3. Fill in the app id, key, and other relevant information for comments.
4. In the _includes/comments.html file, ensure that the configuration is correct.
5. Change the value of “enable” in the _data/social.yml file from “false” to “true” to enable comments. Note that enabling comments may conflict with PJAX functionality, so it is recommended to disable PJAX if comments are enabled.

Summary

Hydrogen is a lightweight and customizable blogging theme that offers a fast and clutter-free reading experience. It provides several useful features, such as customizable options, MathJax support, friend links, sticky posts, and comments. The theme is developer-friendly and encourages users to provide feedback and report any issues they encounter.