利用hexo、gitbub、node.js以及git客户端搭建个人博客,在此总结记录一下,方便以后用到。
环境部署:
安装node.js
安装git客户端
下载地址:https://git-scm.com/download
安装方式都是默认,建议安装的目录都是采用英文的全路径。
安装hexo
在任意位置右击鼠标选择Git Bash Here进入命令行,输入hexo的安装命令:
npm install -g hexo
在D:\tools下新建hexo文件夹,进入hexo文件夹,右击鼠标选择Git Bash Here进入命令行,输入hexo初始化命令:
hexo init
;安装依赖包:npm install
;(会在当前hexo文件夹内生成很多hexo的配置文件和配置文件夹)- 继续输入命令:
hexo g
(hexo g #完整命令为hexo generate,用于生成静态文件) - 继续输入命令:
hexo s
(hexo s #完整命令为hexo server,用于启动服务器,主要用来本地预览)
本地已经搭建好了一个基于hexo的博客,根据提示输入http://localhost:4000即可访问,可能会出现一直加载问题,请看底端遇见的问题解决。终止是用ctrl+c命令。
以上是本地部署的,只有本地才能访问,如何才能在互联网上访问呢,需要把hexo发不到GitHub上去。
首先必须得有GitHub账号,这里就不展示GitHub的注册了,默认已有GitHub的账号。
创建repository
上图是因为我已经创建了一个hushen8023.github.io的项目,所以报错的。
编辑hexo文件夹下的_config.yml文件,参照下图
如果你是第一次使用Github或者是已经使用过,但没有配置过SSH,则可能需要配置一下:在Git Bash输入以下指令(任意位置点击鼠标右键:ls -al ~/.ssh
),检查是否已经存在了SSH keys。
如果不存在就没有关系,如果存在的话,直接删除.ssh文件夹里面所有文件:
在Git Bash命令行中继续输入指令:
ssh-keygen -t rsa -C "szys_hs@126.com"
(注意:后面部分为你GitHub的邮箱,而且出现提示让你输入的时候直接先回车,好像需要3次)
继续命令行:
ssh-agent -s
继续命令行:
ssh-add ~/.ssh/id_rsa
(输入之后,我这边出错了,不知道你出错没)
如果出错了,请输入以下指令:eval ssh-agent -s ssh-add
操作到这一步,基本上是完成了,接下来就是添加SSH key到GitHub账户中去,输入指令:clip < ~/.ssh/id_rsa.pub
(注意,输入完指令之后,表示已经拷贝,直接可以ctrl + v粘贴即可),在setting中的这个SSH keys的title随便取
测试:输入指令:
ssh -T git@github.com
以上就表示SSH配置好了,执行以下命令部署到Github上。执行指令:
hexo g
(hexo g #完整命令为hexo generate,用于生成静态文件)执行指令:
hexo d
(hexo d #完整命令为hexo deploy,用于将本地文件发布到github上)
安装指令:
npm install hexo-deployer-git –save
安装完成之后,继续执行hexo d
访问连接,比如我的hushen8023.github.io
发表文章:
- 在Git Bash下输入命令:
hexo new “my new post”
(会在hexo文件夹下比如我:D:\tools\hexo\source_posts文件夹下生成一个my-new-post.md文件); - 编辑这个新生成的文件,推荐使用Markdownpad工具编辑;
- 写完文章后,你可以使用
$
hexo g
生成静态文件。
$
hexo s
在本地预览效果。$
hexo d
同步到github
遇见的问题:
- 安装完node.js、git和hexo完,输入http://localhost:4000一直在加载,就是出不来hexo的页面,在网上查阅了很多资料,显示4000的端口可能被占用,可以修改端口:
hexo server -p 8888
然后就成功了。 - 把本地hexo部署到github上去访问时出现问题,一直404;如下图
解决方案:
在github上新建Repositories的时候,Repository name的值必须是
github的账号名.github.io
的格式,比如我:hushen8023.github.io
拷贝完密钥到github之后,需要在邮件中确认重新登陆的。
检查在github中生成的hexo的目录结构是否完整
如果还未解决,等上10分钟左右,一般需要解析下。访问:http://hushen8023.github.io/即可
3.中间更换过一次电脑,所以环境什么的都得重新安装,幸亏hexo文件夹可以直接拷贝过来,不然的话里面很多的配置和文章都得重新整。在安装完之后还需要重新的把本地的git和github联系起来,需要按照这个文档走一遍,把ssh文件和github上的sshkeys绑定。中间就碰到这个问题,问题的原因是本地的git没有设置用户配置。
分别用 这两条命令:
$ git config --global user.name "name"
$ git config --global user.email your_mail@gmail.com
hexo指令总结
hexo c
#hexo clean 清除缓存hexo s
#启动本地服务hexo g
#生成静态文件hexo d
#部署到GitHub上去hexo server - p 8888
#更改端口,本地测试hexo n
“新文章” #hexo new “新文章”hexo new page tags
#创建一个标签云hexo new page about
#创建关于我
参考文献
http://moxfive.coding.me/yelee/
http://tengj.top/2016/02/22/hexo1/