Welcome to the Icarus documentation site! Icarus is a simple, delicate, and modern theme for the static site generator Hexo. It strives to be elegant in design while simple and straightforward to use. Its versatile and flexible configuration system enables power users to lay out their sites to the finest details. Icarus also offers a wide range of plugins and widgets to meet your various customization and optimization needs. Moreover, its refreshed implementation enables better IDE support and third-party integration, which open to a sea of improvement possibilities.

Icarus’ default theme configuration file is _config.icarus.yml, in the root directory of your site, next to the site configuration file _config.yml. It defines the global layout and style settings of the theme and controls external features such as plugins and widgets. This article details the general configurations of the theme. It also explains what configuration files are used and how Icarus generates and validates these configurations.

The article answers some frequently asked questions about Icarus. If your question is not answered here, you can also refer to Icarus User Guide, Hexo documentation, and GitHub Issues. Additionally, you may find help from other Icarus users on GitHub Discussions.

Choosing the right CDN providers can significantly reduce the page loading time of your viewers. Icarus lets you pick among several built-in CDN provider options for serving third-party libraries and asset files used by Icarus.

This article covers donation button configurations supported by Icarus. If you need to display multiple donation buttons at once, add individual button configuration to the donates array like the following:

1
2
3
4
5
6
7

donates:
    -
        type: ... # Button 1
        ...
    -
        type: ... # Button 2
        ...

Each button has required settings, such as url, qrcode, or business and currency_code. If one of them is missing or empty, a red notice asking you to set it is shown in place of the button.

This article covers other plugins supported by Icarus.

This article covers comment plugins supported by Icarus.

This article covers search plugin configurations supported by Icarus.

This article covers share buttons supported by Icarus.