github+hexo搭建个人博客

1.搭建前的准备工作

有一个github的账号

安装了git for windows

安装node.js、npm

这些软件直接安装最新版的就可以。

2.创建仓库

在github上创建一个名为username.github.io的仓库，其中username就是你的github上的用户名。当搭建步骤完成之后你就可以直接访问 https://username.github.io 来访问你的博客了。

3.配置SSH key

因为提交代码的时候需要拥有github上的权限，因此需要采用ssh key解决本地和服务器之间的连接问题。在git bash（一个在Windows下使用linux命令行的terminal）上先检查本机是否已经存在的ssh key。

1	$ cd ~/.ssh

若提示：No such file or directory 说明这是你第一次使用git。

1	$ ssh-keygen -t rsa -C "邮件地址"

输入命令后需要三次回车，最终会在你的电脑的用户目录下生成一个文件夹，找到.ssh/id_rsa.pub文件，用记事本打开后复制里面的内容，然后打开你的github主页，进入个人设置中的SSH and GPG keys，在New SSH key中填写一个title，然后将复制的SSH key粘贴到key那里就可以了。

然后在git bash上：

1	$ ssh -T git@github.com

当提示Are you sure you want to continue connecting (yes/no)?，输入yes就会看到Hi username！巴拉巴拉的，说明你已经配置成功了SSH。

之后还需要再配置一下name和email。

1 2	$ git config --global user.name "username" //这里引号中的是你的github的name $ git config --global user.email "xxx@163.com" //这里引号中是你之前绑定的邮箱

4.使用hexo写博客

hexo是一个简单、快速、强大的基于Github Pages的博客发布工具，支持Markdown，有许多优秀的插件和主题。

4.1 安装

在git bash上：

1	$ npm install -g hexo

4.2 创建hexo工作空间

在你的磁盘上创建一个hexo文件夹（名字随意），这个文件夹就是将来写博客和存放代码的地方，因此最好选定好位置（我的是f盘上的hexo-github文件夹）。然后在git bash上：

1 2	$ cd /f/hexo-github/ $ hexo init

hexo会自动下载文件到这个目录中，里面包括了source，theme等文件。然后在git bash上：

1 2	$ hexo g #genereat，这个类似编译生成 $ hexo s #server,启动本地服务，开启后可以访问http://localhost:4000，就可以看到博客界面

4.3 修改主题

官方的默认主题比较丑，因此可以换一个主题，我选择是hexo-theme-yilia。下载这个主题：

1 2	$ cd /f/hexo-github/ $ git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia

主题下载后在themes下，之后修改hexo-github下（不是你下载的主题下）的_config.yml，将里面的theme: landscape 改为 theme: yilia。需要注意这里属性的修改在冒号后面都是有空格的，很多时候达不到你想要的效果就是因为这个原因，查看一下是否忘记空格了。修改完之后直接执行hexo g重新生成。要是还有一些问题，可以先clean一下，使用 hexo clean命令，然后重新生成和发布。

4.4 上传到github

之前都是部署在本地，现在需要将自己的博客上传到外网，即github上。首先要进行一些上传前的配置。

首先安装一个插件：

1	$ npm install hexo-deployer-git

然后在hexo-github文件夹下配置_config.yml中有关deploy部分：

deploy:
  type: git
  repository: git@github.com:liuyu-code/liuyu-code.github.io.git
  branch: master

之后你就可以使用hexo d将所有有改动的部分提交到github上。

5.常见hexo命令

hexo new "postName" 		#新建文章
hexo new page "pageName"	#新建页面
hexo generate 			#生成静态页面至public目录
hexo server 			#开启预览访问端口（默认端口4000，'ctrl + c'关闭server）
hexo deploy 			#部署到GitHub
hexo help  			# 查看帮助
hexo version  			#查看Hexo的版本

缩写：

hexo n == hexo new		#后者等价于前者
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy

组合命令：

1 2	hexo s -g #生成并本地预览 hexo d -g #生成并上传

6.写博客

首先定位到hexo的工作根目录，在git bash中执行命令：

1	hexo new 'my_first_blog'

hexo会在_posts下生成相关md文件，只需要我们打开这个文件就可以开始写博客了，写博客需要掌握一些markdown的基本语法规则，一开始我采用的Notepad++这个软件来写的，后来发现一个更好用的博客编辑工具Typora，相比记事本来说，实在是鸟枪换炮了，这个软件真的好用，强烈推荐。