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

2019-05-26 10:34:55 浏览数 (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的版本就说明安装成功了。

代码语言:javascript复制
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值(在末尾)

代码语言:javascript复制
deploy:
  type: git
  repo: git@github.com:gxrao/gxrao.github.io.git
  branch: master

其中repo的值在:

一定要选择Clone with SSH

(2) 创建博客

代码语言:javascript复制
hexo new "blog name"  # 创建新的blog

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

代码语言:javascript复制
hexo g
hexo d

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

代码语言:javascript复制
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

0 人点赞