Getting Started with Icarus

Getting Started with Icarus

A simple, delicate, and modern theme for the static site generator Hexo. It allows you to set up a single or multiple-column (up to three column) blog with its versatile layout configuration. Additionally, it offers plentiful plugins and pluggable widgets so that you can enable the features you want in no time. And with the all-new API designing, Icarus makes the development of this theme painless for developers and users.

Configuring Icarus

Configuring Icarus

The configuration of Icarus consists of two parts: theme configuration and post configuration.

Polymorphic Link Settings

Polymorphic Link Settings

You may already notice that Icarus allows you to put icon links on the right of the navigation bar, the bottom of the profile widget, and the right side of the footer with the following format:

Profile Sidebar Widget

Profile Sidebar Widget

Icarus offers a way to showcase yourself using the profile sidebar widget. To use this widget, add the following lines to the widgets section of your _config.yml:

_config.yml
1
2
3
4
5
6
7
8
9
10
-
type: profile
position: # show in left or right sidebar
author: # your name
author_title: # your title
location: # where are you
avatar: # path or url to your avatar image
gravatar: # your gravatar email
follow_link: # path or url to any page you want
social_links: # add links to your social network here
FAQ

FAQ

If you consider using a piece of text instead of an image as the logo of your site, you can do something like this:

_config.yml
1
2
logo:
text: My Beautiful Site

Adding a Thumbnail to Your Article

You can add thumbnail images to your posts in two steps. First, make sure the thumbnail is enabled in the theme’s configuration file:

_config.yml
1
2
article:
thumbnail: true

Then, provide an URL or path to the image file in the front-matter of your post:

post.md
1
2
3
4
title: Getting Started with Icarus
thumbnail: /gallery/thumbnails/desert.jpg
---
Post content...

About thumbnail image path

The image path you put in the front-matter needs to be the relative path to the source directory of your website. For example, if you want to use the following image as a thumbnail:

1
<your blog>/source/gallery/image.jpg

You need to use the following as the image path:

1
/gallery/image.jpg

Also, it is recommended that you put all the images under a dedicated asset folder that is separated from the _posts folder.

Your browser is out-of-date!

Update your browser to view this website correctly. Update my browser now

×