通过github构建个人博客1-基本环境搭建

摘要：随着时代的发展，知识的更新速度越来越快，“活到老，学到老”显得必须且重要。在众多学习方法之中，知识输出是学习的不二法门。互联网时代，通过写博客去记录自己的学习过程，是一种相对比较方便且效率很高的方式。因而，养成一个写博客的习惯，对于科研和工作，都有很大的帮助。本文主要介绍如何在windows操作系统上基于github平台，结合hexo框架（一个node.js框架）来构建一个专属于个人的博客。

关键词：个人博客，github，hexo框架

由于配置整个框架和平台还是比较麻烦，所以本教程分为两部分，第一部分属于搭建环境的基本过程，第二部分属于配置主题等的博客个性化历程。每一部分都会给出详细代码和图片示例。

本节主要介绍本地环境的安装与配置，包括：git[1]，node.js[2], hexo[3]；此外还包括github账户申请与博客仓库的创建，最后将本地环境与博客仓库建立连接。做完这些，就完成了搭建个人博客的所有前提工作。

再次声明，本文中的所有操作都是基于windows操作系统，具体版本为win10 64位。

1. 本地环境的安装与配置

（1） git的安装

git的下载地址，直接点击图中红色边框中的下载按钮便可。下载后一路同意或者下一步，便可。

安装完成后再开始菜单里有一个Git的文件夹，里面有个Git Bash的程序，打开它，出现以下界面代表安装成功。

(2) node.js安装与配置

node.js下载地址：https://nodejs.org/en/download/

直接点击图中红框内的下载地址便可，下载完成后一路同意或者下一步。实在不会的可以参考博客：https://blog.csdn.net/qq_26562641/article/details/72235585

安装完成后打开cmd，分别输入以下命令 ,分别能显示node 和 npm的版本就说明安装成功了。

node -v
npm -v

(3) hexo的安装与配置

在本地磁盘中设置一个blog目录，例如我的是：g：\blog(G盘下的blog文件夹)。cmd中切换到该目录下，输入安装命令：npm install hexo -g，安装完成后输入：hexo -v ，显示hexo的版本则说明安装成功。

输入hexo初始化命令：hexo init 后等待一段时间，出现图中提示便初始化完成。

接下来安装必要的组件：npm install，之后输入处理命令： hexo g 并开启服务器：hexo s 出现以下信息：

把网址复制到浏览器地址栏后回车，便显示：

如果无法显示网页，说明端口可能被占用，更改端口便可。

hexo server -p 4001

至此，成功了一小步！

2. github账户申请以及博客仓库的建立

进入github主页: https://github.com/ ,填好用户名，邮箱，密码便可：

登录后建立博客仓库，需要注意以下几点：

a. 项目必须要遵守格式：账户名.github.io ,例如：gxrao.github.io(gxrao就是博客用户名)

b. 需要勾选Initialize this repository with a README

创建博客仓库后进入仓库并点右侧的setting，向下拉到GitHub Pages

可以看到博客的网址，点击便可访问

至此，仓库已完成搭建。

3. 将本地环境链接到博客仓库

将本地环境链接到博客仓库之后就可以在本地编辑，完成之后再同步到仓库里，这样就能在离线的环境里进行编辑博客了。

（1）设置git

注意：此处所有操作假设github用户名为：test 邮箱为：test@hotmail.com

打开Git Bash,分别输入：

git config --global user.name "test"

git config --global user.email "test@hotmail.com"

到用户目录下，检查.ssh文件夹：cd ~/.ssh 如果提示没有，则新建一个：mkdir ~/.ssh

输入生成rsa命令：ssh-keygen -t rsa -C "test@hotmail.com" 之后所有提示都直接回车（三个回车），再ls一下，便显示：

提示信息中显示了rsa文件的保存目录。

输入eval "$(ssh-agent -s)"，添加密钥到ssh-agent

再输入ssh-add ~/.ssh/id_rsa，添加生成的SSH key到ssh-agent

登录Github，点击头像下的settings，添加ssh

新建一个new ssh key，将id_rsa.pub文件里的内容复制上去

点击add便完成添加。配置失败可以参考：https://www.cnblogs.com/superGG1990/p/6844952.html

为了保证完全成功，可以测试一下：ssh -T git@github.com 之后输入yes

接下来配置本地环境，在本地博客目录里找到_config.yml文件，修改repo值（在末尾）

deploy:type: gitrepo: git@github.com:gxrao/gxrao.github.io.gitbranch: master

其中repo的值在：

一定要选择Clone with SSH

(2) 创建博客

hexo new "blog name"  # 创建新的blog

在blog文件夹的/source/_post/ 文件夹下就有一个 blog-name.md 的文件，用markdown编辑器编辑好博文后，再使用，生成和部署命令：

hexo g
hexo d

也可以采用一个命令完成两件事：

hexo d -g

我们经常会在blog中插入图片，例如本文就有很多图片，这个时候就需要特殊处理：

a. 在blog文件夹的source目录下建立一个images文件夹，专门用来存放图片。而且这样设置之后的好处是既可以本地实时预览，部署网页又不需要修改，能够做到所见即所得。

b. markdown 编辑器使用typota（一款我觉得最优秀的markdown编辑器，下载地址：https://www.typora.io/），设置图片目录：编辑-图片工具-当插入图片时，目录选择a中建立的images目录,此时文档的最上面会出现如下代码：

总结一下，部署博客的过程（两部走）便可以完成。完成后再浏览器地址栏输入：https://test.github.io 就能访问博客了。

先hexo new "博客名"

后hexo d -g

博客效果图：

hexo其他命令可以参考：

https://blog.csdn.net/qq_26975307/article/details/62447489

4. 总结

本节主要介绍了基本环境的配置，以及简单的blog部署。至此，简单的blog就搭建完成了。下一节主要介绍blog个性化设置的部分，包括个人域名，页面部署等，做到真正的个人博客。

参考文献：

[1] https://baike.baidu.com/item/GIT/12647237?fr=aladdin

[2] http://nodejs.cn/

[3] https://www.cnblogs.com/mophy/p/7016331.html