hexo+github搭建个人博客


利用hexo、gitbub、node.js以及git客户端搭建个人博客,在此总结记录一下,方便以后用到。

环境部署:

安装node.js

下载地址:https://nodejs.org/en/

安装git客户端

下载地址:https://git-scm.com/download

安装方式都是默认,建议安装的目录都是采用英文的全路径。

安装hexo

  1. 在任意位置右击鼠标选择Git Bash Here进入命令行,输入hexo的安装命令:npm install -g hexo

  2. 在D:\tools下新建hexo文件夹,进入hexo文件夹,右击鼠标选择Git Bash Here进入命令行,输入hexo初始化命令:hexo init;安装依赖包:npm install;(会在当前hexo文件夹内生成很多hexo的配置文件和配置文件夹)

  3. 继续输入命令:hexo g(hexo g #完整命令为hexo generate,用于生成静态文件)
  4. 继续输入命令: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

发表文章:

  1. 在Git Bash下输入命令:hexo new “my new post”(会在hexo文件夹下比如我:D:\tools\hexo\source_posts文件夹下生成一个my-new-post.md文件);
  2. 编辑这个新生成的文件,推荐使用Markdownpad工具编辑;
  3. 写完文章后,你可以使用

    $ hexo g生成静态文件。

$ hexo s在本地预览效果。

$ hexo d同步到github

遇见的问题:

  1. 安装完node.js、git和hexo完,输入http://localhost:4000一直在加载,就是出不来hexo的页面,在网上查阅了很多资料,显示4000的端口可能被占用,可以修改端口:hexo server -p 8888

    然后就成功了。
  2. 把本地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指令总结

  1. hexo c #hexo clean 清除缓存
  2. hexo s #启动本地服务
  3. hexo g #生成静态文件
  4. hexo d #部署到GitHub上去
  5. hexo server - p 8888 #更改端口,本地测试
  6. hexo n “新文章” #hexo new “新文章”
  7. hexo new page tags#创建一个标签云
  8. hexo new page about#创建关于我

参考文献

http://moxfive.coding.me/yelee/

http://tengj.top/2016/02/22/hexo1/

http://blog.csdn.net/imail2016/article/details/51762873

http://www.voidking.com/2016/05/13/deve-gitcafe-to-coding/

文章目录
  1. 1. 环境部署:
    1. 1.1. 安装node.js
    2. 1.2. 安装git客户端
  2. 2. 安装hexo
  3. 3. 发表文章:
  4. 4. 遇见的问题:
  5. 5. hexo指令总结
  6. 6. 参考文献
|