Hexo+GitHub搭建博客

一直想要尝试搭建个人博客，在搜索方法的过程中，知道了可以通过GitHub+Hexo的方法搭建，便尝试着做做。虽然教程说的是20分钟搭建好，但我却用了一个下午，囧。

 

搭建过程中主要遇到了以下三个问题：

1. 安装了Git与Node.js后，在Git Bash中输入 npm install -g hexo-cli 安装Hexo时，发生错误：bash: npm: command not found。搜索了一下，重装Node.js，仍然不行，接着再重装Git，在cmd中输入 node -v 和 npm -v 以及 git -v 均显示对应版本号，证明已经安装成功。最后发现，原来是在重装后没有重启，重启后便能按照正常顺序成功安装Hexo。看到安装成功的窗口，才发现我竟然花了那么长时间。

2. 打开 http://localhost:4000/ 进行本地预览时，页面无响应。后来通过输入 npm install hexo-server --save 得到解决，原因是需要先安装server。

3. 在输入 Hexo deploy 准备部署到网上时，出现了以下一些错误：
- ERROR Deployer not found: git
  解决：输入 npm install hexo-deployer-git –save 再注销一下，但又出现下一个错误：
- fatal: could not read Username for 'https://github.com': no error
- 解决：把 deploy 的 repo 改为SSH地址（参考了 这里）修改。

 

简单回顾安装步骤：

1. 安装 Node.js

2. 安装 Git

3. 注册 GitHub：点击右上角 New 创建仓库（repository），仓库名格式：yourname.github.io

4. 生成SSH密匙：ssh-keygen -t rsa -C "你的邮箱地址"

在C:\Users\Administrator.ssh下找到生成的id_rsa.pub，打开复制全文，粘贴到 Add SSH key 。

5. 安装Hexo：在文件夹中打开Git Bash，输入 npm install -g hexo-cli 。
可以再通过输入 hexo 查看是否安装成功。

6. 建站：
hexo init <folder>     // 新建网站存放的文件夹
cd <folder>              // 进入文件夹
npm install               // 配置依赖包
hexo new "文章标题"  // 新建一篇文章（也可以到 source/_posts 里手动创建）。

7. 配置：
在  _config.yml 文件中修改一些配置（使用 sublime text 或其它打开）：

# Site
title: 网站标题
subtitle: 网站副标题
description: 网站描述
author: 您的名字
language: 网站使用的语言
timezone： 网站时区。（Hexo 默认使用您电脑的时区）时区列表，比如说：America/New_York, Japan, 和 UTC 。

# URL
url: http://yoursite.com/

# Deployment
deploy:
    type: git
    repo: 刚才新建的github仓库地址.git
    branch: master

注意：冒号后要空一格

8. 本地预览：
npm install hexo-server --save  // Hexo 3.0 把服务器独立成了个别模块，必须先安装 hexo-server 才能使用。
hexo server

9. 部署博客到网页：
hexo deploy

最后在浏览器地址栏输入网址，就可以看到在线的博客啦。效果例如 我的博客

 

参考资料：
Hexo文档
手把手教你建github技术博客
20分钟教你使用hexo搭建github博客

 

==更新1======

更新后想要部署到网上时发生错误：

Error: fatal: Not a git repository (or any of the parent directories): .git

解决：

git config --global user.name "用户名"

git config --global user.email "邮箱地址"

再使用  hexo clean 清楚缓存，重新部署就可以了。