Hexo + Github 之搭建个人博客

什么是 Hexo？

Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown（或其他渲染引擎）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。hexo中文官网地址 https://hexo.io/zh-cn/

Git安装

• git中文官网地址 https://git-scm.com/
• 全程默认安装即可
• git下载：https://git-scm.com/downloads

nodeJS 安装

• nodejs官网地址 https://nodejs.org/en/
• 下载新版或者稳定版全程默认安装即可
• nodeJS下载https://nodejs.org/en/download/
• windows 系统建议下载 .msi 文件，不用为配置环境变量发愁
• 安装完成后，dos窗口用如下命令查看是否安装完成，如果安装成功会显示版本号

node -v
v8.9.4

申请github账号

• github官网地址https://github.com/
• 创建一个仓库如图所示
  
• 创建完成后，找到设置下的，如图所示
  
• 修改成，如图所示，然后点保存
  

到这里我们的仓库已经建好，接下来就是安装hexo

安装Hexo

nodeJS和Git都安装好后，首先创建一个文件夹myblog，用于存放hexo的配置文件，然后进入myblog里，打开git Bash 窗口，进行命令行安装Hexo。
如果您的电脑中已经安装上述必备程序，那么恭喜您！接下来只需要使用 npm 即可完成 Hexo 的安装。

npm install -g hexo-cli // 全局安装

建立站点

安装 Hexo 完成后，请执行下列命令，Hexo 将会在指定文件夹中新建所需要的文件。

hexo init //在您的myblog下面执行，以下如同
npm install

新建完成后，指定文件夹的目录如下：

.
├── _config.yml
├── package.json
├── scaffolds
├── source
|   ├── _drafts
|   └── _posts
└── themes

_config.yml

网站的 配置 信息，您可以在此配置大部分的参数。

• 网站
  title | 网站标题
  -------- | —
  subtitle |网站副标题
  description |网站描述
  author |您的名字
  language |网站使用的语言
  timezone |网站时区。Hexo 默认使用您电脑的时区。时区列表。比如说：America/New_York, Japan, 和 UTC 。

# Site
title: Heping
subtitle:
description:
author: Heping
language: zh-Hans
timezone: 
footerDesc: "我是阿平，我为自己代言！" 

其中，description主要用于SEO，告诉搜索引擎一个关于您站点的简单描述，通常建议在其中包含您网站的关键词。author参数用于主题显示文章的作者。

主题

其中可以在这里 浏览更多主题，然后在Hexo文件夹下 Git Bash 获取下来

• 输入命令

git clone https://github.com/iissnan/hexo-theme-grace themes/hexo-theme-grace  //（hexo-theme-grace为主题名字），来获得更多主题

• 修改主题
  _config.yml 下的 theme

# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: hexo-theme-grace

generate

hexo generate

生成静态文件。

选项	描述
-d, --deploy	文件生成后立即部署网站
-w, --watch	监视文件变动

该命令可以简写为

hexo g

server

hexo server

启动服务器。默认情况下，访问网址为： http://localhost:4000/。

选项	描述
-p, --port	重设端口
-s, --static	只使用静态文件
-l, --log	启动日记记录，使用覆盖记录格式

写文章

在C:__my\hpblog\source_posts文件下，新建.md文件就可以写文章，如图

• 格式要求，标题如下格式

---
title: 我的博客
---

• 博客预览
  

发布博客

• _config.yml下的 github 配置

# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
  type: git
  repo: https://github.com/yuorname/yuorname.git  //您已经创建好的仓库

• 安装 hexo-deployer-git 自动部署发布工具

npm instal lhexo-deployer-git  --save

• 部署网站，该命令一定要在 git Bash 窗口完成

hexo deploy

参数	描述
-g, --generate	部署之前预先生成静态文件

该命令可以简写为：

hexo d

• 最后浏览器 访问：https://hepingmogul.github.io/hepingmogul/