Github上Hexo博客搭建教程

2018-08-29

Hexo 介绍
环境准备
参考资料：

Hexo 介绍

Hexo是基于NodeJs的静态博客框架，简单、轻量，其生成的静态网页可以托管在Github和Heroku上。
超快速度
支持MarkDown
一键部署
丰富的插件

下面以我的博客为例，https://sela0629.github.io

环境准备

安装node.js

通过homebrew安装。

安装好homebrew后在终端安装node。

1
2
3

brew link node
brew uninstall node
brew install node

[Node.js]在mac上安装node.js

https://www.jianshu.com/p/3b30c4c846d1

2.安装hexo

1	$ npm install hexo-cli -g

注意：mac系统，则需要

1	$ sudo npm install hexo-cli -g

3.利用Hexo搭建一个博客

3.1 创建博客目录sela0629.github.io 【这个目录为本地项目目录，不影响github中仓库名称，但建议与你的github账号用户名一致，避免后面得修改】

1
2
3

$ hexo init limedroid.github.io
$ cd limedroid.github.io
$ npm install

3.2 生成静态页面

1 2	$ hexo clean $ hexo g

g 即generate

3.3 运行

$ hexo s

s 即server

然后打开浏览器，输入地址 localhost:4000 即可看到效果。

4.发一篇文章试试

4.1 命令方式

1	$ hexo new test

此时会在 source/_post 目录下生成 test.md 文件，输入些许内容，然后保存。生成下，看看效果

1
2
3

$ hexo clean
$ hexo g
$ hexo s

访问 localhost:4000 即可

4.2 直接方式

在 source/_post 目录下新建一个.md文件即可。

5 配置

网站的设置大部分都在_config.yml文件中，详细配置可以查看官方文档

下面只列出简单常用配置

title -> 网站标题
subtitle -> 网站副标题
description -> 网站描述
author -> 您的名字
language -> 网站使用的语言

坑：进行配置时，需要在冒号:后加一个英文空格

title: Droidlover

部署到Github

6.1 有个github账号

https://github.com

6.2 创建一个xxx.github.io的public仓库

如果你的github账户名是sela0629，则创建一个sela0629.github.io的public仓库。请注意使用github账户名，否则生成的博客地址不是简单的 [github user name].github.io

6.3 安装hexo-deployer-git

1	$ npm install hexo-deployer-git --save

6.4 网站配置git

在网站 _config.yml 中配置 deyploy

deploy:
  type: git
  repo: <repository url>
  branch: [branch]

例如：

eploy:
  type: git
  repo: https://github.com/sela0629/sela0629.github.io.git
  branch: master

branch为分支，默认为master,可以不配置 repo为仓库地址，在github上新建仓库后，可复制此地址

6.5 部署

生成静态文件和部署

1 2	$ hexo g $ hexo d

最后出现如下提示代表成功啦！

1	INFO Deploy done:git

d即deploy

7 设置访问github的page页

在仓库的 setting 一栏，当以 github账号名.github.io创建的仓库时会自动开启github pages

Hexo 介绍

环境准备

参考资料：