网上有很多教程,也比较详细,但是真的操作起来还是有蛮多问题的,准备细细写一下自己的步骤和遇到的问题搜索到的答案。内容雷同部分,纯属学习交流,敬请见谅,参考但不限于下面的几个文档和教程:
正文开始
一、安装应用程序
安装主要的应用程序有三个: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