搭建博客的艰辛历程（hexo+github）
前言
加入实验室不久就让我们搭建博客 ，有指导视频但看了一点感觉完全看不懂就没看了，自己在网上找，看朋友是怎么弄的，自己尝试摸索。别人都弄出来了，为啥我用着电脑都出问题弄不好，有一段时间几乎崩溃。我凭着强大的毅力不放弃一共搭建了有10次左右终于弄出来了。可以说所有的问题都被我遇见过（要哭死......),所以我要在这里整理我的经验，在最后面分享一下问题经验，希望能给后来人一些帮助。
一、下载软件
首先，下载Git官网 2.15.0
node.js官网8.9.0
32位或64位按自己电脑的系统来选择，如果不清楚，可以直接在官网下载32位的，可以兼容64位系统。
想要知道自己的电脑是多少位操作系统，打开“我的电脑”，在空白处单击鼠标右键，点击“属性”即可查看。
注:不同软件版本的安装与使用会有差异。曾经就遇到过因为node.js版本太低出错搭建不成功。
二、安装软件
1.安装git
- 大部分按默认安装，一路点击”Next”
image
-
这里选择对应的windows选项，如下图
image.png
image.png
-
等待安装完成
image.png
2.安装node.js
-
Node安装更加简单，还是一路”Next”,最后等待安装完成即可
image.png
image.png
三、验证软件是否正确安装
- 同时按下Win键和R键（或者点击“开始菜单”->点击“运行”）,打开运行窗口,输入“cmd”
然后输入以下命令，结果与下图相同则说明安装正确，若不正确可以卸载软件重新安装
- git --version
- node -v
- npm -v
四、申请GitHub账号
- 点击GitHub进入官网注册帐号
-
按下图分别输入用户名、邮箱、密码，然后点击注册
image.png
在这里就不多说如何注册GitHub账号了，有看不懂的英文复制粘贴翻译就好。
-
点击”New repository”，新建一个版本库
image.png
-
输入Repository name:yourname.github.io(yourname与你的注册用户名一致
image.png
image.png
*最后点击”Publish page”,发布github默认生成的一个静态站点
image.png
-
验证邮箱，点击个人设置
image.png
-
点击”Send verification Email”发送验证邮件
image.png
-
进入你的邮箱，查收验证邮件进行验证
image.png
五、安装Hexo
hexo是基于node.js的静态博客，官网也是搭建在GitHub上
-
在电脑上新建一个blog文件夹,该文件夹用于存放你的博客文件,然后右键单击选择“Git Bash”
image.png
有的是Git Bash here，是一样的，没影响。
安装hexo为了避免出现被“墙”的情况，使用淘宝NPM镜像，输入以下命令等待安装完成：
$ npm iall -g cnpm --registry=https://registry.npm.taobao.org
注意复制时不要复制"$",因为git上面已经有了
如果是第一次安装则和下图差不多,如果已安装或不确定，可以输入命令$ hexo -v看是否安装。
注意:全程都要看英文的意思,看不懂复制粘贴翻译.
image.png
- 使用淘宝NPM安装Hexo
$ cnpm install -g hexo-cli
与原先的npm完全一样，只是命令改为cnpm,一样等待hexo安装完成
image.png
- 出现的WARN可以不用理会,继续输入以下命令
$ cnpm install hexo --save
- 安装完成后，在输入命令，验证是否安装正确
$ hexo -v
image.png
六、本地运行Hexo
-
初始化hexo
image.png
- 安装生成器
$ cnpm install
*运行hexo,以后要在本地运行博客只要输入该命令即可
$ hexo s -g
image.png
*停止运行，按住Ctrl+C键即可停止
七、管理博客
配置信息
使用
编辑器（绿色软件无需安装，解压即可使用）打开blog/_config.yml文件，进行配置
image.png
#博客名称
title: 我的博客
#副标题
subtitle: 一天进步一点
#简介
description: 记录生活点滴
#博客作者
author: John Doe
#博客语言
language: zh-CN
#时区
timezone:
#博客地址,与申请的GitHub一致
url: http://elfwalk.github.io
root: /
#博客链接格式
permalink: :year/:month/:day/:title/
permalink_defaults:
source_dir: source
public_dir: public
tag_dir: tags
archive_dir: archives
category_dir: categories
code_dir: downloads/code
i18n_dir: :lang
skip_render:
new_post_name: :title.md # File name of new posts
default_layout: post
titlecase: false # Transform title into titlecase
external_link: true # Open external links in new tab
filename_case: 0
render_drafts: false
post_asset_folder: false
relative_link: false
future: true
highlight:
enable: true
line_number: true
auto_detect: true
tab_replace:
default_category: uncategorized
category_map:
tag_map:
#日期格式
date_format: YYYY-MM-DD
time_format: HH:mm:ss
#分页，每页文章数量
per_page: 10
pagination_dir: page
#博客主题
theme: landscape
#发布设置
deploy:
type: git
#elfwalk改为你的github用户名
repository: https://github.com/elfwalk/elfwalk.github.io.git
branch: master
- 写一篇文章
输入创建文章命令，生成一个md文件(/blog/source/_posts/)
$ hexo new "hello"
image.png
- 用编辑器打开hello.md文件,编写完后保存
title: hello
date: 2015-07-01 22:37:23
categories:
- 日志
- 二级目录
tags:
- hello
---
摘要:
<!--more-->
正文:
八、发布博客
配置SSH keys
我们如何让本地git项目与远程的github建立联系呢？用SSH keys。
- 生成新的SSH Key：
$ ssh-keygen -t rsa -C "邮件地址@youremail.com"
输入后，你会看到
Generating public/private rsa key pair.
Enter file in which to save the key (/Users/your_user_directory/.ssh/id_rsa):
注意1: 此处的邮箱地址，你可以输入自己的邮箱地址；
注意2: 此处的「-C」的是大写的「C」
然后系统会要你输入密码：
···
Enter passphrase (empty for no passphrase):<输入加密串>
Enter same passphrase again:<再次输入加密串>
···
在回车中会提示你输入一个密码，这个密码会在你提交项目时使用，如果为空的话提交项目时则不用输入。这个设置是防止别人往你的项目里提交内容。（我当时就没输密码，直接回车）
注意：输入密码的时候没有*字样的，你直接输入就可以了。
最后看到这样的界面，就成功设置ssh key了：
image.png
- 添加SSH Key到GitHub
在本机设置SSH Key之后，需要添加到GitHub上，以完成SSH链接的设置。
1、打开本地C:\Documents and Settings\Administrator.ssh\id_rsa.pub文件。此文件里面内容为刚才生成人密钥。如果看不到这个文件，你需要设置显示隐藏文件。准确的复制这个文件的内容，才能保证设置的成功。
2、登陆github系统。点击右上角的 Account Settings—>SSH Public keys —> add another public keys
3、把你本地生成的密钥复制到里面（key文本框中）， 点击 add key 就ok了
设置git身份信息
···
$ git config --global user.name "你的用户名"
$ git config --global user.email "你的邮箱"
···
（新建一个文本文档，复制粘贴修改成你的用户名和邮箱）
-
发布更新博客
···
$ hexo d -g
···
image.png
如果看到上面的图 Deploy done :git 说明搭建成功了
发布时会弹出一个窗口，需要输入github的帐号和密码。输入完之后过一会去浏览器查找你的网页又可以看到你的博客了。（访问yourname.github.io看下成果）
最后，也是最重要的，我在搭建过程中遇到了很多错误，在这分享一下错误以及解决方法。
1.node.js版本太低出错，英文显示要大于4.0版本
2.搭错了，删除文件后重搭建时，有的程序已走过，相应的步骤不用再弄了，不然会出现文件夹不是空的，又出错。
3在config。yml中改写时，一定要注意用户名，网站与GitHub要一样，冒号后要有一个空格，不然又会出错。
4.记得helo.md文件也要改，复制粘贴即可
5.记得要添加SSH密钥，曾经出现过not found git的情况，应该是没有添加密钥，没连接github。
6.还出现过error: Permission to userA.git denied to userB。
出现这个的原因是电脑上的SHH公钥已经被另一个账户使用，你没有权限。或者是你改用户名了。处理方法是打开电脑Control Panel(控制面板)——>User Account and family Safety(用户账号和家庭安全)——>Manage Windows Credential(凭证管理)——>将跟Git有关的账号删除
然后重新发布。
我搭建博客的过程大致就这样吧，写在这里回头看时又是一番感慨，佩服自己，唉。
