摘要: 随着时代的发展,知识的更新速度越来越快,“活到老,学到老”显得必须且重要。在众多学习方法之中,知识输出是学习的不二法门。互联网时代,通过写博客去记录自己的学习过程,是一种相对比较方便且效率很高的方式。因而,养成一个写博客的习惯,对于科研和工作,都有很大的帮助。本文主要介绍如何在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