This article covers widgets supported by Icarus 5. To display multiple widgets at once, simply add individual widget configuration to the widgets array. They will appear in the order of their definitions. The type and position settings are required for every widget. Here is an example:

1
2
3
4
5
6
7
8
9

widgets:
    -
        type: ... 
        position: left
        ...
    -
        type: ... 
        position: right
        ...

Profile

You can showcase the post author/site admin information via the profile widget. Its configuration is listed below:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

widgets:
    -
        position: right
        type: profile
        
        author: hulatocat
        
        author_title: A GitHub Octocat
        
        location: GitHub Inc.
        
        avatar: https://octodex.github.com/images/hula_loop_octodex03.gif
        
        avatar_rounded: false
        
        gravatar:
        
        follow_link: 'https://octodex.github.com/hulatocat'
        
        social_links:
            Github:
                icon: fab fa-github
                url: 'https://github.com/'
            Icarus: 'https://github.com/ppoffice/hexo-theme-icarus'

Some notes on the configuration:

• If you wish to use Gravatar instead of avatar as your profile picture, fill in the Gravatar email address in the gravatar setting and leave avatar empty;

• There two acceptable formats for social_links:

  Icon:

  1 2 3

  <link_name>: icon: <fontawesome_icon_class_name> url: <link_url>

  Text:

  1	<link_name>: <link_url>

Table of Contents

To show the table of contents of the current post, add the following widget configuration to your theme configurations:

1
2
3
4
5
6

widgets:
    -
        type: toc
        position: left
        
        index: true

Then, add toc: true to the front-matter of your post:

1
2
3
4

title: A post with the table of contents
toc: true
---
Post content...

External Links

You can display a list of external sites with the external links widget. An example configuration is listed below:

1
2
3
4
5
6
7
8

widgets:
    -
        position: left
        type: links
        
        links:
            Hexo: 'https://hexo.io'
            Bulma: 'https://bulma.io'

Recent Posts

Use the following configuration to enable the recent posts widget:

1
2
3
4

widgets:
    -
        position: right
        type: recent_posts

Archives

Use the following configuration to enable the archives widget:

1
2
3
4

widgets:
    -
        position: right
        type: archives

Categories

Use the following configuration to enable the categories widget:

1
2
3
4

widgets:
    -
        position: right
        type: categories

Use the following configuration to enable the tags widget:

1
2
3
4
5
6
7

widgets:
    -
        position: right
        type: tags
        order_by: name      
        amount: 20          
        show_count: true    

Google Feedburner

To enable Google Feedburner email subscription widget, take the following steps:

1. First, you need to generate the RSS feed of your Hexo site using a Hexo plugin like hexo-generator-feed.

2. Then, go to Google Feedburner, log into your Google account, and add your RSS feed by typing in the RSS feed address to the input box and click “Next”.

   
   

3. Next, fill in the “Feed Title” on the next page. Click “Next” to continue customizing your feed or click “Skip directly to feed management” to finish.

   
   

4. When finished adding the feed, click the “My Feeds” link on the top of the page. Click your newly added feed on the “My Feeds” page.

   
   

5. Switch to the “Publicize” tab and click the “Email Subscription” link on the left side of the page. Enable “Email Subscription” by clicking the “Activate” button.

   
   

6. Find the following information in the HTML code on the “Email Subscription” page:

   1	https://feedburner.google.com/fb/a/mailverify?uri=******

   

   Copy the ID after uri= (e.g., feedforall/ABCD) to the feedburner_id setting of the widget configuration:

   1 2 3 4 5 6 7

   widgets: - position: left type: subscribe_email description: Subscribe to get the lastest update! feedburner_id: feedforall/ABCD

Google AdSense

Create a new AD on Google AdSense. Then, copy the values of data-ad-client and data-ad-slot from the AD HTML code to the client_id and slot_id setting of the widget configuration, respectively. Here is an example:

1
2
3
4
5
6

widgets:
    -
        position: left
        type: adsense
        client_id: ca-pub-xxxxxxxx
        slot_id: xxxxxxx

follow.it

To enable follow.it email subscription widget, take the following steps:

1. First, you need to generate the RSS feed of your Hexo site using a Hexo plugin like hexo-generator-feed.

2. Go to follow.it and enter the URL to your RSS feed file in the text input under “Add the follow feature to your site”, e.g., http://example.com/atom.xml. Then, click “Next”.

   
   

3. Click the “Continue” button on the “Define the follow form’s design” page.

   
   

4. Search for action= and copy the link between double quotes after action=. Paste the action link you copied to the action_url setting of the widget configuration. After that, click “Done”.

   
   

   1 2 3 4 5 6 7

   widgets: - position: left type: followit description: action_url: https://api.follow.it/****** verification_code: ''

5. Click the “Continue” button or the “Skip this” link to skip the “Pick the Follow icons you want” page and “Show a pop-up for maximum conversion” page.

6. At the “Connect your feed to a follow.it account” page, enter your email address that you will use to create a follow.it account and manage followers in the text input. Then, click “Start”.

   
   

7. You will then receive an email from follow.it. In that email, search for <meta name="follow_it-verification-code" content="******"/> and copy the content value between double quotes after content=. Paste the content value you copied to the verification_code setting of the widget configuration.

   
   

   1 2 3 4 5 6 7

   widgets: - position: left type: followit description: action_url: https://api.follow.it/****** verification_code: ******

8. Generate and push your site to your server.

9. Go back to follow.it and register an account using your email.

10. Go back to the first email you receive and click on the “Click here to claim it” link to claim your feed.