明明1个小时就可以建好的博客,这次上手操作却花了3天。每天都会遇奇葩的bug,庆幸自己能将它们一一击破。
我不懂代码,只知道Hexo+Github搭的博客很好用。大概去年这个时候,在某个朋友的介绍下,初次了解到Hexo,在他的协助下完成了部署,后续的主题、插件和域名都是我自己摸索着完成的。
其次这个博客早就想搞了,可惜一直忙于工作和换服的琐事,现在离职后才静下心来操它。thebravelegend.com是在2016年12月31日申请的域名,我称之为勇者传说,寓意17年的新人生,用来记录东京生活的点滴。说来有点惭愧啊,半年后才将它用上。
前戏差不了,咱们切入正题,说说这次在搭建Hexo中遇到的问题:1、无法deploy到Github;2、部署成功后打开网站404;3、绑定域名后打开网站空白。3天踩了3个坑,真让人累觉不爱啊,至于避免和解决的方法,将在下面搭建教程中提到。
本文高潮部分,如何正确用Hexo搭建博客?我是在Mac环境下操作的,仅供参考!
1.安装Git
在AppStore下载安装Xcode即可。
2.安装Node.js
官方下载地址:https://nodejs.org/。
3.安装Hexo
在终端执行命令:sudo npm install -g hexo,安装成功。
4.本地博客查看
创建网站所需的目标文件夹(名字任意),在终端输入cd /文件夹路径就可以在该目录下执行命令。继续执行命令:hexo init和npm install,本地的Hexo博客搭建完成。再执行命令:hexo g和hexo s,就可以在浏览器输入http://localhost:4000查看效果。
5.在GitHub创建repository
到http://www.github.com注册账号,创建new repository,Repository name一定要和用户名相同。比如用户名是yourname,那么Repository name就填yourname.github.io。
6.设置Git的user.name和user.email
在终端执行命令:npm install hexo-deployer-git --save,第一次使用Git时,你需要告诉你的协同开发者,你是谁以及你的邮箱,再通过以下2个命令设置个人信息:git config --global user.name xxx和git config --global user.email xxx@xx.com,这里的name和mail与github完全无关。
7.配置SSH keys
在终端执行命令:ssh-keygen -t rsa -C 邮件地址,邮件为你github账号,直接回车就好,密码为空。新建Finder窗口按下cmd+shift+G,输入~/.ssh,找到id_rsa.pub文件,用文本打开复制里面的代码。打开GitHub的setting界面,点击Add SSH key,将复制的代码粘贴进去,Title随便填写。
8.修改_config.yml
编辑博客目录下的_config.yml,修改Deployment部分:
deploy:
type: git
repository: https://github.com/yourname/yourname.github.io.git
branch: master
9.部署
在终端执行命令:hexo d,根据提示输入Github用户名和密码,完成部署。
10.访问测试
在浏览器访问http://yourname.github.io,就可以看到自己的博客啦!
到此Hexo的基础博客已经搭建完毕,后续可根据个人需求来安装主题和插件,我将在下一篇中详述。
Tips: 务必按照这个流程来搭建和部署。这次踩过Hexo的3大坑,这辈子都不会忘记。
1、无法deploy到Github
不要把github的repository克隆到博客目录,这样会导致无法deploy。
2、部署成功后打开网站404
本地博客搭建好,不要急着安装主题,应该先部署到Github后再装。
3、绑定域名后打开网站空白
我的域名是在Godaddy买的,用namecheap解析DNS一直打不开网站,后来换dnspod解决了这个问题。