基于github搭建专属于自己的博客(基础篇)

以前学Django时,看的视频教程就是以搭建博客为案例讲解的。虽然最终也没搭建成功,但是当时就想搭建属于自己的博客。偶然间了解到了hexo搭建博客,恰好最近有空,索性就利用这段时间搭建一个属于自己的博客。首先,我先介绍一下用hexo搭建博客的基本流程:

基本流程:

1.搭建前的准备(包括node.js,git,github账户的配置)

2.安装hexo

3.配置hexo

4.连接hexo与github page

5.发布文章

搭建前的准备

1.安装node.js

2.安装git

3.github账户管理

配置Node.js

下载node.js。根据自己电脑的配置自行安装。

安装完成后打开终端输入:

1
2
node -v
npm -v

进行是否安装成功测试。如不正确,回头检查哪一步错误。

配置Git

git官网。自行安装。

安装完成后打开终端输入:

1
git --version

以上步骤进行是否安装成功。如果安装失败自行面壁。

github管理

已拥有账号可跳过注册此步

打开github进行注册。

登录后点击右上角加号,选择New repository新建代码库。

进入代码库创建页面:

在Repository name下填写yourname.github.io,Description (optional)下填写描述(此步可忽略)。

注意:我的github名称是qianyouyou ,这里就填qianyouyou.github.io

建立后,点击界面右侧的Settings,你将会打开这个库的setting页面,向下拖动,直到看见GitHub Pages。点击Automatic page generator,Github将会自动替你创建出一个gh-pages的页面。 如果你的配置没有问题,那么大约15分钟之后,yourname.github.io这个网址就可以正常访问了~ 如果yourname.github.io已经可以正常访问了,那么Github一侧的配置已经全部结束了。

安装hexo

在合适的地方创建文件夹,这里我以E:/blog 为例子讲解,首先在E盘目录下创建blog文件夹,终端锁定该文件夹

在命令行输入

1
npm install hexo -g   //进行安装

输入

1
hexo -v   //检验是否安装成功。

配置hexo

输入

1
hexo init   //初始化该文件夹

看到后面的“Start blogging with Hexo!”证明正在执行。

输入

1
npm install   //安装所需要的组件

输入

1
hexo g   //生成

输入

1
hexo s

开启服务器,访问该网址,正式体验Hexo

连接hexo与github page

设置Git的user name和email(如果是第一次的话)在blog文件夹里面鼠标右键,点击Git Base Here。

输入cd ~/.ssh,检查是否由.ssh的文件夹

输入ls,列出该文件下的内容

输入ssh-keygen -t rsa -C “xxxxxx@xx.com”,(你的邮箱)连续三个回车,生成密钥,最后得到了两个文件:id_rsa和id_rsa.pub(默认存储路径是:C:\Users\Administrator.ssh)。

输入eval “$(ssh-agent -s)”,添加密钥到ssh-agent

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

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

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

输入ssh -T git@github.com,测试添加ssh是否成功。如果看到Hi后面是你的用户名,就说明成功了

问题:假如ssh-key配置失败,那么只要以下步骤就能完全解决

首先,清除所有的key-pair
ssh-add -D
rm -r ~/.ssh
删除你在github中的public-key

重新生成ssh密钥对
ssh-keygen -t rsa -C “xxx@xxx.com

接下来正常操作
在github上添加公钥public-key:
1、首先在你的终端运行 xclip -sel c ~/.ssh/id_rsa.pub将公钥内容复制到剪切板
2、在github上添加公钥时,直接复制即可
3、保存

测试:
在终端 ssh -T git@github.com

配置Deployment,在其文件夹中,找到_config.yml文件,修改repo值(在末尾)

repo值是你在github项目里的ssh(右下角)

发布文章

新建一篇博客,在cmd执行命令:hexo new post “博客名”

这时候在我的 电脑的目录下 E:\blog\source\ _posts 将会看到 article title.md 文件

在生成以及部署文章之前,需要安装一个扩展:

1
npm install hexo-deployer-git --save

用MarDown编辑器打开就可以编辑文章了。文章编辑好之后,运行生成、部署命令:

1
2
hexo g   // 生成
hexo d // 部署

当然你也可以执行下面的命令,相当于上面两条命令的效果

1
hexo g -d   //在部署前先生成

部署成功后访问你的地址:http://用户名.github.io。那么将看到生成的文章。

到此为止,最基本的也是最全面的hexo+github搭建博客完结。


文章结束了,但我们的故事还在继续
坚持原创技术分享,您的支持将鼓励我继续创作!