title: hexo静态博客安装详解
date: 2020-03-08 01:08:06
tags:

• Hexo
• 搭建博客
• 静态博客
  categories:

• Hexo静态博客搭建与配置
  toc: true

  Hexo静态博客框架是一个非常易用易配置的博客框架，是搭建博客的不错的选择，本文详细介绍了Hexo博客的搭建步骤，并对博客的操作和配置做了简单的介绍，博客配置的详细内容以后会再开帖详述。

hexo静态博客安装详解

参考文档：

• CodeSheep-Hexo博客搭建
• Hexo官方文档
• 菜鸟教程 – Node.js 安装配置
• 淘宝NPM镜像 – 使用说明
• Hexo-butterfly主题文档

安装可能会碰到各种问题，一般只要按照步骤，不会有太大问题。但是以防万一，第一、及时拍快照备份，第二、博客目录如果出现问题可以删除重新开始。

准备工作

安装nodejs

1. 下载并解压nodejs

   [root@Friday ~]# wget https://nodejs.org/dist/v10.9.0/node-v10.9.0-linux-x64.tar.xz
   [root@Friday ~]# mkdir -p /usr/software/nodejs  //将软件放在此目录下
   [root@Friday ~]#  tar -xvf node-v10.9.0-linux-x64.tar.xz -C /usr/software/nodejs --strip-components 1

2. 创建软链接（快捷方式）

   [root@Friday ~]# ln -s /usr/software/nodejs/bin/npm   /usr/local/bin/ 
   [root@Friday ~]# ln -s /usr/software/nodejs/bin/node   /usr/local/bin/

3. 验证

   [root@friday ~]# node -v    //输出版本号，说明配置成功
   v10.9.0
   [root@friday ~]# npm -v     //输出版本号，说明配置成功
   6.2.0

安装cnpm代替nodejs中的npm

1. 安装cnpm

   [root@Friday ~]# npm install -g cnpm --registry=https://registry.npm.taobao.org

2. 为cnpm创建软链接

   [root@Friday ~]# ln -s /usr/software/nodejs/bin/cnpm   /usr/local/bin/ 

3. 验证

   [root@friday ~]# npm -v     //输出版本号，说明配置成功
   6.2.0

安装git

1. 安装git

   [root@Friday ~]# yum install git-core -y

2. 验证

   [root@10 ~]# git --version      //输出版本号，说明配置成功
   git version 1.8.3.1

安装hexo

1. 安装hexo
   

   如果报[fsevents@~2.1.2] optional install error: Package require os(darwin) not compatible with your platform(linux)警告，不必理会意思是，可选的安装错误，包要求macos但是你的是linux不兼容；

   [root@Friday ~]# cnpm install -g hexo-cli

2. 为hexo创建软链接

   [root@Friday ~]# ln -s /usr/software/nodejs/bin/hexo   /usr/local/bin/ 

3. 验证

   [root@friday ~]# hexo -v
   hexo-cli: 3.1.0
   os: Linux 3.10.0-957.el7.x86_64 linux x64
   http_parser: 2.8.0
   node: 10.9.0
   v8: 6.8.275.24-node.14
   uv: 1.22.0
   zlib: 1.2.11
   ares: 1.14.0
   modules: 64
   nghttp2: 1.32.0
   napi: 3
   openssl: 1.1.0i
   icu: 62.1
   unicode: 11.0
   cldr: 33.1
   tz: 2018e

使用hexo搭建博客

1. 创建博客目录
   

   如果安装过程中出现什么问题，可以删除这个目录，重新开始。

   [root@Friday ~]# mkdir blog
   [root@Friday ~]# cd blog

2. 生成博客

   [root@Friday blog]# hexo init

博客配置与操作

对于“博客功能插件配置”、“博客配置文件修改”、“博客主题配置文件修改”这几个主题会重新开帖。这里只做简单介绍。

hexo博客基本操作

hexo d：将静态博客文件部署到远端，需要在博客配置文件中进行配置；
hexo n “文章名称”：创建以“文章名称”为名称的文章，不过不建议用中文，执行命令后在博客目录（上面创建的名为blog的目录：blog/source/_port）下生成名为“文章名称.md”的markdown文件；
hexo n page “about”：创建about页面，需要在博客配置文件中进行配置；
hexo博客使用方法：

• 使用hexo n “文章名称”命令生成以“文章名称”为名的文章；
• 使用markdown语法编辑在blog/source/_port/目录下的“文章名称.md”文件；
• 使用hexo clean命令清理上次生成的静态博客网页文件；
• 使用hexo g命令重新生成静态博客网页文件；
• 使用hexo s命令将生成的静态博客网页文件运行在本地机器的4000端口，以便预览自己写的文章或者预览对博客的主题等的修改
• 确定无误后，使用hexo d命令将静态博客网页文件部署到远端

  [root@Friday blog]# hexo clean  //清理上次生成的静态博客网页文件
  [root@Friday blog]# hexo g      //重新生成静态博客网页文件
  [root@Friday blog]# hexo s      //在本地4000端口运行静态博客
  [root@Friday blog]# hexo d      //将静态博客文件部署到远端
  [root@Friday blog]# hexo n "文章名称"   //创建一篇文章
  [root@Friday blog]# hexo n page “页面名称”  //创建新页面

hexo博客配置文件

在博客目录下面的_config.yml文件中配置XXX等信息，详细方法重开一贴。

[root@Friday blog]# vim _config.yml

hexo博客主题配置文件

在博客目录下的themes/landscape/_config.yml文件中配置XXX等信息，详细方法重开一帖。

[root@Friday blog]# vim themes/landscape/_config.yml

可能遇到的问题

问题一

• 问题描述：

  INFO  Checking dependencies
  ERROR Package cheerio is not installed.
  ERROR Please install the missing dependencies from the root directory of your Hexo site.

• 解决方法：

  [root@friday blog]# cnpm install cheerio@0.22.0 --save

• 问题解释
  cheerio没有安装

  问题二

• 问题描述

  [fsevents@~2.1.2] optional install error: Package require os(darwin) not compatible with your platform(linux)

• 解决方法

  [root@friday blog]# cnpm rebuild node-sass

• 问题解释
  fsevents这个包只能在mac ox系统用，在linux不兼容，这是一个可选错误，可以忽略。

日拱一卒，功不唐捐！