Hexo+Github搭建个人博客

前言

  • gitHub是一个面向开源及私有软件项目的托管平台,因为只支持git 作为唯一的版本库格式进行托管,故名gitHub。

    除了git代码仓库托管及基本的 Web管理界面以外,还提供了订阅、讨论组、文本渲染、在线文件编辑器、协作图谱(报表)、代码片段分享(Gist)等功能。目前,其注册用户已经超过350万,托管版本数量也是非常之多,其中不乏知名开源项目 Ruby on Rails、jQuery、python 等。

    需要申请一个账户。

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

  • Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。需要简单学习一下语法。

前期准备工作

  • 安装Git
    直接搜索msysgit,也可百度一下Git,对它进行一些了解。

  • 安装Node.js
    因为hexo是node.js编写的。安装方法可自行百度。

  • Notepad++(可选)
    用来代替记事本来修改配置文件,也可以用来写Markdown文档

  • sublime Text 3(可选)
    跟Notepad++相似,但比它强大。

安装Hexo

新建一个文件夹 比如叫“blog” ,用来存放搭建博客所需的文件。
安装Git后,在右键菜单会有“Git bash here”。然后进入blog文件夹,右键任意位置选择Git bash here,会出现一个类似于cmd的命令行工具界面。

接下来依次输入

安装hexo:npm install -g hexo

初始化:hexo init

安装依赖包:npm install

然后输入下面两行进行查看

1
2
hexo g
hexo s

在浏览器中输入 localhost::4000 就可以看到hexo的网页,这个网页是默认设置的,之后可以进行美化。

下面是一些常用hexo代码:

1
2
3
4
5
6
7
8
hexo help #查看帮助
hexo init #初始化一个目录
hexo new "postName" #新建文章
hexo new page "pageName" #新建页面
hexo generate #生成网页,可以在 public 目录查看整个网站的文件 "hexo g"
hexo server #本地预览,'Ctrl+C'关闭,可简写 "hexo s"
hexo deploy #部署.deploy目录 "hexo d"
hexo clean #清除缓存,"hexo c" **强烈建议每次执行命令前先清理缓存,每次部署前先删除 .deploy 文件夹**

配置Github

创建Github账户

自行百度

创建repository

点击 new repository

名字设置为“GitName.github.io”,这个GitName就是你Github的用户名,比如 “ zhangsan.github.io

生成之后就不必管他了。

生成SSH密钥

在Git bash中输入 ssh-keygen -t rsa -C "邮箱地址"按三个回车,密码为空。

之后在用户文件夹下生成 .ssh 文件夹,里面有 id.sshid_rsa.pub

打开 id_rsa.pub 复制全文

打开 http:://github.com/settings/ssh ,点 new ssh key ,然后粘贴进去。

配置_config.yml文件

blog文件夹里有一个_config.yml文件,用Notepad++打开。

  • 在deploy:项修改为下面这样(GitName的含义同上)
1
2
3
4
deploy:
type: git
repo: https://github.com/GitName/GitName.github.io.git
branch: master

注意每个冒号后都要有一个空格

  • blog文件夹中右键 Git bash here

输入 npm install hexo-deployer-git --save

  • 部署到Github
1
2
hexo g
hexo d

此时已基本完成,浏览器输入 http:://GitName.github.io 查看自己的劳动成果。下一篇是关于博客的配置和美化

当前网速较慢或者你使用的浏览器不支持博客特定功能,请尝试刷新或换用Chrome、Firefox等现代浏览器