原创

Icarus是静态网站生成器Hexo中一个主题，这里记录了Icarus主题的一些使用及遇到的问题！

索引

• 索引
• ## icarus安装
• ## icarus配置文件
• ## icarus常见问题
  • 依赖问题
  • highlight使用暗色主题的问题
  • 更多常见问题

Icarus的Github仓库
Icarus的Dome网址

---

icarus安装

---

首先通过Git Bash命令行，进入Hexo的博客文件夹，准备开始安装！
Icarus官方的安装指南

1. 安装克隆

   通过Git Bash命令行 安装克隆主题文件

   Git Bash/命令行

   $ git clone https://github.com/ppoffice/hexo-theme-icarus.git themes/icarus --depth 1

   也可以通过npm方式安装，但主题文件会下载到node_modules文件夹内，而不会下载到theme文件夹。所以不建议使用这种方式。

   Git Bash/命令行

   $ npm install -S hexo-theme-icarus

2. 配置

   修改 _config.yml 配置文件

   _config.yml

   language: zh-CN
   theme: icarus

   也可以使用命令行 修改 _config.yml 配置文件 但不建议使用 因为hexo会自动清除配置文件的备注

   Git Bash/命令行

   $ hexo config theme icarus

3. 清除缓存

   配置好后 运行清除缓存命令。后面加-debug查看清除日志。
   安装好后目录下是没有`_config.icarus.yml`配置文件的。当执行`hexo clean`命令后会自动生成。
   如果有报错，按提示，安装相关依赖。参考 《icarus常见问题 - 依赖问题》

   Git Bash/命令行

   $ hexo clean -debug

4. 运行

   最后，使用如下命令运行hexo。

   Git Bash/命令行

   $ hexo serve

---

icarus配置文件

---

本章介绍如何使用_config.icarus.yml来配置主题。这里不会介绍全部指南，只会介绍需要特殊配置的地方。如果需要更多的指南可以参考 官方的主题配置指南。

1. _config.icarus.yml

   在Hexo创建的博客文件夹内找到_config.icarus.yml文件。

---

icarus常见问题

---

依赖问题

• 运行hexo clean出现以下错误

  Git Bash/命令行

  INFO  =======================================
   ██╗ ██████╗ █████╗ ██████╗ ██╗   ██╗███████╗
   ██║██╔════╝██╔══██╗██╔══██╗██║   ██║██╔════╝
   ██║██║     ███████║██████╔╝██║   ██║███████╗
   ██║██║     ██╔══██║██╔══██╗██║   ██║╚════██║
   ██║╚██████╗██║  ██║██║  ██║╚██████╔╝███████║
   ╚═╝ ╚═════╝╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝ ╚══════╝
  =============================================
  INFO  === Checking package dependencies ===
  ERROR Package bulma-stylus is not installed.
  ERROR Package hexo-pagination's version (1.0.0) does not satisfy the required version (^2.0.0).
  ERROR Package hexo-renderer-inferno is not installed.
  ERROR Package hexo-component-inferno is not installed.
  ERROR Package inferno is not installed.
  ERROR Package inferno-create-element is not installed.
  ERROR Please install the missing dependencies your Hexo site root directory:
  ERROR npm install --save bulma-stylus@0.8.0 hexo-pagination@^2.0.0 hexo-renderer-inferno@^0.1.3 hexo-component-inferno@^1.0.2 inferno@^7.3.3 inferno-create-element@^7.3.3
  ERROR or:
  ERROR yarn add bulma-stylus@0.8.0 hexo-pagination@^2.0.0 hexo-renderer-inferno@^0.1.3 hexo-component-inferno@^1.0.2 inferno@^7.3.3 inferno-create-element@^7.3.3

  这个问题是缺少相关的依赖插件，按给出的提示安装相关插件，就可以解决

  Git Bash/命令行

  npm install --save bulma-stylus@0.8.0 hexo-pagination@^2.0.0 hexo-renderer-inferno@^0.1.3 hexo-component-inferno@^1.0.2 inferno@^7.3.3 inferno-create-element@^7.3.3

  出现上面的问题，通常是使用克隆的方式(git clone https://xx...)安装的icarus。
  如果使用的是命令行npm方式安装的(npm install -S hexo-theme-icarus)，
  不会出现上面的错误！但在浏览器里还是无法渲染
  
  在hexo clean --debug清除日志里可以看到hexo-renderer-inferno是没有被加载的！
  也就是说在npm方式安装的icarus，在运行时不会报缺少的插件。显示运行成功
  但其实问题一直存在，因为缺少所依赖的插件。
  我的建议，通过克隆方式安装。将icarus克隆的theme文件夹内!
  还有就是npm方式安装，会把icarus安装在node_modules文件夹内。这个有点别扭！
  此问题的解决得益于icarus的作者的回帖 帖子链接 还有另一位网友文章：链接

highlight使用暗色主题的问题

• 条件
  _config.yml中开启highlight,hljs=false
_config.icarus.yml中的highlight主题使用暗色
• 问题
  部分代码出现于背景颜色过于接近 可读性变差
  
• 解决
  打开icarus/include/style/codeblock.stly文件，找到.title 添加一行

  icarus/include/style/codeblock.stly

  .tag, .title, .number, .section
      color: inherit

  提示
  如果打开hljs=true 代码块高亮显示正常 但会出现行号与代码高度不一致 以后有待解决

更多常见问题

• 更多常见问题可以去Icrus官方文档

---