本文针对Mac下超初级用户,已入门者请略过。

1. 检查环境

据说程序员有三大金句:不可能/你环境有问题/你不会用。所以我们先检查一下环境。

Terminal将是我们接下来一直会用到的工具。在Spotlight中或者lauchpad搜索,打开它。

1.1 Git

Terminal中输入git,如果返回如下内容,证明ok.

1
2
3
4
5
6
7
8
usage: git [--version] [--help] [-C <path>] [-c name=value]
[--exec-path[=<path>]] [--html-path] [--man-path] [--info-path]
[-p | --paginate | --no-pager] [--no-replace-objects] [--bare]
[--git-dir=<path>] [--work-tree=<path>] [--namespace=<name>]
<command> [<args>]

These are common Git commands used in various situations:
....

如果没有,可以通过Homebrew, MacPorts 或者安装包进行安装.

1.2. NodeJS

我们使用NVM来管理NodeJS的版本,所以先安装NVM。在Terminal中输入

curl https://raw.githubusercontent.com/creationix/nvm/master/install.sh | sh

回车,等待安装。一旦安装完成,在Terminal中输入nvm install stable来安装稳定版本的nodejs.
安装完成后, 在terminal中输入node --version, 此时应该可以看到如下信息:

1
6.1.0 # 这里显示了安装的版本号

1.3 进入正题:安装Hexo

在自己的电脑中新建一个目录来存放自己的Blog吧,这里我建立了一个名为Hexo的文件夹,然后在Finder中拖动这个文件夹到Terminal中,接着回车,就在Terminal中进入了这个目录。接着输入命令:

1
npm install -g hexo-cli

-g代表全局安装,这样在termnial中,任何路径下都能够使用命令hexo了。

2. 创建Blog

2.1 hexo init & hexo server

Terminla输入hexo init blog, 完成后Hexo文件夹下会出现blog文件夹。cd blog,进入到blog文件夹中,然后hexo server, 不久会返回以下信息:

1
2
INFO  Start processing
INFO Hexo is running at http://localhost:4000/. Press Ctrl+C to stop.

启动完成,在浏览器中打开上述地址http://localhost:4000/, 没错的话应该可以看到自己的网站了。想要退出进程请按Ctrl + C

2.2 修改配置

blog文件夹中的目录应当如下图所示,

1
2
3
4
5
6
7
8
.
├── _config.yml # 这个文件用来配置相关信息
├── package.json
├── scaffolds
├── source
| ├── _drafts
| └── _posts
└── themes

配置的相关信息,参见这里

2.3 hexo new post “magic”

使用如下命令来创建我们的第一篇帖子:

1
hexo new post "magic" # 引号内的是hexo将创建的post名称

得到返回如下 :

1
2
⇒  hexo new post "magic"
INFO Created: ~/Hexo/blog/source/_posts/magic.md

可以看到我们创建了magic.md, 位置是~/Hexo/blog/source/_posts/.

👌,.md后缀一般涌来代表这是一个markdown文件,使用markdown编辑器打开magic.md.
发现内容如下:

1
2
3
4
5
6
7
---
title: magic
date: 2017-03-01 00:40:02
tags:
---

## 我们这部分书写自己的内容, 注意需要学习一下Markdown语法

2.4 hexo generate

参见https://hexo.io/docs/generating.html

使用如下命令来生成博客的文件:

hexo generate或者直接打hexo g

等待一会,blog文件夹下应该出现了一个新的文件夹,名称叫做public

public文件夹中的内容,就是所有生成好的Blog文件。这一部分,我们可以上传到Github上。

3. 上传Github

参见https://hexo.io/docs/deployment.html

安装 hexo-deployer-git, 在terminal中键入

1
npm install hexo-deployer-git --save

_config.yml中的deploy填写上如下信息:

1
2
3
4
deploy:
type: git
repo: GIT的地址
branch: master #一般是master吧

接着,在Terminal中的输入hexo deployhexo deploy,完成。

4. 开启Github Pages

在github仓库的设置页面中,可以找到Github Pages的选项,选择开启后就会获得一个子域名。接着用这个域名访问就好了。