1. 安装hexo
1.1 安装node.js
在node.js官网下载对应系统的安装包，按照提示进行安装，前提是需要安装好npm，然后通过npm安装各种需要的工具，安装成功后输入以下命令检测
npm -v
node -v
1.2 安装hexo
npm install hexo-cli -g
hexo -v
2. 创建博客项目
2.1 在需要存放博客项目的目录下创建博客
hexo init Blog
cd Blog
npm install
如果是已有的项目，需要在项目下面运行
npm install hexo --save
2.2 生成静态页面
hexo clean
hexo g // g即generate
2.3 运行
hexo s // s即server
访问 localhost:4000 查看效果
3. 配置
网站的设置大部分都在_config.yml文件中
- title：网站标题
- subtitle：网站副标题
- description：网站描述
- author：你的名字
- language：网站使用的语言
language: default #默认是英文
# language: zh-CN
# language: fr-FR
# language: zh-HK
# language: zh-TW
# language: en
# language: ru
# language: de
注意：进行配置时，需要在冒号:后加一个英文空格
在GitHub上Create a new repository, Repository name必须以.github.io
修改最后一行的配置
deploy:
type: git
repository: https://github.com/phepe/phepe.github.io
branch: master
修改URL 设定为 git pages 地址
url: https://phepe.github.io/
完成配置后安装 hexo-deployer-git
npm install hexo-deployer-git --save
部署到GitHub上
hexo g // 重新生成博客
hexo s // 本地预览博客
hexo d // d即deploy 运行的过程中输入对应的github的账号密码
访问 https://phepe.github.io/ 查看效果
4. 新增博客
4.1 命令方式
在博客目录下输入
hexo new "Tutorail"
此时会在source/_posts目录下生成Tutorail文件，写入一些内容再保存,然后执行
hexo clean
hexo g
hexo s // -p 9090 设定端口为 9090
然后生成静态页面，访问 localhost:4000 查看效果
4.2 直接方式
在 source/_posts/下新建.md文件，然后写入内容，然后使用命令生成静态页面
5. 设置博客主题
5.1 下载主题
将网站找到的主题下载到项目的themes目录下，使用next主题
git clone https://github.com/theme-next/hexo-theme-next themes/next
5.2 设置主题
在项目目录下的_config.yml中，配置theme
theme: next
可在/theme/{theme}/_config.yml 主题的配置文件下进行主题的配置，根据官方文档配置。scheme language等配置
6. 设置分类功能
6.1 启用分类功能
- 查看项目目录下的_config.yml 看是否有
category_dir: categories - 查看theme目录下的_config.yml 看是否有
categories: /categories
6.2 新建分类
使用如下命令，会在source目录下生成categories/index.md文件
hexo new page categories
修改categories/index.md 增加type和comments字段
---
title: categories
date: 2018-06-20 20:50:29
type: "categories"
comments: false
---
6.3 给文章设置分类
在文章的头部加上categories字段，通过这个字段设置分类
---
title: GitHub搭建博客教程
date: 2018-06-20 18:25:54
categories:
- Git
tags:
---
7. 设置标签功能
7.1 启用标签功能
- 查看项目目录下的_config.yml 看是否有
tag_dir: tags - 查看theme目录下的_config.yml 看是否有
tags: /tags
7.2 新建标签
使用如下命令，会在source目录下生成tags/index.md文件
hexo new page tags
修改tags/index.md 增加type和comments字段
---
title: tags
date: 2018-06-21 10:32:06
type: "tags"
comments: false
---
7.3 给文章设置分类
在文章的头部加上tags字段，通过这个字段设置分类
---
title: GitHub搭建博客教程
date: 2018-06-20 18:25:54
categories:
- Git
tags:
- GitHub
---
8. 增加评论功能
8.1 安装gitment
npm install gitment --save
8.2 在Github上注册
在Github进行注册，获取Client ID和Client Secret
Application name : phepe
Homepage URL : https://phepe.github.io/
Application description : blog
Authorization callback URL : https://phepe.github.io/
8.3 在主题里面开启Gitment评论功能
打开themes/next目录下的_config.yml文件进行修改并保存, 修改下面展示的字段
gitment:
enable: true
github_user: phepe
github_repo: phepe.github.io
client_id: *******
client_secret: *****
8.4 初始化评论功能
生产网站，提交到github上，点击一个文章，初始化下方的评论按钮，会提示你用github登陆，发布评论，测试是否成功。
9. 增加联系方式
开themes/next目录下的_config.yml文件，找到social字段，开启对应的联系方式
social:
#GitHub: https://github.com/yourname || github
E-Mail: mailto:phepe@foxmail.com || envelope
#Google: https://plus.google.com/yourname || google
#Twitter: https://twitter.com/yourname || twitter
#FB Page: https://www.facebook.com/yourname || facebook
#VK Group: https://vk.com/yourname || vk
#StackOverflow: https://stackoverflow.com/yourname || stack-overflow
#YouTube: https://youtube.com/yourname || youtube
#Instagram: https://instagram.com/yourname || instagram
#Skype: skype:yourname?call|chat || skype
10. 通过git管理自己的博客的项目
通过hexo d上传的是生成好的网页，我们通过git管理自己的项目需要将blog项目上传，其中node_modules不用上传，每次通过npm install 重新拉启对应的node模块。然后为了保证使用的主题可以方便更新，主题也不用上传,因为我们使用主题的时候直接使用的git clone https://github.com/theme-next/hexo-theme-next themes/next 所以主题本身有自己的版本控制，不需要我们上传。public目录和db.json文件也不用上传，因为每次都是新生产的。
因此不用上传的目录和文件有:
- node_modules
- themes/next
- public
- db.json
11. 其它
在自己的文章中加入<!--more-->可以启用首页阅读全文的功能
在对应的theme目录下的_config.yml文件下有auto_excerpt字段，可以开启阅读全文的功能，但是首页显示的部分样式变了
在对应的theme目录下的_config.yml文件下有number字段是自动为标题设置序号到，由于我们一般会自己给标题一个序号，所以一般把它设置为false
在对应的theme目录下的_config.yml文件下有avatar字段里面的url是设置图像的，相对路径是source目录