--depth 1
-{% endcodeblock %}
+
+
+ Download the source code tarball from the GitHub and extract it to your Hexo site's theme
+ directory.
+ Alternatively, you can use Git to clone the Icarus repository to the `themes` directory:
-You can omit `-b ` to get the latest development version of Icarus.
-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 clone https://github.com/ppoffice/hexo-theme-icarus.git themes/icarus -b --depth 1
+ {% endcodeblock %}
-{% codeblock "Git Bash/Shell" %}
-git submodule add https://github.com/ppoffice/hexo-theme-icarus.git themes/icarus
-{% endcodeblock %}
+ You can omit `-b ` to get the latest development version of Icarus.
+ 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 %}
+
+
+
+ New in Hexo 5.0 and Icarus 4.0
+
+ To install Icarus as a node package via NPM, run the following command
+ from the root of your Hexo site:
+
+ {% codeblock "Git Bash/Shell" %}
+ npm install -S hexo-theme-icarus
+ {% endcodeblock %}
+
+
+
Next, activate Icarus in your site's `_config.yml` file:
diff --git a/source/_posts/zh-CN/Configuring-Theme.md b/source/_posts/zh-CN/Configuring-Theme.md
index 7c1eb8f..9ade3be 100644
--- a/source/_posts/zh-CN/Configuring-Theme.md
+++ b/source/_posts/zh-CN/Configuring-Theme.md
@@ -256,28 +256,30 @@ article:
{% endcodeblock %}
```
-### 缩略图
+### 封面 & 缩略图
-你可以通过两步来为你的文章添加缩略图:
+若要为文章添加封面图,请在文章的front-matter中添加`cover`选项:
-1. 确保主题配置中缩略图功能已启用:
+{% codeblock post.md lang:yaml %}
+title: Icarus快速上手
+cover: /gallery/covers/cover.jpg
+---
+Post content...
+{% endcodeblock %}
- {% codeblock themes/icarus/_config.yml lang:yaml %}
- article:
- thumbnail: true
- {% endcodeblock %}
+类似地,你也可以在文章的front-matter中为文章设置缩略图:
-2. 在你的文章的front-matter中提供缩略图的路径或URL地址:
+{% codeblock post.md lang:yaml %}
+title: Icarus快速上手
+thumbnail: /gallery/thumbnails/thumbnail.jpg
+---
+Post content...
+{% endcodeblock %}
- {% codeblock post.md lang:yaml %}
- title: Icarus快速上手
- thumbnail: /gallery/thumbnails/desert.jpg
- ---
- 文章内容...
- {% endcodeblock %}
+文章的缩略图会显示在归档页面和最新文章挂件中。
- 如果你在front-matter中使用的是图片的路径,你需要确保它是绝对或者相对于你的source目录的路径。
- 例如,为使用`/source/gallery/image.jpg`作为缩略图,你需要在front-matter中使用`/gallery/image.jpg`作为图片路径。
+如果你在front-matter中使用的是图片的路径,你需要确保它是绝对或者相对于你的source目录的路径。
+例如,为使用`/source/gallery/image.jpg`作为缩略图,你需要在front-matter中使用`/gallery/image.jpg`作为图片路径。
### 文章阅读时间
diff --git a/source/_posts/zh-CN/FAQ.md b/source/_posts/zh-CN/FAQ.md
index 3f09194..b0de67a 100644
--- a/source/_posts/zh-CN/FAQ.md
+++ b/source/_posts/zh-CN/FAQ.md
@@ -1,6 +1,8 @@
title: 常见问题
date: 2016-01-03
language: zh-CN
+tags:
+- Icarus用户指南
toc: true
providers:
cdn: loli
diff --git a/source/_posts/zh-CN/Getting-Started.md b/source/_posts/zh-CN/Getting-Started.md
index 1ee0f79..e4175d5 100644
--- a/source/_posts/zh-CN/Getting-Started.md
+++ b/source/_posts/zh-CN/Getting-Started.md
@@ -1,6 +1,5 @@
title: Icarus快速上手
date: 2016-01-04
-thumbnail: /gallery/thumbnails/chinese-painting.jpg
tags:
- Getting Started
- Icarus用户指南
@@ -9,6 +8,8 @@ providers:
cdn: loli
fontcdn: loli
iconcdn: loli
+cover: /gallery/covers/chinese-painting.jpg
+thumbnail: /gallery/covers/chinese-painting.jpg
---
欢迎使用Icarus!
@@ -28,20 +29,52 @@ Icarus同时也提供了超多插件与挂件来满足你的多元的站点个
在你继续安装Icarus之前,请先花些时间阅览[Hexo文档](https://hexo.io)。
-如要安装Icarus,从GitHub的仓库中下载源码的压缩包并解压到你Hexo站点的主题目录中。
-或者,你可以使用Git来克隆Icarus的代码仓库到`themes`目录下:
+如要安装Icarus,你可以选择如下两种方式中的任意一种:
-{% codeblock "Git Bash命令行" %}
-git clone https://github.com/ppoffice/hexo-theme-icarus.git themes/icarus -b --depth 1
-{% endcodeblock %}
+
+
+ 从GitHub的仓库中下载源码的压缩包并解压到你Hexo站点的主题目录中。
+ 或者,你可以使用Git来克隆Icarus的代码仓库到`themes`目录下:
-你可以省略`-b `来获取Icarus的最新开发版本。
-如果你想同时下载Git仓库的完整提交历史,请同时省略`--depth 1`。
-另外,你也可以使用下面的命令将Icarus安装为Git子模块(submodule):
+ {% codeblock "Git Bash命令行" %}
+ git clone https://github.com/ppoffice/hexo-theme-icarus.git themes/icarus -b --depth 1
+ {% endcodeblock %}
-{% codeblock "Git Bash命令行" %}
-git submodule add https://github.com/ppoffice/hexo-theme-icarus.git themes/icarus
-{% endcodeblock %}
+ 你可以省略`-b `来获取Icarus的最新开发版本。
+ 如果你想同时下载Git仓库的完整提交历史,请同时省略`--depth 1`。
+ 另外,你也可以使用下面的命令将Icarus安装为Git子模块(submodule):
+
+ {% codeblock "Git Bash命令行" %}
+ git submodule add https://github.com/ppoffice/hexo-theme-icarus.git themes/icarus
+ {% endcodeblock %}
+
+
+
+ Hexo 5.0和Icarus 4.0新增功能
+
+ 若要使用NPM将Icarus安装为Node包,在你的Hexo站点根目录运行如下命令:
+
+ {% codeblock "Git Bash/Shell" %}
+ npm install -S hexo-theme-icarus
+ {% endcodeblock %}
+
+
+
接下来,在你的站点的`_config.yml`文件中的开启Icarus:
diff --git a/source/about/index.md b/source/about/index.md
index fa7e7cd..c38a386 100644
--- a/source/about/index.md
+++ b/source/about/index.md
@@ -14,15 +14,25 @@ toc: true
### :cd: Installation
-Download & extract or `git clone` Icarus from GitHub to your blog's theme folder, and that's it!
+**Method 1: Direct download**
+
+Download & extract or `git clone` Icarus from GitHub to your blog's theme folder:
```shell
-$ git clone https://github.com/ppoffice/hexo-theme-icarus.git themes/icarus
-$ hexo s // start a live server
+$ git clone https://github.com/ppoffice/hexo-theme-icarus.git -b themes/icarus
```
-Once started, Icarus will remind you of any missing dependencies to install.
-And it will create a theme configuration file (`_config.yml`) if it is not there.
+**Method 2: Install via NPM (new in Hexo 5.0 and Icarus 4.0)**
+
+```shell
+$ npm install hexo-theme-icarus
+```
+
+Then, activate Icarus in Hexo's configuration file:
+
+```shell
+$ hexo config theme icarus
+```
### :gift: Features
diff --git a/source/gallery/thumbnails/CP77-KV-en.jpg b/source/gallery/covers/CP77-KV-en.jpg
similarity index 100%
rename from source/gallery/thumbnails/CP77-KV-en.jpg
rename to source/gallery/covers/CP77-KV-en.jpg
diff --git a/source/gallery/thumbnails/chinese-painting.jpg b/source/gallery/covers/chinese-painting.jpg
similarity index 100%
rename from source/gallery/thumbnails/chinese-painting.jpg
rename to source/gallery/covers/chinese-painting.jpg
diff --git a/source/gallery/thumbnails/vector_landscape_1.svg b/source/gallery/covers/vector_landscape_1.svg
similarity index 100%
rename from source/gallery/thumbnails/vector_landscape_1.svg
rename to source/gallery/covers/vector_landscape_1.svg
diff --git a/source/gallery/thumbnails/vector_landscape_2.svg b/source/gallery/covers/vector_landscape_2.svg
similarity index 100%
rename from source/gallery/thumbnails/vector_landscape_2.svg
rename to source/gallery/covers/vector_landscape_2.svg
diff --git a/source/gallery/thumbnails/vector_landscape_3.svg b/source/gallery/covers/vector_landscape_3.svg
similarity index 100%
rename from source/gallery/thumbnails/vector_landscape_3.svg
rename to source/gallery/covers/vector_landscape_3.svg