用hexo搭建github博客详细全图解

1.node.js下载安装

一路默认，默认安装在C盘，安装完成之后cmd中输入
node -v查看是否安装成功和相应版本

2.git下载安装

按照下图进行选择，将会使得Git安装程序在系统PATH中加入Git的相关路径，使得你可以在CMD界面下调用Git，不用打开Git Bash了。

检查一下Git是不是安装正确了，打开命令行，输入：

3.github账户的注册和配置

• 注册很简单，就用户名+邮箱+密码，然后邮箱验证哈，注意的是给自己取一个方便记住的用户名！
• 配置：

3.1创建代码库

选择New repository

在Repository name下填写yourname.github.io，Description (optional)下填写一些简单的描述（不写也没有关系），如图所示：

3.2 代码库设置

正确创建之后，你将会看到如下界面：

点击界面右侧的Settings，你将会打开这个库的setting页面，向下拖动，直到看见GitHub Pages，如图：
这里我们需要点击Choose a theme任意选择一个选择主题，然后界面会跳转到仓库，我们看到有两个文件如下：

此时若再查看setting，我们会看到开启GitHub Pages之后得到的域名如下：

我们就可以使用，访问自己的博客网站了

4.安装和配置Hexo

4.1安装

在E盘或者其他盘的根目录下新建一个名为hexo的文件夹

右键单击，单击Git Bash Here,打开git命令窗口中输入以下命令：
npm install hexo-cli -g

至此出现第1个问题：

npm WARN engine hexo-fs@0.2.3: wanted:{"node ":">=6.9.0"}(current:{"node":"4.2.3","npm":"2.14.7"})

提示node的版本不够，所以前面提示大家要安装比较新的版本！重新去官网下载然后安装！

现在再来查看版本已经是v10.2.0

,然后再次
npm install hexo-cli -g
19.png

至此出现第2个问题：

npm WARN notsup SKIPPING OPTIONAL DEPENDENCY: Unsupported platform for fsevents@1.2.4: wanted {"os":"darwin","arch":"any"} (current: {"os":"win32","arch":"x64"})

别人的图.png 我的图.png

4.2配置

初始化hexo init

目录是刚刚创建的hexo目录下！即/e/hexo

21.png
再次查看，仍旧没有hexo:(如果你的有，请略过下面新建文件夹的步骤)
err2.png
于是，在E盘重新建了一个文件夹HexoBlog,这个文件夹用来写后面需要发布的markdown文件，前面的hexo文件夹就当做安装目录吧！
切换到cd /e/HexoBlog

然后接下来

初始化hexo init

安装插件npm install

提前安装好应有的插件！不然可能后面会报错！

生成hexo g

在浏览器中打开，你将会看到：

到目前为止，Hexo在本地的配置结束。

5.将Hexo与github page 联系起来

5.1配置git

继续在/e/HexoBlog目录下，输入

git config –-global user.name “Tidy1993”  //(“”的账号是刚才Github里面自己注册的账号)   
git config –-global user.email  //(""的邮箱是你自己注册的邮箱)  

5.2配置和测试SSH

然后，切换到

cd ~/.ssh   
ssh-keygen -t rsa -C  //打自己的邮箱  

按照下图，回车，然后输入自己登陆github的密码两次，直到生成图示

去到C盘找到.ssh文件夹，打开id rsa.pub文件，复制里面代码




把刚刚粘贴的密码粘贴到上面key中，点击Add SSH key
测试ssh设置是否成功
ssh -T
image.png

5.3 配置Deployment

手动找到/e/HexoBlog目录下的_config.yml文件，然后右键点击，打开文件

在文件最后deploy：这里加上下面代码

deploy:
  type: git
  repo: 
  branch: master

我的用户名是Tidy1993上面的yourname改成你自己的

6.写第一篇博客，同步到github

继续在/e/HexoBlog目录下输入
hexo new post "article title"

然后在对应的目录下，会生成对应的.md后缀的文件

我还没用markdown的编辑器，暂时用notepad打开文件，然后前面---之间的内容不能删，title就是一会儿显示在github上的title,后期可以改，然后在第二个---之后键入内容，要用markdown语法！完了之后保存！

回到git命令行中，输入

hexo g   // 生成
hexo s   // server

在浏览器输入：localhost:4000在本地查看刚刚新建的md文件，在此可以看到已经在本地了
38.png
回到git命令行中，输入

hexo d  // develop部署

• 如果这里运行 hexo d之后出现错误
  ERROR Deployer not found: git
  安装这个插件！
  npm install --save hexo-deployer-git
  正确运行的话会提示输入github密码
  
  正确之后会显示如下，表示成功同步到github帐号
  
  在浏览器输入：https://tidy1993.github.io对应的github域名，就可以看到效果啦！
  
  至此，终于有自己的github帐号并且有博啦！开心！虽然过程挺痛苦的！

总结一下出现的问题：

• 问题1：

npm WARN engine hexo-fs@0.2.3: wanted:{"node ":">=6.9.0"}(current:{"node":"4.2.3","npm":"2.14.7"})
提示node的版本不够，所以前面提示大家要安装比较新的版本！重新去官网下载然后安装！

• 问题2：

npm WARN notsup SKIPPING OPTIONAL DEPENDENCY: Unsupported platform for fsevents@1.2.4: wanted {"os":"darwin","arch":"any"} (current: {"os":"win32","arch":"x64"})

• 问题3：

如果输入hexo -v没能出现对应版本提示，新建个文件夹，记得在对应的目录下

npm install hexo-cli -g
npm install hexo --save
hexo -v
hexo init
npm install
hexo g
hexo s

• 问题4：

配置完git,记得配置SSH，在ssh配置时输入的密码是你登录github的密码，不要自己又重新设一个密码！

• 问题5：

配置development的时候，在自己建立的hexo文件夹下面找_config.yml文件，因为我先后建立了两次文件夹，所以我就改了两次，讲道理，应该只有hexo一个文件夹，下面需要改

• 问题6：

新建一个博客，必须在命令行中取名字，不能写好.md文件放在目录下而不执行
hexo new "article title"
完了之后必须
hexo g
hexo d
hexo s不是必须的，只是为了在同步上去github之前在本地浏览一下是否合适，如果觉得没问题，可以忽略这一步，直接g和d.