Hexo安装配置

前述

个人感觉hexo已经严重落伍了，但也还不至于完全不能用。今年诸如https://gridea.dev/等静态博客平台也非常用，比hexo也方便太多。

准备工作

需要安装Node.js、Git客户端。同时准备一个github账号。

Node.js的下载地址为https://nodejs.org/en/download/
Git客户端选择较多，比如https://git-scm.com/downloads/
github账号登录网站 https://github.com申请，然后新建个仓库，名称是固定的：用户名.github.io，比如我的用户名是fymod，那么仓库名称就是fymod.github.io，格式是固定的。

【注意】如果是windows环境，软件安装完成后，需要配置Git_HOME，指向Node.js的安装目录，同时在环境变量的Path中添加Git_HOME/bin;Git_HOME/usr/bin

配置

基础配置，不多说了

git config --global user.email "your_email@xx.com"  
git config --global user.name "your_name"
1
2

生成秘钥，用来提交的时候，不用每次输入github账号密码。

ssh-keygen -t rsa -C "your_email@xx.com"
1

回车之后让选择文件保存路径，如果使用默认路径，直接回车即可（默认路径在控制台有显示），然后输入密码等信息，可以为空，直接两次回车，就会在指定或者默认路径下找到id_rsa和id_rsa.pub。
打开id_rsa.pub，复制里面的全部内容。

登录github账号，选择Setting——SSH and GPG keys——New SSH key——输入名称和刚刚复制出来的Key——点击Add SSH key。此时会收到github发送的邮件。
此时可以使用下面的命令判断是否公钥配置成功。

ssh -T git@github.com
1

如果打印出诸如Hi xxx! You’ve successfully authenticated, but GitHub does not provide shell access.表示公钥配置成功。

Hexo安装

执行下面的命令，安装好hexo

npm install -g hexo
1

如果出现异常（mac下较为常见），可以尝试以下命令后再操作

sudo npm cache clean --force
sudo npm update
1
2

新建一个hexo目录，cd进入到目录当中。以下命令均需要在hexo目录中执行。
使用init命令初始化到指定目录

hexo init
1

因为后续的deploy操作的需要，执行以下命令

npm install hexo-deployer-git --save
1

预览和部署

执行到上面的步骤，在hexo下已经有了目录结构，下面生成静态页面。

hexo generate
1

上面的命令也可以简写为 hexo g
这时候静态页面就生成好了，要想在本地预览效果，只需要执行

hexo server
1

默认情况下有一篇叫做hello world的文章，md文件存放目录为source_posts 。

打开hexo根目录下的_config.yml，找到#Site 部分，修改为自己博客的内容。

# Site
title: 这里放标题
subtitle: 这里放子标题
description: 这里放描述
author: 这个放作者
language: zh-CN
1
2
3
4
5
6

找到#Deployment部分，此处是提交github的配置。

deploy:
  type: git
  repo:  git@github.com:your_name/your_name.github.io.git
  branch: master
1
2
3
4

其中your_name需要替换为你github的账号。
需要说明的是，repo我选择了ssh方式的，如果失败可以尝试https方式https://github.com/your_name/your_name.github.io.git。
【注意】如果是windows，文件不能直接保存，一定要另存为，把编码格式从ANSI改为UTF-8，否则会出现乱码，然后替换掉当前的_config.yml。

至此，仅需要执行以下命令，就能发布自己的博客了。每次自己新建完文章之后部署，也是相同命令。

hexo clean #可忽略此命令，必要时再执行
hexo generate
hexo deploy
1
2
3

打开浏览器，输入your_name.github.io，比如我的是fymod.github.io，即可访问到刚刚部署好的博客。

主题

hexo有很多漂亮的主题，默认的landscape也很不错。之前用过jacman，但是已经好多年不更新了，可以自行搜索自己喜欢的。
一般步骤为
1 cd到hexo目录下载主体 git clone xxx
2 配置主题的_config.yml，这个主题的github一般都有说明
3 配置根目录的_config.yml，只需要修改对应主题名称即可

发布文章

新建文章

hexo new "文章名称，可以汉字"
1

此时，在source_posts中就能找到新建的文件。在scaffolds目录下有三个文件，如果不指定，默认使用的是post，上面的命令其实等价于

hexo new post "文章名称，可以汉字"
1

打开新生成的文件，title就是设置的标题，date是发布时间，可以修改，tags是标签。
编辑新建的文件，mac下没有找到非常中意的，windows下个人觉得MakedownPad2还行。语法比较简单，可以参考http://lutaf.com/markdown-simple-usage.htm
文章写好之后，和之前步骤一样，执行命令即可发布到自己的博客平台

hexo clean
hexo generate
hexo deploy
1
2
3