使用Hexo+Github搭建属于自己的博客（基础）

前言

hexo是一个台湾人做的基于Node.js的静态博客程序，优势是生成静态文件的速度非常快，支持markdown，我最终选定它的原因是它速度快而且不容易出错，并且可以一键部署到github或者其它静态服务器上去。折腾了一天总算搞定。江湖小剑客

环境：window10，nodejs(v8.10.0)，git(version 2.15.1.windows.2)，hexo

环境准备

1、安装Node.js和配置好Node.js环境，打开cmd命令行，成功界面如下

C:\Users\liquan>node -v

v8.10.0

C:\Users\liquan>npm -v

5.6.0

2、安装Git和配置好Git环境，安装成功的象征就是在电脑上任何位置鼠标右键能够出现如下两个选择

注意：一般出于安全考虑，只有在Git Bash Here中才能进行Git的相关操作。如果需要在cmd命令行里调用Git，那么就要配置电脑的环境变量Path，或者在安装的时候选择use Git from the Windows Command Prompt。这个可有可无，影响不大，成功配置的界面如图

C:\Users\liquan>git --version

git version 2.15.1.windows.2

3.安装Hexo，在自己认为合适的地方创个文件夹，我是在E盘建了一个hexo文件夹。然后通过命令行进入到该文件夹里面

C:\Users\liquan>e:

E:\>cd hexo

E:\hexo>

输入 npm install hexo -g ，开始安装Hexo，如下则表示安装完成

输入 hexo -v ，检查hexo是否安装成功

E:\hexo>hexo -v

hexo: 3.6.0

hexo-cli: 1.1.0

os: Windows_NT 10.0.16299 win32 x64

http_parser: 2.7.0

node: 8.10.0

v8: 6.2.414.50

uv: 1.19.1

zlib: 1.2.11

ares: 1.10.1-DEV

modules: 57

nghttp2: 1.25.0

openssl: 1.0.2n

icu: 60.1

unicode: 10.0

cldr: 32.0

tz: 2017c

输入 hexo init ，初始化该文件夹（有点漫长的等待。。。）

输入 npm install ，安装所需要的组件

输入 hexo g ， hexo s 首次体验Hexo

然后用浏览器访问http://localhost:4000，此时，你应该看到了一个漂亮的博客了，当然这个博客只是在本地的，别人是看不到的，hexo3.0使用的默认主题是landscape。

发布到github上面

首先你得有github账号，如果没有就去注册个，很简单的步骤。

创建repository

repository相当于一个仓库，用来放置你的代码文件。登陆进入Github，并进入个人页面，选择repositories，然后New一个repository。创建时，只需要填写Repository name即可。格式必须为yourGitHubname.github.io，比如我的是noobgod.github.io

设置Git的user name 和email（如果是第一次的话）

上图是上面创建的e://hexo文件夹里面鼠标右键，点击Git Base Here。这里“feng”可以替换成自己的用户名，邮箱可以替换成自己的邮箱

如果你是第一次使用Github或者是已经使用过，但没有配置过SSH，则可能需要配置一下SSH。在Git Bash输入以下指令（任意位置点击鼠标右键），检查是否已经存在了SSH keys。

1.输入cd ~/.ssh，检查是否由.ssh的文件夹

2.输入ls，列出该文件下的内容。下图说明存在

3.输入 ssh-keygen -t rsa -C “@qq.com” ，连续三个回车，生成密钥，最后得到了两个文件：id_rsa和id_rsa.pub（默认存储路径是：C:\Users\Administrator\.ssh）。

4.输入 eval "$(ssh-agent -s)" ，添加密钥到ssh-agent

5.再输入 ssh-add ~/.ssh/id_rsa ，添加生成的SSH key到ssh-agent

6.键入以下指令，拷贝Key（先拷贝了，等一下可以直接粘贴，不放心的在执行下面命令后，先黏贴在记事本上）：

clip < ~/.ssh/id_rsa.pub

7.登录Github，点击头像下的settings，添加ssh

8.新建一个new ssh key，将id_rsa.pub文件里的内容复制上去，Ttile随便你命名，Key就黏贴上你刚才复制的key，然后点Add SSH key，最后会让你重新输入下gitHub的密码最后还是测试一下吧，键入以下命令：

9.输入 ssh -T git@github.com ，测试添加ssh是否成功。如果看到Hi后面是你的用户名，就说明成功了

问题：假如ssh-key配置失败，那么只要以下步骤就能完全解决

首先，清除所有的key-pair
ssh-add -D
rm -r ~/.ssh
删除你在github中的public-key

重新生成ssh密钥对
ssh-keygen -t rsa -C "xxx@xxx.com"

接下来正常操作
在github上添加公钥public-key:
1、首先在你的终端运行 xclip -sel c ~/.ssh/id_rsa.pub将公钥内容复制到剪切板
2、在github上添加公钥时，直接复制即可
3、保存

测试：

在终端 ssh -T git@github.com

10. 先修改D:\hexo下的_config.yml文件,记得一点，hexo的配置文件中任何’:’后面都是带一个空格的

deploy:

  type: git

  repository: git@github.com:noobgod/noobgod.github.io.git

  branch: master

repo值是你在github项目里的ssh（右下角）

我刚开始是部署到github上面，现在我部署到自己的腾讯云主机上面去了，原理都一样，在腾讯云主机上面创建一个git服务即可。然后上面的repository改成自己的git服务器地址。

生成文章

1.在生成以及部署文章之前，需要安装一个扩展：

npm install hexo-deployer-git --save

2.新建一篇博客，在cmd执行命令：hexo new post “博客名”

E:\hexo>hexo new "hello-Hexo"

INFO  Created: E:\hexo\source\_posts\ceshi6.md

这时候在文件夹_posts目录下将会看到已经创建的文件,通过markdown工具打开，就可以编辑了

3.使用编辑器编好文章，那么就可以使用命令： hexo d -g ，生成以及部署了

部署成功后访问你的地址：http://用户名.github.io。那么将看到生成的文章

删除文章

删除文章，进入 /source/_posts目录下，通过右键删除想删除的文章，然后执行命令：

hexo d -g

好了，到此为止，最基本的也是最全面的hexo+github搭建博客完结。接下来是进阶的操作

参考列表：1.使用hexo搭建github博客

2.使用Hexo+Github一步步搭建属于自己的博客（基础）

3.使用Hexo+Github一步步搭建属于自己的博客（进阶）