github
/
hexo-theme-icarus
mirror of https://github.com/ppoffice/hexo-theme-icarus
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
hexo-theme-icarus/source/_posts/en/Getting-Started.md

4.3 KiB
Raw Blame History

title: Getting Started with Icarus date: 2020-04-01 thumbnail: /gallery/thumbnails/vector_landscape_1.svg tags:

  • Getting Started
  • Icarus User Guide language: en

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 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.

This article is also available in 简体中文.

Before you continue to the installation of Icarus, take some time to review the Hexo documentation. To install Icarus, download the tarball from the GitHub and extract it to your Hexo blog's theme directory. Alternatively, you can use Git to clone the Icarus repository to the themes directory:

{% codeblock "Git Bash/Shell" %} git clone https://github.com/ppoffice/hexo-theme-icarus.git themes/icarus -b --depth 1 {% endcodeblock %}

You may omit -b <version number> to get the latest development version of Icarus. You may also leave --depth 1 out if you want to download full Git commit history of Icarus as well. Furthermore, you can install Icarus as a Git submodule with the following command:

{% codeblock "Git Bash/Shell" %} git submodule add https://github.com/ppoffice/hexo-theme-icarus.git themes/icarus {% endcodeblock %}

Next, activate Icarus in your blog's _config.yml file:

{% codeblock _config.yml lang:yaml %} theme: icarus {% endcodeblock %}

or use the hexo command to change the theme to Icarus:

{% codeblock "Shell" %} hexo config theme icarus {% endcodeblock %}

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

{% codeblock "Shell" %} hexo server {% endcodeblock %}

To learn more about the theme, widgets, and plugins, check out the Icarus User Guide. You can also refer to the source code of this site for more examples. It is in the site branch of the Icarus repository on GitHub. Additionally, you may find help from other Icarus users on Gitter.

Additional Resources

Here are some other resources that you may find useful to further customize your site. You can also submit your Icarus tutorial through this link.


Something wrong with this article? Click here to submit your revision.

Vector Landscape Vectors by Vecteezy