# 前言

本文仅仅是使用hexo以及gitHubPages 快速搭建个人博客，后续还会分享详细的内容

官方中文文档： https://hexo.io/zh-cn/docs/index.html

# 一、准备

Node.js 作用：node.js用来创建hexo博客框架 Git客户端 作用：把本地的hexo内容提交到github上去

# 二、Hexo

打开下载好的Git Bash或者Git Shell，作用相当于命令行。

过程中使用的是cnpm，下载node会自带npm，下面使用的是淘宝镜像cnpm

# 1. 安装Hexo

cnpm install -g hexo

-g为全局安装

# 2. 创建博客根文件夹

进入要创建博客的文件夹下（如E:\Hexo），执行以下指令，Hexo 即会自动在目标文件夹建立网站所需要的所有文件。

hexo init  "文件夹名"

文件夹名称可以不写，那样就会把所有文件放在你先前进入的文件夹

# 3. 安装依赖包

进入到你的博客文件夹下：

cnpm install

把package.json文件所定义的所有依赖项全部安装

# 4. 运行

常用命令

hexo g #完整命令为hexo generate,用于生成静态文件
hexo s #完整命令为hexo server,用于启动服务器，主要用来本地预览
hexo d #完整命令为hexo deploy,用于将本地文件发布到github上
hexo n #完整命令为hexo new,用于新建一篇文章
hexo g -d #两个命令的合成，一般在修改或者添加博文后直接使用这个命令

运行下面代码：

hexo g
hexo s

访问https://localhost:4000， 此时，你就能看到了一个漂亮的博客。 默认主题为：landscape

# 三、注册Github帐号

已经有Github帐号跳过此步

1. 首先进入Github进行注册

2. 然后，创建repository

repository相当于一个仓库，用来放置你的代码文件。首先，登陆进入Github，并进入个人页面 然后New一个repository

]

点进仓库，点击settings设置

下拉到GitHub Pages设置

source选中 master bransh ，然后save，就会出现一个网址。

# 四、部署本地文件到github

# 1. 安装依赖

cnpm install hexo-deployer-git --save

# 2. 编辑配置文件

编辑博客文件夹下的_config.yml文件。

在_config.yml最下方，添加如下配置：

deploy: 
    type: git
    repo: https://github.com/用户名/仓库名/
    branch: master

# 3. 配置SSH

输入一下命令：

ssh -T git@github.com

你应该会看到有警告，但是会有选项（yes/no），输入“yes”就好

# 4. 运行

在命令行中运行

hexo g -d

完成后，打开原先的仓库网址，就能看到你的博客。

# 五、写博文

# 1. 新建博文

hexo new "my new post"

# 2. 编辑博文

博文使用的是markdown语言，如果有不会使用的，请参考我的博文： mardown学习总结

在博客目录下\source_post中打开my-new-post.md，进行编辑

# 3. Front-matter

博文的头部，官方文档介绍：Front-matter

Front-matter 是文件最上方以 ---分隔的区域，用于指定个别文件的变量，如：

---
title: Hello World   #博文标题名
date: 2013/7/13 20:46:25  #发布时间
update:              #更新时间
categories: blog     #文章文类
tags: [life，travel]  #文章标签 只有一个标签时：tags: travel
comments: true       #是否能够评论
---
#这里是正文，用markdown写
#你可以选择写一段显示在首页的简介后，加上<!--more-->
#在<!--more-->之前的内容会显示在首页，之后的内容会被隐藏，当游客点击Read more才能看到。

写完文章后，你可以直接运行hexo g -d 上传到github。

# 六、创建页面

使用命令：

hexo new page "pagename"

# 1. 归档页面

hexo new page "archives"

进入博客目录的source/archives/index.md，添加type值：

---
type: archives
---

# 2. 分类页面

hexo new page "categories"

进入博客目录的source/categories/index.md，添加type值：

---
type: categories
---

# 3. 标签页面

hexo new page "tags"

进入博客目录的source/tags/index.md，添加type值：

---
type: tags
---

注意：上述页面都有对应插件生成，只需更改type值

# 4. 自定义页面

以上述同样的方法创建页面

1. 需要模板，自行修改对应的index.md文件内容
2. 不需要模板，完全自定义
   • 首先，在博客目录下的_config.yml文件中，在skip_render后面添加页面路径
   • 修改index.md文件，或者将index.md修改成index.html文件，自行添加样式等

# 参考

胖逆的嘟嘟的博文： hexo 的八篇干货