在Github上搭了Hexo博客(MAC版)

2018.10.31 00:23

网上有很多教程,也比较详细,但是真的操作起来还是有蛮多问题的,准备细细写一下自己的步骤和遇到的问题搜索到的答案。内容雷同部分,纯属学习交流,敬请见谅,参考但不限于下面的几个文档和教程:

正文开始

一、安装应用程序

安装主要的应用程序有三个:Node.js、Git、Hexo。
但是在安装Hexo之前,先确保电脑中已经有了前两项。

1.1 Node.js

进入官网直接下载,根据建议我选择了8.11.3 LTS。

1.2 Git

使用$ git version的命令查看git版本,从而确认是否安装,如果安装则会反馈git版本。如果不是显示“git version xxx",那么就要考虑怎么安装了。

git的安装方式也有很多种,例如官网文档中所给出的:

用Homebrew安装git我弄了很久都不行,最后发现是网络问题。所以可能使用直接下载的方式会更方便。

1.3 安装Hexo

确保安装完Node.js和Git之后,我们就可以简单地在终端使用命令即可安装hexo了。
安装命令:

$ npm install -g hexo-cli

二、本地文件管理

在当前用户登陆的账户下创建一个名为hexo的文件夹
手动创建一个在当前账户内的三级目录 /用户名/blog/hexo;

$ cd /Users/你的用户名/blog/hexo
$ npm install 

执行完毕之后会出现原先空的文件夹会有文件出现。
这个时候可以在本地进行通过执行hexo -g生产public静态资源文件,再执行hexo -s启动本地服务器。接着在浏览器中输入http://localhost:4000,即可看到hexo默认的主题效果。

三、在Github上部署博客

3.1 注册账号,建立仓库

这里要注意两点:
1)虽然之后username可以在Setting-Account中进行修改,但是如果开始的时候想好,就是最好的,因为这个和后面部署的博客的域名有直接关系;
2)创建的仓库repository必须与username匹配,例如用户名为abc,那么创建的仓库名则需要为abc.github.io。否则可能就会出现问题。

3.2 配置SSH公钥

远程代码是基于SSH的,所以需要SSH的相关配置。方法是现在本地生成SSH公钥,然后添加到Github上面。具体的操作如下:
(1)设置你的邮箱和用户名:

git config --global user.email "abc@qq.com"  #登陆邮箱
git config --global user.name "abc"  #用户名

(2)生成密钥,设置密码,输入的密码不显示(也可以不设置,按三次回车,密码为空)

ssh-keygen -t rsa -C "abc@qq.com" 

上述的命令成功后,会得到id_rsa和id_rsa.pub两个文件,一般出现在“Users/你的用户名”这个文件夹下。如果找不到,就把显示隐藏文件这个功能打开(可以使用快捷键 command+shift+.

(3)把SSH密钥添加到Github上
登陆Github后,点击settings,然后进入SSH keys,把id_rsa.pub文件里内容添加进去就好了。

3.3 部署远程博客

编辑Users/你的用户名/blog/hexo目录下的配置文件_config.yml,在最下面输入以下内容,注意把里面的abc替换成你的用户名

deploy:
  type: git
  repository: https://github.com/abc/abc.github.io.git
  branch: master

保存关闭之后,输入以下命令

hexo -g
hexo -d

如果出现以下提示则表述部署成功。静等一段时间之后,就可以在浏览器输入abc.github.io进行访问了。

INFO Deploy done: git

四、Hexo的基本命令与Tips

hexo g = hexo generate  #生成
hexo s = hexo server  #启动本地预览
hexo d = hexo deploy  #远程部署
hexo n "文章标题" = hexo new "文章标题"  #新建一篇博文

hexo s -g  #等同先输入hexo g,再输入hexo s
hexo d -g  #等同先输入hexo g,再输入hexo d

注意一定要验证Github的验证邮件。
出现其他任何的问题,先删除博客目录下的db.json文件,然后清理再部署远程博客,操作时输入以下的命令。

hexo clean
hexo d -g
Comments
Write a Comment