mac下搭建hexo博客,步骤多,加上网上教程不是特别详细,尤其对于新手来说,特别容易出错,出错了都不知道怎么搜寻解决办法,本人把mac下搭建hexo的详细步骤,包括常见错误也都写出来。
先屡下思路
- 首先hexo是基于nodejs的,所以必须安装nodejs
- 安装nodejs方法很多,我选择homebrew安装方式,所以需要安装它
- 安装homebrew就很简单了,mac自带ruby脚本功能,一句话搞定
- hexo提交部署github需要使用git工具,所以需要安装git,用homebrew的话也是一句话搞定
- 安装顺序(homebrew-nodejs-hexo-git)
安装brewhome
ruby -e "$(curl -fsSL https://raw.github.com/Homebrew/homebrew/go/install)”
打开brew网址获取最新brew安装方法,brew安装之后默认主目录在/usr/local/bin/brew下
安装nodejs
brew install node
安装hexo
npm install -g hexo
hexo init
npm install
hexo安装后默认主目录为/Users/xxx,xxx为你的计算机用户名,_config.yml,themes,source,scaffolds一些很常用文件都在这个目录下
安装git
sudo brew install git
安装git时可能会提醒一次,安装会失败,继续安装
配置SSH key
用github管理项目的时候,可以直接使用https url克隆到本地,也可以使用SSH url克隆到本地,使用SSH rul克隆的话需要先配置添加好SSH key。
- 检查SSH key
cd ~/.ssh
这个命令就是检查是否已经存在 id_rsa.pub 或id_dsa.pub文件,如果已经存在,可以跳过步骤2,直接进入步骤3.
- 生成SSH key
$ ssh-keygen -t rsa -C "your_email@example.com"
运行上面那条命令后会让你输入一个文件名,用于保存刚才生成的SSH key代码,如:
Generating public/private rsa key pair.
# Enter file in which to save the key (/c/Users/you/.ssh/id_rsa): [Press enter]
接着又会提示输入两次密码,改密码是push文件的时候需要输入的密码,而不是github管理者的密码,当然可以不输入密码,直接回车,那么push的时候就不需要输入密码,直接提交到github上了,如:
Enter passphrase (empty for no passphrase):
# Enter same passphrase again:
接下来,就会显示如下代码提示,如:
Your identification has been saved in /c/Users/you/.ssh/id_rsa.
# Your public key has been saved in /c/Users/you/.ssh/id_rsa.pub.
# The key fingerprint is:
# 01:0f:f4:3b:ca:85:d6:17:a1:7d:f0:68:9d:f0:a2:db your_email@example.com
看到这段代码提示时,说明你的SSH key已经创建成功,只需要添加到github的SSHkey上就可以了。
-
将SSH key添加到Github
先拷贝id_rsa.pub文件的内容,可以用编辑器打开文件复制,目录/Users/xxx/.ssh/id_rsa,xxx为你计算机用户名。
然后登陆github账号,从右上角的设置(Settings)进入,然后点击菜单栏的SSH key进入页面添加SSH key。
最后点击 Add SSH key 按钮添加一个 SSH key 。把你复制的 SSH key 代码粘贴到 key 所对应的输入框中,记得 SSH key 代码的前后不要留有空格或者回车。当然,上面的 Title 所对应的输入框你也可以输入一个该 SSH key 显示在 github 上的一个别名。默认的会使用你的邮件名称。
测试连接
ssh -T git@github.com
当输入以上代码时,会有一段警告代码,如:
The authenticity of host 'github.com (207.97.227.239)' can't be established.
# RSA key fingerprint is 16:27:ac:a5:76:28:2d:36:63:1b:56:4d:eb:df:a6:48.
# Are you sure you want to continue connecting (yes/no)?
这是正常的,输入yes回车即可。如果你创建 SSH key 的时候设置了密码,接下来就会提示你输入密码,如:
Enter passphrase for key '/c/Users/Administrator/.ssh/id_rsa':
如果用户名是正确的,你已经成功设置SSH密钥。如果你看到 “access denied” ,表示拒绝访问,那么你就需要使用 https 去访问,而不是 SSH 。
配置个人信息
git config --global user.name "gcfrun”
git config --global user.email chaofan.gong@gmail.com
修改_congfig.yml文件
deploy:
type: git
repo: git@github.com:xxxx/xxxx.github.io.git
branch: master
xxx为你的github账号名称
注册githhub,新建xxxx.github.io的repository
克隆主题
进入hexo官网,预览自己想要的主题
https://github.com/hexojs/hexo/wiki/Themes
这里拿yilia为例:
$ git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia
修改hexo根目录下的 _config.yml : theme: yilia
更新
cd themes/yilia
git pull
上传主题到github
hexo server ,访问 localhost:4000 预览效果。(退出server用Ctrl+c)
hexo deploy ,同步到github。访问网站看看效果。
注:hexo 3.0以上版本得加上
npm install hexo-deployer-git --save
到此的话,mac下hexo博客搭建,主题上传都已完成,只差写博客了。