title: 使用GitHub + Hexo搭建博客(Mac版)
安装环境
安装Node.js
从Node.js官网按其提示安装,安装成功后如下图:
安装成功的Node.js和npm都被安装到了/usr/local/bin目录下,可对其进行测试,看Node.js和npm是否可用:
查看Node.js的版本号:
$ node -v
Node.js成功安装,可看到如下类似的信息:
maomaodeMacBook-Pro:~ maomao$ node -v
v6.2.0
查看npm的版本号:
$ npm -v
npm成功安装,可看到如下类似的信息:
maomaodeMacBook-Pro:~ maomao$ npm -v
3.8.9
安装Git
Xcode自带Git,查看Git版本号:
$ git version
本地已安装git,可看到如下类似的信息:
maomaodeMacBook-Pro:~ maomao$ git version
git version 2.5.4 (Apple Git-61)
安装设置Hexo
安装Hexo
在Node.js和Git安装完成后 安装Hexo,在终端输入如下命令:
$ sudo npm install -g hexo
注:一定要在前面加sudo
,表示Linux系统管理指令,不加sudo
会出现权限问题的报错。
安装成功会出现类似下图所示的信息:
初始化Hexo
在用户目录(Users)下创建名为hexo的文件夹,在终端cd进入到此目录下,执行命令:hexo init
,操作如下:
1 打开Finder,"前往"->"上层文件夹",在用户目录下新建hexo文件夹,如下图所示:
2 在终端进入hexo文件夹,进行初始化hexo,输入内容如下:
$ cd hexo
$ hexo init
输入后开始初始化:
生成静态页面
1 部署前安装依赖:
$ npm install
2 生成静态页面:
$ hexo generate
生成静态界面时终端的显示如下图:
3 开启本地服务器,在本地预览所生成的静态页面,control+c停止服务器:
$ hexo server
开启本地服务器后显示如下图:
使用http://localhost:4000/在浏览器打开查看本地效果,本地效果如下图所示:
关联GitHub
创建仓库repository
1 登录github帐号,右上角"+"下选择 New repository,创建将用于存储博客的仓库,选择位置如下图所示:
2 新建仓库时要使用your_username.github.io
固定格式命名仓库,例如:我的用户名为"maoqiq",则我的仓库名为"maoqiq.github.io",如下图所示:
此时本地的hexo文件夹下的内容如下图所示:
博客部署到github
1 在终端cd进入hexo文件夹,输入以下命令安装git部署器:
$ npm install hexo-deployer-git --save
2 修改根目录下的站点配置文件_config.yml,本人直接使用sublime打开hexo文件夹下的_config.yml文件,在文件末尾修改如下内容,然后保存:
deploy:
type: git
repo: https://github.com/maoqiq/maoqiq.github.io.git
branch: master
注:maoqiq
改为your_username
,即你的github博客仓库的网址,如下图所示:
注:在配置所有配置文件_config.yml时,所有:
冒号后都要加一个"空格"
3 在hexo目录下,生成静态页面:
$ hexo generate
4 执行部署命令,如果没有关联github,执行时终端会提示输入github的用户名和密码,输入后等待执行成功:
$ hexo deploy
正在执行hexo deploy
中的终端如下图所示:
hexo deploy
命令执行成功后,在浏览器使用网址https://maoqiq.github.io/打开页面,与本地预览的效果相同,则部署成功,成功页面如下图所示:
发表文章
新建文章文件
终端cd进入到hexo目录下执行如下命令创建新文章的.md
文件:
$ hexo new "My first article"
创建成功会提示:
INFO Created: /Users/hexo/source/_posts/My first article.md
编写文章内容
本人使用Mou编辑器(Markdown语言编辑器)编写文章内容,下载后直接将My first article.md
文件使用Mou编辑器打开,根据Markdown语法格式编写文章内容,或者使用HTML编写内容(Mou兼容HTML语法格式)。
注:使用两种语法格式编写文章内容时,避免嵌套使用,因为在HTML标签内的Markdown格式语法不会被处理。
生成部署新文章
文章编写好后,执行如下命令,重新生成页面并部署到github上:
$ hexo clean
$ hexo generate
$ hexo deploy
注:hexo命令支持如下缩写形式:
hexo generate = hexo g
hexo deploy = hexo d
hexo server = hexo s
hexo new = hexo n