hexo-theme-icarus/source/_posts/Getting-Started.md

title: Getting Started with Icarus
date: 2018-10-22 19:23:59
thumbnail: /gallery/desert.jpg
tags:
- Getting Started
---
A simple, delicate, and modern theme for the static site generator Hexo. Its versatile layout configuration allows you to set up a single or multiple-column (up to three column) blog easily. Additionally, it offers plentiful [plugins](/hexo-theme-icarus/categories/Plugins/) and pluggable [widgets](/hexo-theme-icarus/categories/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.

<!-- more -->

To get started with Icarus, download and unzip the GitHub repository to your Hexo blog's theme directory or run the following command from your blog's root directory:

```bash
git clone https://github.com/ppoffice/hexo-theme-icarus.git themes/icarus
```

You can also specify a version for Icarus after downloading the theme through `git`. Replace the version code in the following command and execute:

```bash
git checkout 2.0.0
```

Furthermore, you can install Icarus as a git submodule by calling the following command:

```bash
git submodule add https://github.com/ppoffice/hexo-theme-icarus.git themes/icarus
```

Next, replace the theme setting in your blog's `_config.yml` file:

```yaml
theme: icarus
```

Finally, use the following command to start the Hexo local server and begin composing!

```yaml
hexo s
```

> Don't forget to check out the [Getting Started](/hexo-theme-icarus/tags/Getting-Started/) series to help you master the Icarus quickly! Also, you can switch the [`site` branch](https://github.com/ppoffice/hexo-theme-icarus/tree/site) in the Icarus repository if you need further examples about installation and configuration.

<a style="background-color:black;color:white;text-decoration:none;padding:4px 6px;font-size:12px;line-height:1.2;display:inline-block;border-radius:3px" href="https://unsplash.com/@yazi0413?utm_medium=referral&amp;utm_campaign=photographer-credit&amp;utm_content=creditBadge" target="_blank" rel="noopener noreferrer" title="Download free do whatever you want high-resolution photos from Chandler Chen"><span style="display:inline-block;padding:2px 3px"><svg xmlns="http://www.w3.org/2000/svg" style="height:12px;width:auto;position:relative;vertical-align:middle;top:-1px;fill:white" viewBox="0 0 32 32"><title>unsplash-logo</title><path d="M20.8 18.1c0 2.7-2.2 4.8-4.8 4.8s-4.8-2.1-4.8-4.8c0-2.7 2.2-4.8 4.8-4.8 2.7.1 4.8 2.2 4.8 4.8zm11.2-7.4v14.9c0 2.3-1.9 4.3-4.3 4.3h-23.4c-2.4 0-4.3-1.9-4.3-4.3v-15c0-2.3 1.9-4.3 4.3-4.3h3.7l.8-2.3c.4-1.1 1.7-2 2.9-2h8.6c1.2 0 2.5.9 2.9 2l.8 2.4h3.7c2.4 0 4.3 1.9 4.3 4.3zm-8.6 7.5c0-4.1-3.3-7.5-7.5-7.5-4.1 0-7.5 3.4-7.5 7.5s3.3 7.5 7.5 7.5c4.2-.1 7.5-3.4 7.5-7.5z"></path></svg></span><span style="display:inline-block;padding:2px 3px">Chandler Chen</span></a>