Build Blog using Hexo on Github

2018-01-15

本片目前基本完工,若有缺漏请通过git告诉我

本片针对于Mac用户,通过Hexo搭建Git博客(需要GitHub账号)

环境配置

安装Hexo之前,需要安装Node.js以及Git

安装完成后,在Mac Terminal中输入:

1
2
3
node -v
npm -v
git --version

查看Node.js,npm以及git是否成功安装。

安装Hexo

1
sudo npm install -g hexo-cli

查看Hexo是否安装成功:

1
hexo -v

初始化Hexo项目

通过以下命令初始化一个新建项目:

1
2
3
hexo init <folder>
cd <folder>
npm install

<folder>替换为项目名称,在这里我们使用blog作为项目名称
npm install命令安装依赖

可以在_config.yml中更改博客的配置
但是必须要注意的是,hexo对空格敏感,属性名(例如title: username)的冒号之后不能省略一个空格,否则不能生效

运行generate指令,生成静态文件:

1
hexo generate

或者使用:

1
hexo g

接着使用server命令,启动一个local server来查看项目:

1
hexo server

同样也有:

1
hexo s

可以通过浏览器在本地查看页面,默认地址为:http://localhost:4000/
通过以上方法,可以在将博客内容发布到git之前,在本地修改、查看
一般来说,博客内容只要保存之后刷新页面即可查看
部分特殊的设置需要重新生成后再启动服务器查看

创建新博客内容

在blog目录下,输入指令:

1
hexo new blog_name

在/blog/source/_post/下能看到新生成的blog_name.md文件
可以使用markdown语言编辑文件内容
markdown用法参见Mastering Markdown

配置git

在发布博客之前,我们需要配置好git
登陆github官网地址进行账号注册

添加ssh key

首先,在终端输入

1
cd ~/.ssh

进入ssh文件夹。如果显示No such file or directory,执行:

1
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

生成ssh key
your_email@example.com替换为注册的邮箱账号
过程中将提示你输入passphrase,如果不输入直接回车则表示无passphrase
然后执行:

1
ssh-add -K ~/.ssh/id_rsa

将ssh key添加到key文件中
然后输入:

1
pbcopy < ~/.ssh/id_rsa.pub

获取生成的ssh key
接下来,在GitHub上点击右上角头像,选择Settings进入设置页面,选择SSH and GPG keys
点击New SSH key将ssh key添加到Key栏中,编辑Title来标记该ssh key

在第一次尝试连接GitHub时会询问用户是否想要连接到GitHub,输入yes即可

新建Repository

在个人主页点击Repositories分页,右上角点击New按钮,新建一个repository

也可以在登陆后,直接进入https://github.com/new

Repository name栏输入username.github.io
username替换为你的用户名,其必须和你的用户名一致
之后将可以通过username.github.io访问你的博客

部署到GitHub

接下来,在blog目录下输入:

1
npm install hexo-deployer-git –save

来安装hexo的git部署器
在_config.yml中添加部署配置:

1
2
3
4
5
deploy:
type: git
repo: <repository url>
branch: [branch]
message: [message]

repository url替换为https://github.com/username/username.github.io格式
username为你的用户名,branch项改为mastermessage项可以留空。
修改完成后,在terminal输入:

1
2
hexo g
hexo d

生成静态文件并部署至GitHub。
接下来,用户就可以前往username.github.io查看自己的博客

Jeanne d'Arc

..-. . -.