使用hexo+github搭建个人博客 - Be4r的博客

搭建前提

在创建个人仓库之前，点击头像左边的+号，选择New repository,创建新的仓库，仓库名称必须为你的用户名.github.io，最终将会生成你的博客地址：https://你的用户名.github.io

git安装完成后，右键鼠标会显示git bash，以下命令都将会在git bash下完成。
git bash下执行命令：

1	$ cd ~/. ssh #检查本机已存在的ssh密钥

初次安装未使用，将会提示No such file or directory

1	ssh-keygen -t rsa -C "your mail"

回车将会在你的C:\Users\your name.ssh下生成公私钥文件，用记事本打开.ssh\id_rsa.pub文件，复制内容。点击github头像，选择Settings->SSH and GPG keys,在其中添加新的SSH key，将前面复制的内容复制进去，保存。

1	$ ssh -T git@github.com # 测试ssh是否连接成功，此处mail不需要修改

如果提示Are you sure you want to continue connecting (yes/no)?，输入yes，然后会看到：

1	Hi XXX! You’ve successfully authenticated, but GitHub does not provide shell access.

说明ssh已经成功配置。
此外还需配置你的个人信息：

1 2	$ git config --global user.name "xxx"// 你的github用户名 $ git config --global user.email "xxx@gmail.com"// 你的github邮箱

以下所有命令均在git bash中完成。

1	$ npm install -g hexo #安装hexo

如果npm install报错，可以执行以下命令切换npm源：

1	$ npm config set registry https://registry.npm.taobao.org

在你要在本机中存放博客素材的地方创建文件夹MyBlog，我的路径为：F:\MyBlog,这个文件夹将会存放你的所有素材。

1 2	$ cd /f/Myblog/ $ hexo init

hexo将会自动下载必需文件到此目录下。

1 2	$ hexo g # 生成项目 $ hexo s # 启动服务

执行上述命令之后，hexo将会在public文件夹中生成相关html文件，这些文件都将是要提交到github上。
当执行完hexo s之后，你就能访问到你本地搭建的博客内容。

1	http://localhost:4000 #浏览器访问地址

但是，hexo的初始主题并不是非常美观，我们可以在https://hexo.io/themes/ 中挑选自己喜欢的主题。
此处我挑选的主题为：https://github.com/gaoryrt/hexo-theme-pln

1	$ git clone https://github.com/gaoryrt/hexo-theme-pln.git themes/pln

下载主题之后，需要在MyBlog文件夹下的_config.yml中将theme: landscape改为theme: pln，并使用hexo g命令重新生成博客。
如果出现一些莫名其妙的问题，可以执行以下来清理一下public的内容，然后再来重新生成和发布。

1	$ hexo clean

在MyBlog文件夹下的_config.yml中deploy部分配置成如下：

deploy:
  type: git
  repository: git@github.com:yourname/yourname.github.io.git
  branch: master

如果你在执行hexo d时出现如下错误：

1	Deployer not found: github 或者 Deployer not found: git

那么你需要安装一个插件：

1	$ npm install hexo-deployer-git --save

一些准备就绪后，发布博客至你的github博客地址。

$ hexo d

此时，访问https://yourname.github.io 就能访问到你搭建好的博客了。

在MyBlog中执行如下命令：

1	$ hexo new 'test'

hexo会在source_posts下生成test.md文件，我们只需要在该份文件中编写博客内容。
当我们编写博客完成时，保存test.md文件，执行如下命令：

1 2	hexo g #重新生成 hexo d #上传发布博客

至此，我们成功完成了博客搭建以及博客编写。