Hexo 搭建博客 [ 一家人 ]

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

配置环境

申请GitHub

作用：用来做博客的远程创库、域名、服务器
Github注册账号。

安装Node.js

作用：用来生成静态页面的
官网下载并安装。安装成功后可用 node -v 查看版本号。

安装Git

作用：把本地的 Hexo 内容提交到 Github 上去
Mac 安装 Xcode 自带有 Git，WSindows 可去官网下载。
安装完成后，还需要设置你 Github 的用户名密码，在命令行输入

1 2	$ git config --global user.name "Your Name" $ git config --global user.email "email@example.com"

因为 Git 是分布式版本控制系统，所以，每个机器都必须自报家门：你的名字和 Email 地址。安装成功后可用 git --version 查看版本号。

安装并本地部署Hexo

执行如下命令安装 Hexo

1	$ npm install -g hexo-cli

创建一个文件夹，用来存放 Hexo 的配置文件，进入该文件夹

1
2
3

hexo init <folder>
cd <folder>
npm install

现在项目根目录结构如下

.
├── public // 执行 hexo generate 命令，输出的静态网页内容目录
├── scaffolds // 模板文件夹。当你新建文章时，Hexo会根据scaffold来建立文件
├── scripts // 存放自定义 javascript 脚本
├── source // 存放用户资源的地方
|   ├── _drafts // 草稿文章
|   └── _posts // 发布文章
├── themes // 存放博客的主题，Hexo会根据主题来生成静态页面
├── _config.yml // 博客的配置信息，你可以在此配置大部分的参数
└── package.json

生成静态页面

1	$ hexo generate

启动本地服务，打开浏览器输入 http://localhost:4000/ 即可访问

1	$ hexo server

将博客托管到Github

配置 SSH Key，将本地目录与 Github 关联

配置SSH Key是让本地 git 项目与远程仓库建立联系。SSH Keys不配置的话每次项目有改动提交的时候就要手动输入账号密码，配置了就不需要了。

首先检查是否已经有SSH Key

cd ~/.ssh

如果没有目录.ssh，则要生成一个新的SSH Key，执行：

1	ssh-keygen -t rsa -C "your e-mail"

接下来几步都直接按回车键，然后系统会要你输入密码。这个密码会在你提交项目时使用，如果为空的话提交项目时则不用输入。

成功后进入到.shh文件夹中再输入ls，查看是否有id_rsa.pub文件

1 2	cd ~/.ssh ls

打开id_rsa.pub文件

1	cat id_rsa.pub

复制SSH Key后，去 github 的 https://github.com/settings/keys 页面配置，将其添加到Add SSH Key里。

测试 SSH Key 是否配置成功

执行：

1	ssh -T git@github.com

如配置了密码则要输入密码，输完按回车。如果显示以下内容，则说明Github中的 ssh 配置成功。

1 2	Hi username! You have successfully authenticated, but GitHub does not provide shell access.

创建仓库 Github Pages

GitHub Pages 分两种，一种是你的 GitHub 用户名建立的 username.github.io 这样的用户/组织页，另一种是依附项目的pages。想建立个人博客是用的第一种，每个用户名下面只能建立一个。

登陆Github官网成功后，新建 New repository，建立与你github用户名对应的仓库，仓库名必须为 your_user_name.github.io

修改Hexo的`_config.yml`文件

根目录_config.yml是博客的配置文件，以后修改博客会用到。

现在我们需要修改_config.yml文件，来建立关联，执行命令：

1	vim _config.yml

找到相应部分并修改：

deploy:
  type: git
  repo: git@github.com:yourname/yourname.github.io.git,master # yourname替换成你的Github账户名
  branch: master

注意：在yml文件中，冒号后面都是要带空格的

将博客项目上传到仓库

然后执行命令：

1	npm install hexo-deployer-git --save

然后执行命令：

1
2
3

hexo g #生成静态网页

hexo d #部署到远程仓库

此时，通过访问 http://yourname.github.io 可以看到默认的 Hexo 首页

每次部署的命令：

hexo clean

hexo generate

hexo deploy

或者 hexo g -d

一些常用命令：

hexo new "postName" # 新建文章

hexo new page "pageName" # 新建页面

hexo generate # 生成静态页面至public目录，markdown转html

hexo server # 开启预览访问端口（默认端口4000，'ctrl + c'关闭server）

hexo deploy # 将.deploy目录部署到GitHub

hexo clean # 清楚public文件夹，清除缓存数据

hexo help # 查看帮助

hexo version # 查看Hexo的版本

hexo n == hexo new

hexo g == hexo generate

hexo s == hexo server

hexo d == hexo deploy

添加标签和分类

添加分类

新建一个页面，命名为 categories

1	hexo new page categories

在 source 目录下会生成 categories 目录，修改 source/categories 目录的 index.md :

---
title: 分类
date: 2018-12-06 22:54:28
type: "categories"
---

在主题的_config.yml 中取消注释:

1	categories: /categories

给模板添加分类属性，打开scarffolds文件夹里的post.md文件，给它的头部加上categories:，这样我们创建的所有新的文章都会自带这个属性，我们只需要往里填分类，就可以自动在网站上形成分类了。

title: {{ title }}
date: {{ date }}
categories:
tags:

给文章添加分类，在要分类的文章顶部加入 category 属性，值为某个分类名:

---
title: 文章标题
categories: 分类名
date: 2018-12-09 17:46:34
---

添加标签

新建一个页面，命名为 tags

1	hexo new page tags

在 source 目录下会生成 tags 目录，修改 source/tags 目录的 index.md :

---
title: 标签
date: 2018-12-06 22:54:28
type: "tags"
---