使用Hexo快速搭建github个人博客

1.安装Nodejs

https://nodejs.org/en/download/

2.注册Github帐号

http://github.com/

3.安装Git

https://git-scm.com/downloads

4.生成密匙

先查看本机是否已有密匙文件id_rsa.pub
(windows在 c:/Users/用户名/.ssh下,mac在~/.ssh)
打开id_rsa.pub并复制全部内容

如果本机没有密匙文件:
在命令行输入命令,在本地生成密匙,(windows需要先把Git安装目录下的\usr\bin添加到环境变量path,否则会报错:ssh-keygen 不是内部或外部命令)

1
ssh-keygen -t rsa

一路enter即可
然后找到id_rsa.pub这个文件
(windows在 c:/Users/用户名/.ssh下,mac在~/.ssh)
复制全部内容

5.建立连接

打开https://github.com/settings/ssh
选择右上角的 New SSH key
key下面的input里面粘贴,然后确定即可

6.建立github博客仓库

点击github头像旁边的+,选择New repository
然后在Repository name里面填入
你的github昵称.github.io
然后点确定即可

7.安装Hexo

1
npm install -g hexo-cli

推荐使用cnpm,速度更快更稳定
安装完成后,可以输入

1
hexo -v

查看版本号,如果有信息则说明安装成功

8.初始化博客

1
2
3
4
5
6
7
8
//建立一个博客文件夹,并初始化博客,foldername为文件夹名称
hexo init foldername
//进入你的文件夹
cd foldername
//安装依赖
npm install
//这个是推送到git仓库的插件
npm install hexo-deployer-git --save

9.修改配置文件

打开根目录下的_config.yml文件,我们修改这几个地方
(注意格式要求比较严格,冒号后面一定要加一个空格)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
//配置网站相关信息
title: 你的标题
subtitle: 你的副标题
description: 你的描述
author: 作者
language: zh-CN
timezone: Asia/Shanghai
//最后两项复制就行
//配置域名
url: https://你的github昵称.github.io
//拉到最底部,配置远程仓库,默认只有type,repo和branch需要自己添加
deploy:
type: git
repo: 去你刚才建立的博客仓库,点击绿色的按钮Clone or download,复制下面出现的链接到这里即可
branch: master

10.新建博客

1
2
//新建一篇article name的文章
hexo new 'article name'

我们去/source/_posts目录下找到这个article name文件,
默认是.md扩展名的markdown文件
发布的时候会自动编译成html文件

(不会的同学可以到网上学习一下相关语法,比较简单)

然后我们在article name.md的文件底部随便写点东西,保存

进行本地预览

1
2
//启动本地服务,也可以直接hexo s
hexo server

打开http://localhost:4000即可进行预览

11.编译上线

1
2
3
4
//编译成静态文件,也可以直接hexo g
hexo generate
//推送到仓库,也可以直接hexo d
hexo deploy

然后在浏览器输入博客网址即可访问,比如我的是
https://f5f5.github.io/
注意:一定要https,http打不开

后记

1.有没有发现博客仓库首页提示缺少readme.md,强迫症是不是很不爽?

没关系,我们来添加这个文件。

还是修改根目录下的配置文件_config.yml,加入一个README.md即可:

skip_render: README.md

然后我们需要在/source目录下新建一个README.md,重新编译上线,提示消失,good!

2.觉得默认的主题不好看?

我们可以到https://hexo.io/themes/查看更多主题,有不少国人制作的主题,按照文档一步步来就可以更换了。