安装

安装前提
在安装前,先确保电脑上已经安装了 Node.jsGit环境。

安装 Hexo

sudo npm install hexo-cli -g
官方是使用 npm 进行安装,有推荐使用 yarn进行安装,关于 yarnnpm 优劣分析,可以参考这篇文章《Yarn vs npm: 你需要知道的一切》

建站

先新建一个blog文件夹,然后进入该文件夹运行:

初始化: hexo init
继续运行: hexo g && hexo s

运行成功后会发现提示信息:

MacOSdeMacBook-Pro:lovely macos$ hexo s
INFO  Start processing
INFO  Hexo is running at http://localhost:4000 . Press Ctrl+C to stop

这个时候访问 http://localhost:4000/ 就会发现网站已经建好了!

常用命令

以下 4 个是我在搭建过程中发现使用频率最高的 4 个命令,甚至我感觉只要会这 4 个命令就可以了。

1.generate
生成静态文件
hexo generate

2.server
启动服务器
hexo server

3.deploy
部署网站
hexo deploy

4.clean
清除缓存文件(db.json)和已生成的静态文件(public)
hexo clean

更多命令和参数请看 这里

部署到 Github

首先先到 Github 上新建一个仓库,仓库名的格式为:
*.github.io
例如我的就是dearzhe.github.io ,创建好后,复制仓库的 HTTPS地址,打开blog根目录下的 _config.yml文件,拖动到底部找到deploy配置,按照以下格式修改并保存:

deploy:
type: git
repo: 这里填入你之前在GitHub上创建仓库的完整路径,记得加上 .git
branch: master
这个时候安装 hexo-deployer-git 自动部署发布工具
npm install hexo-deployer-git --save

配置SSH

设置user nameemail

git config –global user.name “你的GitHub用户名”
git config –global user.email “你的GitHub注册邮箱”
生成ssh密钥:输入下面命令

ssh-keygen -t rsa -C "你的GitHub注册邮箱"

一般情况下是不需要密码的,所以,接下来直接回车就好。
此时,在用户文件夹下就会有一个新的文件夹.ssh,里面有刚刚创建的ssh密钥文件id_rsaid_rsa.pub
vim ~/.ssh/id_rsa.pub

注:id_rsa文件是私钥,要妥善保管,id_rsa.pub是公钥文件。

美化

主题

###安装 NexT
git clone https://github.com/theme-next/hexo-theme-next

修改_config.yml 文件里 theme 配置:

theme: hexo-theme-next

切换成NexT主题,在hexo根文件夹下,编辑_config.yml文件

theme: hexo-theme-next

切换后,清下本地缓存
hexo clean

执行hexo s本地产看NexT主题效果

切换主题
在列表中选择一款自己喜欢的主题风格。

Schemes

scheme: Muse //默认主题
#scheme: Mist
#scheme: Pisces //我选的是这个
#scheme: Gemini

设置Menu

默认只有两个首页和归档.

如果还要添加,编辑themes/next/_config.yml

menu:
home: / || home //首页
about: /about/ || user //关于
tags: /tags/ || tags //标签
categories: /categories/ || th //分类
archives: /archives/ || archive //归档
schedule: /schedule/ || calendar //日程表
sitemap: /sitemap.xml || sitemap //站点地图
  1. 创建“分类”页面
    hexo new page categories

给标签页面添加类型
我们在source文件夹中的tags文件夹下找到index.md文件,并在它的头部加上type属性。
title: 文章分类
date: 2017-05-27 13:47:40

type: “categories” #这部分是新添加的

  1. 创建“标签”页面
    hexo new page tags
    title: tags
    date: 2018-08-06 22:48:29
    type: “tags” #新添加的内容

给模板添加分类属性
现在我们打开scarffolds文件夹里的post.md文件,给它的头部加上categories:,这样我们创建的所有新的文章都会自带这个属性,我们只需要往里填分类,就可以自动在网站上形成分类了。
title: 使用-Hexo-和-Github-快速搭建个人博客
date: 1558506405000
categories:
tags:
`

设置侧边栏头像
编辑主题的_config.yml,新增字段 avatar, 值设置成头像的链接地址。

其中,头像的链接地址可以是:

完整的互联网 URL,例如:https://avatars1.githubusercontent.com/u/32269?v=3&s=460

站点内的地址,例如:url: /images/avatar.gif

部署到 github 一个 README.md

在Hexo目录下的source根目录新建 一个README.md。修改_config.yml中的skip_render参数值为README.md保存退出即可。
使用hexo d 命令就不会在渲染 README.md 这个文件了。

参考
设置侧边栏头像
next主题配置
Hexo系列教程: (五)部署时保证README.md不被渲染


一个好奇的人