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:

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.

Table of Contents / Catalogue

To display a Table of Contents / Catalogue (toc) widget on a post page, please first add toc: true to the front-matter of your post Markdown file:

post.md
1
2
3
4
title: Table of Contents Example
toc: true
---
Post content...

Then, add the toc widget to the theme’s configuration file:

_config.yml
1
2
3
4
widgets:
-
type: toc
position: left

Speed up Your Site with Custom CDN

Using a right CDN provider can speed up page loading process of your viewers. Icarus allows you to specify the CDN provider of third-party static libraries you want to use.

Built-in CDN providers

Currently, you can choose between these built-in providers:

  • General CDNs
    • CDN.js (cdnjs)
    • jsDelivr (jsdelivr)
    • Unpkg (unpkg)
  • Font CDNs
    • Google Fonts (google)
  • Icon Font CDNs
    • Font Awesome (fontawesome)

Make a Sidebar Sticky When Page Scrolls

Sometimes you may want your sidebar’s position to stay fixed when other parts of your page scrolls. This can be done via the sticky option of the sidebar in the theme’s _config.yml. You can set any of the sidebar or even both of them to sticky.

1
2
3
4
5
sidebar:
left:
sticky: false
right:
sticky: true
Your browser is out-of-date!

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

×