通过GitHub和Hexo来搭建自己的个人博客

2017-10-08 本文已影响292人叫我旺仔

最近没有更新简书，Kotlin的文章就暂时告一段落了。。。

搭建个人博客在我大学的时候建过一次，那时候是用新浪云和Wordpress搭建的，那时候新浪云服务是免费的，后来变收费，博客就没有了。之前便想着再弄个自己的博客出来，这几天就着手弄了起来。
看到很多人的个人博客是用github来当服务器，然后通过Hexo来搭建博客框架，那么新建个人博客也用这两个来搭建吧。本文同步更新于旺仔的个人博客，访问可能有点慢，多刷新几次。

GitHub主页

创建仓库

想必大家都有自己的Github账号吧，没有的可以到GitHub官网注册账号，注册完后，我们来下一步，在我们的GitHub上面右上角的New repository来创建一个仓库。

仓库名必须遵守相应格式：your_username.github.io，这样子在访问主页的时候直接用your_username.github.io就能访问。

我这里因为是已经创建了一个仓库了，所以会有提示，然后点Create repository确定创建仓库。

设置Pages

接下来我们来设置我们的GitHub Pages，打开我们刚刚创建的仓库，然后创建一个主页index.html

然后在里面输入代码

<!DOCTYPE html>
<html>
<body>
<h1>Hello World</h1>
<p>I'm hosted with GitHub Pages.</p>
</body>
</html>

然后保存

接下来我们打开GitHub Pages的设置，点开Settings

移到下面的GitHub Pages

可以看出，我现在能用https://jowanxu.github.io/来访问我的github主页了，这里我是用我的一个新创建的号来演示的。

通过上面的配置，我们能通过your_username.github.io来访问我们的博客主页了。

Clone仓库

创建完仓库后（可直接安装Git,忽略Clone），我们需要将代码下载到本地，这里就需要用到Git了。

安装Git

Windows：下载并安装 git，msysGit
Mac：使用 Homebrew, MacPorts ：brew install git;或下载安装程序安装。
Linux (Ubuntu, Debian)：sudo apt-get install git-core
Linux (Fedora, Red Hat, CentOS)：sudo yum install git-core

安装完Git后，在命令行输入git --version，判断是否成功

如果出现不存在命令，那么就添加Git目录下bin目录的环境变量，添加完后要重新打开命令行，然后在判断是否成功。

这里我使用msysGit的Bash窗口来进行操作的。

配置Git参数

安装完Git后，需要配置本地Git的参数，右键一个文件夹，然后选择Git Bash，打开Bash窗口，然后

然后我们来设置Git的姓名和邮箱：

git config --global user.name "Firstname Lastname"
git config --global user.email "your_email@example.com"

配置完成后，会在~/.gitconfig中生成相应的本地Git配置信息。

添加SSH Key

GitHub上连接已有仓库是验证是通过SSH的公开密钥进行认证的，在这里我们来生成我们自己的SSH Key，输入下面的命令，输入完后回车，会让你输入密钥的文件名和密码，系统会在/Users/your_user_directory/.ssh/x下生成私有密钥id_rsa和公开密钥id_rsa.pub

ssh-keygen -t rsa -C "your_email@example.com"

我们可以看到生成的文件

id_rsa文件内容是这样的，由-----BEGIN RSA PRIVATE KEY-----开始，和-----END RSA PRIVATE KEY-----结束

id_rsa.pub的内容是这样的，由ssh-rsa开头的

然后我们在GitHub上面添加本地SSH密钥信息，在右上角选择Settings进入设置界面

然后选中SSH and GPG keys，点击New SSH key

Title可以随便填，打开公开密钥id_rsa.pub，复制里面的内容到Key里面，填完密钥后，点Add SSH key就OK了。

ssh-agent

我们要通过ssh-agent来添加刚刚创建的密钥，来登陆GitHub，ssh-agent是一种控制用来保存公钥身份验证所使用的私钥的程序，通过输入下面两条命令添加，第一条命令是反引号`，不是单引号'

eval `ssh-agent -s`
ssh-add hexo_rsa（上面创建的密钥文件名）

然后我们登陆一下GitHub，看是否登陆成功

ssh -T git@github.com

登陆成功~~~

Hexo框架

Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown（或其他渲染引擎）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。
安装Hexo需要用到npm，而安装npm则需要安装Node.js，Node.js可以在官网下载，下载完成直接安装，然后通过命令行来判断是否安装完成

npm设置淘宝NPM镜像，来提高下载速度

npm install -g cnpm --registry=https://registry.npm.taobao.org

设置完镜像后，就可以安装Hexo了

npm install -g hexo-cli

然后用命令行查看是否安装成功

hexo -version

接下来我们需要创建一个文件夹，文件名随意，也可以在已存在的文件夹里面，但是里面必须是什么文件都没有，然后进入到文件夹里面，来初始化Hexo

hexo init

如果没有出现错误，那么我们的Hexo博客框架就安装完成了，生成的目录内容如下，其中_config.yml是网站的配置信息，我们大部分的参数都是在这个文件里面修改

接下来我们来启动Hexo服务

hexo s

也可以开启debug模式，debug模式可以实时更新，方便查看修改后的结果。

hexo s --debug

然后我们在浏览器上输入localhost:4000来打开Hexo

Hexo常用命令

new

如果我们要创建一篇文章的话，我们可以通过new命令来创建，也可以直接在博客目录下面的\source\_posts里面创建markdown文件。

hexo new [layout] <title>

如果标题包含空格的话，请使用引号括起来。

generate

generate命令是用来生成静态文件的，在我们发布到GitHub的仓库的时候，需要先生成，才能上传。

hexo generate

可以简写为

hexo g

server

开启服务器，网址为http://localhost:4000

hexo server

同样可以简写为

hexo s

deploy

部署网址，上传到我们的GitHub的仓库上面。

hexo deploy

同样可以简写为

hexo d

clean

清除缓存文件 (db.json) 和已生成的静态文件 (public)。在某些情况（尤其是更换主题后），如果对站点的更改无论如何也不生效，运行该命令。

hexo clean

Hexo配置Git

我们要上传GitHub必须要先设置一些内容，打开博客目录下面的配置文件_config.yml，找到deploy，然后在type那里输入git，在repo那里输入我们的仓库地址，在branch那里输入master，message为上传日志，可不写

一般我们上传到GitHub的时候我们用这条命令来执行，生成静态文件并且部署到服务器。

hexo g -d

上传完成之后，我们可以在博客文件夹里面的.deploy_git目录管理我们的仓库文件，那么我们上面就不需要Clone仓库下来了。

下一步我们来通过域名解析GitHub主页地址来访问个人博客。

域名

在本地搭建完个人博客后，我们就要将代码上传到我们的GitHub仓库上面去，然后我们就可以通过your_username.github.io来访问我们的博客主页了，但是我们如果要修改GitHub的域名的话是改不了的，只有我们自己去购买域名，然后通过域名解析将我们的GitHub主页的域名解析到我们自己买的域名上面，这样我们就可以通过我们自定义的域名来访问我们的博客了。