mac环境下搭建hexo+github pages个人博客

一. 建立GitHub

1. 登录github

2. 开始 创建新的仓库Create a new repository

注意，在 Repository name 中的内容必须为和Owner中的名字.github.io 例如，我的就是 yzmean.github.io 。接下来点击Create repository。 会进入形如以下的页面：

配置SSH keys打开mac终端，输入命令

$ cd ~/.ssh     #检查本机的ssh密钥

如果提示 No such file or directory 说明你是第一次使用 git。

接下来生成新的SSH key：

$ ssh-keygen -t rsa -C "你的邮箱地址"

Generating public/private rsa key pair.

Enter file in which to save the key (/Users/your_user_directory/.ssh/id_rsa):<回车>

Enter passphrase (empty for no passphrase):<输入加密串><如不想设置密码可直接回车表示为空>

Enter same passphrase again:<再次输入加密串><接着回车确认>

Your identification has been saved in /Users/你的名字/.ssh/id_rsa).

Your public key has been saved in /Users/你的名字/.ssh/id_rsa.pub.

The key fingerprint is:

43:c5:5b:5f:b1:f1:50:43:ad:20:a6:92:6a:1f:9a:3a "你的邮箱地址"

最后出现类似长方形的字符画即表示成功。

此处可能会遇到几个问题：

- 无法看到.ssh 文件

解决方法：显示隐藏文件即可。（shift+command+.）

如果你要设置密码，那么输入密码时是不会有*字样，直接输入即可。

接下来，将SSH key添加进GitHub。

打开本地刚生成的.ssh/id_rsa.pub（若看不到，则需显示隐藏文件）,准确复制文件中所有内容。然后进入github主页，点击右上角头像进入settings，选择SSH and GPG keys，再点击New SSH Key。将内容复制进key，title可以为空。最后Add SSH key。

可以通过如下命令进行测试是否成功

$ ssh -T [email protected]     #全部复制，无需更改

接下来会出现

1. The authenticity of host 'GitHub.com (207.97.227.239)' can't be established.

2. RSA key fingerprint is 16:27:ac:a5:76:28:2d:36:63:1b:56:4d:eb:df:a6:48.

3. Are you sure you want to continue connecting (yes/no)?<输入yes>

4. Hi 你的用户名! You've successfully authenticated, but GitHub does not provide shell access.

若出现以上提示，则说明添加SSH key成功。

二. hexo安装

1. 首先安装node.js  和  git

测试安装成功否：

node -v 

npm -v

git --version

第二种方式安装nodejs

通过安装homebrew:

1./usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

卸载homebrew：

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/uninstall)"

2.brew -v

3.brew install -g node

出错提醒：                                                                                                                  (1)jiajiadeMacBook-Pro:~ jiajia$ brew install node                                                                 Warning: node 11.10.0 is already installed, it's just not linkedYou can use `brew link node` to link this version.jiajiadeMacBook-Pro:~ jiajia$ sudo chown -R $(whoami) /usr/localchown: /usr/local: Operation not permitted                                                              (2)jiajiadeMacBook-Pro:~ jiajia$ brew link node                                                                      Linking /usr/local/Cellar/node/11.10.0... Error: Could not symlink include/node/common.gypiTarget /usr/local/include/node/common.gypialready exists. You may want to remove it:  rm '/usr/local/include/node/common.gypi'To force the link and overwrite all conflicting files:  brew link --overwrite nodeTo list all files that would be deleted:  brew link --overwrite --dry-run node

(3)jiajiadeMacBook-Pro:~ jiajia$ brew link --overwrite nodeLinking /usr/local/Cellar/node/11.10.0... 368 symlinks created                                          (4)jiajiadeMacBook-Pro:~ jiajia$ node -v                                                                              v11.10.0                                                                                                                       (5)jiajiadeMacBook-Pro:~ jiajia$ npm -v                                                                                       6.7.0                                                                                                                          (6)jiajiadeMacBook-Pro:~ jiajia$ brew -v                                                                            Homebrew 2.0.2-72-g6c55fe1Homebrew/homebrew-core (git revision bda4; last commit 2019-02-23)

2. Hexo 安装

npm install -g hexo-cli

3. Hexo 建站(以后在建，命令只需要从这开始)

$ hexo init blog      #(blog是自定义文件夹名)

$ cd blog

$ npm install

新建完成后，指定文件夹的目录如下：

├── _config.yml

├── package.json

├── scaffolds

├── source

|  ├── _drafts

|  └── _posts

└── themes

_config.yml

网站的配置文件，可以在此配置大部分参数

source

资源文件夹是存放用户资源的地方。除 posts 文件夹之外，开头命名为 (下划线)的文件 / 文件夹和隐藏的文件将会被忽略。Markdown 和 HTML 文件会被解析并放到 public 文件夹，而其他文件会被拷贝过去。

themes

主题文件夹，后面我们使用的next主题即会存放在此。

_posts

存储你发表在博客上的文章，当Hexo 初始化一个站点时，里面会有一篇默认的博文。

4. Hexo 测试

cd blog

hexo s     # (开启本地服务)

如果出现以下提示则成功：

INFO  Start processing

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

三. Hexo 部署到 Git 上

1. 进到hexo文件夹下，打开_config.yml文件

cd hexo

vi _config.yml

在 _config.yml文件的最后，键入i，修改成下面配置：（采用SSH换版本的）

deploy:

  type: git

  repo: [email protected]:jiajiazheng1990/jiajiazheng1990.github.io.git

  branch: master

按下 “ESC” 按钮，而后输入  :wq  退出编辑操作，保存

2. 安装 hexo-deployer-git

cd blog

npm install hexo-deployer-git --save

3. 再执行hexo d来部署(托管到GitHub)

hexo d

出现Deployer done: git表示你部署成功了！

则输入网址jiajiazheng1990.github.io

若出问题：循环以下步骤

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

2. 删除.deploy_git文件夹

3. hexo clean

4. hexo g

5. hexo d