Github 结合 Hexo 搭建轻量博客

http://www.open-open.com/lib/view/open1481532171287.html

开始

Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown（或其他渲染引擎）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。

也有很多此类的文章了，不过还是要记录一下，分享给大家，我自己也做个复习。我也是不久前才弄好 ^_^

工具准备

1.安装Node.js

2.安装Git

安装过程就不说了，估计没有不会的。

3.注册Github帐号

点击进入 Github ，注册帐号（用户名关系到博客以后的域名前缀）。

安装Hexo

安装完上述程序，就可以进行Hexo的安装了。

打开命令行，输入安装命令：

npm install hexo-cli -g

等待完成，安装 Hexo 后，依次执行下列命令，Hexo将会在指定文件夹中新建所需要的文件。

folder（不用打[]）是你新建的文件夹名称，用于存放博客的所有文件。

默认安装在你打开的命令行默认所在的目录，可以切换至其他目录进行安装。

hexo init [folder]

cd [folder]

npm install

比如我把目录切换到D盘进行安装。

列出一个目录，看见下面这句话，就说明安装成功了。

可以打开电脑看一下目录结构。

执行下面命令，生成网站（public文件夹）：

hexo g

结果如下：

执行下面命令，运行服务，就可以在浏览器中访问了，地址为： http://localhost:4000 ：

hexo s

如果遇到 hexo s 无效或者错误，可能是因为没有安装hexo server，执行下面命令，然后再试：

npm install hexo-server --save

浏览器查看（这就是安装好的模样，这是默认主题，可以添加新的主题）：

但是现在我们只能在我们本地的电脑上面浏览，别人无法看见，我们还需要将它部署到Github上面。这样就可以让别人访问了。

hexo 基本命令，先了解，后面会用到。

hexo g   #完整命令为hexo generate,用于生成静态文件

hexo s   #完整命令为hexo server,用于启动服务器，主要用来本地预览

hexo d   #完整命令为hexo deploy,用于将本地文件发布到github上

hexo n   #完整命令为hexo new,用于新建一篇文章

hexo clean   #清除生成的文件

部署

新建仓库（New repository）

登录到你的Github帐号，在右上角+号点击新建。

填写信息。格式为：你的用户名.github.io。然后创建。

配置网站信息

打开你的文件夹，找到 _config.yml 文件，打开它。最开始和最后。

默认可能会没有repo和branch选项，我们要手动写上。

repo: 地址为下图中的地址。替换成你的就可以。

Github 默认分支是 master。

暂时修改这些信息就可以。

# Site

title: Hexo #网站标题

subtitle: #副标题

description: #描述

author: zgm #作者，你的名字

language: zh-Hans #设置语言 zh-Hans为中文

timezone: #时区 默认使用电脑的时区

# Deployment

## Docs: https://hexo.io/docs/deployment.html

deploy:

  type: git

  repo: https://github.com/你的用户名/你的用户名.github.io.git

  branch: master

设置Git

在Git Bash输入以下指令（任意位置点击鼠标右键），检查是否已经存在了SSH keys。

ls -al ~/.ssh

如果不存在就没有关系，如果存在的话，可以直接删除.ssh文件夹里面所有文件。输入以下指令:

邮箱就是你注册Github时候的邮箱

执行命令，生成密钥。

ssh-keygen -t rsa -C "xxx@xxx.com"

然后回车，出现提示就直接回车，第一次会问你是否继续，回车，第二次问你是否设置一个密码，写不写都可以，第三次是重复输入密码，没有的话就直接回车。

之后找到用户目录下.ssh文件夹，打开id_rsa.pub文件，复制里面的内容。

打开github网页找到右上角点击你的头像，找到Setting，进去点SSH keys，新建一个SSH。

在Git Bash输入下面的命令：

ssh -T git@github.com

登陆成功。

前面我们说过，hexo d 是部署到Github的命令，但是现在我们执行的话，会提示你

ERROR Deployer not found:git

所以我们还要安装hexo-deployer-git：

npm install hexo-deployer-git --save

安装完成后，在Git Bash配置一下用户名和密码（分别是你的邮箱和用户名）：

git config --global user.email "xxx@xxx.com"

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

执行部署命令：

hexo d

通常情况下是先生成网站，然后部署。可以将两个步骤放到一起：

hexo d -g

现在你就可以打开网站看到效果了。

发表

新建文章

通过以下命令新建文章：

hexo new "文章名字"

然后用编辑器打开你文件夹下面的 source\_posts 里面的 文章名字.md 文件。

title: 文章名字   #标题

date: 2016-12-09 12:04:29   #发表日期

categories: blog   #文章文类

tags: [文章,blog]   #文章标签

---

#这里是正文，用markdown写，你可以选择写一段显示在首页的简介后

#加上<!--more-->，在<!--more-->之前的内容会显示在首页，

#之后的内容会被隐藏，点击Read more才能看到。

更新文章

在命令行执行：

hexo d -g

这样就可以把你的新文章传上去啦。