一、目的
作为一个学程序的,有个个人博客,平时写写自己的学习笔记,记录一下自己的生活,写一些自己在学习过程中遇到的一些坑,还有记录一下自己的项目作品,我觉得这是一个很有趣的事,另外,个人博客在自己找工作的过程中是一个很好的加分项。
我其实也是一个小白,什么都不会,一些网页的知识都不知道,而我跟随大佬一步步搭建出了我的个人博客,故此记录一下整个过程,写一些我遇到的坑。
二、开始准备
1、Git
Git 是一个开源的分布式版本控制系统,用于敏捷高效地处理任何或小或大的项目,之后我们会将博客部署到Github pages 中,所以一个Github的账号是必要的,还有自己电脑必须装有Git才能将博客部署上去。
Git 的安装网上有很多教程,这里就不演示了。
安装成功后需要登录用户名和密码
git config --global user.email "you@example.com"
git config --global user.name "Your Name"git
然后使用
git config user.name
git config user.email
查看自己的Git账号
2、Node.js
Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行环境。我们需要Node.js来支持,生成 Hexo 。
Node.js新版本安装很简单,一路下一步就好,可能要修改的就只有安装目录等,完了会提示你安装一下依赖项,确定就好,我因为安装的时候着急,依赖项安装了一半,没安装成功,最后找到开始菜单下的Install Additioal Tools to Node.js 才安装好的,所以安装的时候一定别着急。
三、部署环境
准备工作做好了之后建一个你之后要存博客的文件夹 Blog ,然后在这个文件夹中鼠标右键点击打开Git Bash Here ,用Git Bash 执行之后的命令比较好。之后如果中途出了问题,或者你想重新弄一个博客可以直接将这个文件夹删了重新来一遍
1、安装hexo框架
- 然后使用 node -v 查看安装好的版本

- 使用npm -v查看包管理器的版本
![[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-Aif6KULh-1584934893738)(%E6%90%AD%E5%BB%BAhexo%E5%8D%9A%E5%AE%A2%E4%B8%8Eyilia%E4%B8%BB%E9%A2%98%E4%BC%98%E5%8C%96/2.png)]](https://i-blog.csdnimg.cn/blog_migrate/3327f596340f272771da32126c6ca2fb.png#pic_center)
- 因为我们需要利用 npm 包管理器安装 hexo的框架,但npm的源在国外,下载很慢,故我们使用淘宝的源,使用
npm install -g cnpm --registry==https://registry.npm.taobao.org
![[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-C5qGYpEq-1584934893752)(%E6%90%AD%E5%BB%BAhexo%E5%8D%9A%E5%AE%A2%E4%B8%8Eyilia%E4%B8%BB%E9%A2%98%E4%BC%98%E5%8C%96/3.png)]](https://i-blog.csdnimg.cn/blog_migrate/15e4b9a8f410fa24a41b1d22c3781cb5.png#pic_center)
我的是安装过得所以很快,你们的要自己看,错了也没事,重来就行
- 安装好了就用
cnpm -v查看版本
![[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-WWaVjd5B-1584934893756)(%E6%90%AD%E5%BB%BAhexo%E5%8D%9A%E5%AE%A2%E4%B8%8Eyilia%E4%B8%BB%E9%A2%98%E4%BC%98%E5%8C%96/4.png)]](https://i-blog.csdnimg.cn/blog_migrate/6be7796496c0274388ea688c8623c045.png#pic_center)
- 安装好cnpm后利用cnpm 安装 hexo
cnpm install -g hexo-cli
![[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-ITGB8OwR-1584934893761)(%E6%90%AD%E5%BB%BAhexo%E5%8D%9A%E5%AE%A2%E4%B8%8Eyilia%E4%B8%BB%E9%A2%98%E4%BC%98%E5%8C%96/5.png)]](https://i-blog.csdnimg.cn/blog_migrate/2b95989d5bfa59f4ce9d5fa2c8015a9c.png#pic_center)
- 安装完可以用
hexo -v查看版本
![[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-vbMeqeqT-1584934893764)(%E6%90%AD%E5%BB%BAhexo%E5%8D%9A%E5%AE%A2%E4%B8%8Eyilia%E4%B8%BB%E9%A2%98%E4%BC%98%E5%8C%96/6.png)]](https://i-blog.csdnimg.cn/blog_migrate/628ea913d0182ead36323a7309a6690a.png#pic_center)
2、解决Git Bash 中文乱码问题
![[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-LU7DAC0I-1584934893766)(%E6%90%AD%E5%BB%BAhexo%E5%8D%9A%E5%AE%A2%E4%B8%8Eyilia%E4%B8%BB%E9%A2%98%E4%BC%98%E5%8C%96/001.png)]](https://i-blog.csdnimg.cn/blog_migrate/d6994d08f913e1260179155ac38a0da6.png#pic_center)
![[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-ltNElneb-1584934893767)(%E6%90%AD%E5%BB%BAhexo%E5%8D%9A%E5%AE%A2%E4%B8%8Eyilia%E4%B8%BB%E9%A2%98%E4%BC%98%E5%8C%96/002.png)]](https://i-blog.csdnimg.cn/blog_migrate/c3614f285364a648f0f3b9c0ce6c9a1b.png#pic_center)
- 打开设置后点击 Text,将 locale 中改为 zh_c ,将 Character set 中改为 GBK
![[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-IDHWqHIC-1584934893769)(%E6%90%AD%E5%BB%BAhexo%E5%8D%9A%E5%AE%A2%E4%B8%8Eyilia%E4%B8%BB%E9%A2%98%E4%BC%98%E5%8C%96/003.png)]](https://i-blog.csdnimg.cn/blog_migrate/412d0d49906786a5fc1edf5f5a12a19e.png#pic_center)
修改后保存,退出 Git Bash ,重新打开就不会乱码了
四、初始化博客
- 使用
hexo init初始化 hexo ,注意文件夹必须是空文件夹
![[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-PfagwsY6-1584934893771)(%E6%90%AD%E5%BB%BAhexo%E5%8D%9A%E5%AE%A2%E4%B8%8Eyilia%E4%B8%BB%E9%A2%98%E4%BC%98%E5%8C%96/7.png)]](https://i-blog.csdnimg.cn/blog_migrate/a58995b7a5023983383cf1a079cedacd.png#pic_center)
- 这里出现了一个错误 ,经过我多次查找问题,在百度上查询,最终找到原因,是因为没有node_modules文件夹,所以我们按照提示运行
npm install
![[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-2gmrCyfh-1584934893772)(%E6%90%AD%E5%BB%BAhexo%E5%8D%9A%E5%AE%A2%E4%B8%8Eyilia%E4%B8%BB%E9%A2%98%E4%BC%98%E5%8C%96/8.png)]](https://i-blog.csdnimg.cn/blog_migrate/e0f2aab5b9699f2b1143ff09820ae909.png#pic_center)
直到没有错误出现
- 然后就可以启动博客了,使用
hexo s启动博客
![[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-0iRRCNN8-1584934893775)(%E6%90%AD%E5%BB%BAhexo%E5%8D%9A%E5%AE%A2%E4%B8%8Eyilia%E4%B8%BB%E9%A2%98%E4%BC%98%E5%8C%96/9-1584775663698.png)]](https://i-blog.csdnimg.cn/blog_migrate/409093c47fb9447fb8b07635bb686bf6.png#pic_center)
- 然后就可以看到博客启动成功,在本地的4000端口启动,我们可以将这个地址添加到浏览器访问,(不能用Ctrl+C,那样会停止运行)
![[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-SKnyPlve-1584934893777)(%E6%90%AD%E5%BB%BAhexo%E5%8D%9A%E5%AE%A2%E4%B8%8Eyilia%E4%B8%BB%E9%A2%98%E4%BC%98%E5%8C%96/10.png)]](https://i-blog.csdnimg.cn/blog_migrate/8a3633d1cd11af7e368afb336a6a53e1.png#pic_center)
他会默认生成一个博客叫 Hello World,当然你完全可以直接删除 Hello World这篇文章。
五 、写博客
1、生成博客
- 博客已经生成了,现在我们已经可以写博客了,使用
hexo n "我的第一篇博客",他就可以为我们创建一篇名叫“我的第一篇博客”的博客
![[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-JPKgtWf8-1584934893782)(%E6%90%AD%E5%BB%BAhexo%E5%8D%9A%E5%AE%A2%E4%B8%8Eyilia%E4%B8%BB%E9%A2%98%E4%BC%98%E5%8C%96/11.png)]](https://i-blog.csdnimg.cn/blog_migrate/09a012d7871508f9c192501a46518699.png#pic_center)
- 这样就已经建立了一个博客,并且他将文件路径给了我们,我们可以先使用
pwd命令查看我们当前在哪个目录下
![[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-fj1fSFrU-1584934893783)(%E6%90%AD%E5%BB%BAhexo%E5%8D%9A%E5%AE%A2%E4%B8%8Eyilia%E4%B8%BB%E9%A2%98%E4%BC%98%E5%8C%96/12.png)]](https://i-blog.csdnimg.cn/blog_migrate/d7ed10890bef1e24dd2046bd4cd3e1cf.png#pic_center)
- 使用
cd命令切换到我们要编辑的文件夹,即cd source/_posts
![[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-GPb4RhWM-1584934893786)(%E6%90%AD%E5%BB%BAhexo%E5%8D%9A%E5%AE%A2%E4%B8%8Eyilia%E4%B8%BB%E9%A2%98%E4%BC%98%E5%8C%96/13.png)]](https://i-blog.csdnimg.cn/blog_migrate/6494748049834210b0dbd42497b964ff.png#pic_center)
- 然后查看当前文件夹的文件,使用
ls命令,即ls -l
![[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-mw3lZJFs-1584934893787)(%E6%90%AD%E5%BB%BAhexo%E5%8D%9A%E5%AE%A2%E4%B8%8Eyilia%E4%B8%BB%E9%A2%98%E4%BC%98%E5%8C%96/14.png)]](https://i-blog.csdnimg.cn/blog_migrate/f3cefa0e28419b0b2f0d1d900aaa758b.png#pic_center)
就可以看到我们新建的博客了,还有hexo默认帮我们建的博客,
2、使用 vim 编辑器编辑博客
- 然后我们就可以写博客了,用
vim编辑器打开要写的博客
![[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-dZUtSPfD-1584934893793)(%E6%90%AD%E5%BB%BAhexo%E5%8D%9A%E5%AE%A2%E4%B8%8Eyilia%E4%B8%BB%E9%A2%98%E4%BC%98%E5%8C%96/16-1584779229206.png)]](https://i-blog.csdnimg.cn/blog_migrate/f6d9b32996b1135d29aa3b6b2d0f56f1.png#pic_center)
-
vim 编辑器刚进来是在命令模式下,我们需要按
a或i进入编辑模式,输入将要写的内容

注意,着这里我用了 Makedown 的方式写的 -
写完后按
Esc键退出到命令模式,之后输入按:进入底线命令模式,输入wq按回车进行保存退出

- 然后我们退回到原来的文件夹目录,即刚开始的 Blog 目录,
cd ../..

- 然后使用
hexo clean清除一下,接着用hexo g重新生成一下


- 然后就可以重新启动博客了 ,使用
hexo s启动博客

- 打开浏览器,输入
http://localhost:4000查看博客

![[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-hawNLTh5-1584934893827)(%E6%90%AD%E5%BB%BAhexo%E5%8D%9A%E5%AE%A2%E4%B8%8Eyilia%E4%B8%BB%E9%A2%98%E4%BC%98%E5%8C%96/24.png)]](https://i-blog.csdnimg.cn/blog_migrate/c8d8b1f563c7a252f587eb42b8487bee.png#pic_center)
3、非命令行编辑博客
当然不会用命令行的或命令行用不惯的可以省略部分命令
hexo n "博客名称"和cd source/_posts可以在资源管理器内找到路径,右键点击新建文本文档,将文件后缀名改为.md,加上文件名,新的博客就创建成功了
![[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-qkClCbKG-1584934893832)(%E6%90%AD%E5%BB%BAhexo%E5%8D%9A%E5%AE%A2%E4%B8%8Eyilia%E4%B8%BB%E9%A2%98%E4%BC%98%E5%8C%96/01.png)]](https://i-blog.csdnimg.cn/blog_migrate/47db8de4cd40ccd332a034d54a8b391c.png#pic_center)
vim 博客名称、按a或i进入插入模式、按Esc进入命令模式,按:进入底线命令模式、按wq保存退出,可使用任何一款带 Makedown 的编辑器,我使用的是 Typora ,很好用,Typora下载地址
![[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-mtNTzSyy-1584934893834)(%E6%90%AD%E5%BB%BAhexo%E5%8D%9A%E5%AE%A2%E4%B8%8Eyilia%E4%B8%BB%E9%A2%98%E4%BC%98%E5%8C%96/02.png)]](https://i-blog.csdnimg.cn/blog_migrate/3210bd929a5ac051f7f575b42b7bbf3c.png#pic_center)
- 剩下的
hexo clean、hexo g、hexo s是必须要记住的
4、vim编辑器中文乱码问题
找到 Git 的安装目录,比如说我的在D:\Program Files\Git 中,在这个文件夹中进入etc目录中,用文本编辑器打开 vimrc 文件,在里面添加
set fencs=utf-8,gbk,utf-16,utf-32,ucs-bom "编码配置
set nu "vim行号显示

修改完成后退出 Git Bash ,重新打开之后再使用 vim 编辑器时就不会乱码了
六、把博客部署到远端
现在已经可以写博客了,但是这样只能在本地查看,所以我们需要将博客部署到远端,这里我们使用 GitHub ** ,将我们的博客部署到GitHub**中,实现远程访问
1、创建仓库
- 首先我们需要一个 GitHub 的账号,可以在GitHub中注册
- 然后我们新建一个仓库

- 博客名称必须以你 GitHub 账号的昵称构成,比如说我的 GitHub 账号昵称为
thelnktears,则这个仓库的名称为thelnktears.github.io描述随便写
![[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-2QHZWRAc-1584934893845)(%E6%90%AD%E5%BB%BAhexo%E5%8D%9A%E5%AE%A2%E4%B8%8Eyilia%E4%B8%BB%E9%A2%98%E4%BC%98%E5%8C%96/26.png)]](https://i-blog.csdnimg.cn/blog_migrate/a098fa4215db7f17d799a024f412ed68.png#pic_center)
我这已经创建过了,所以就出错了,然后就创建
2、安装插件
- 之后回到我们电脑上创建的Blog 文件夹下,安装一个git 的部署插件,使用
cnpm install --save hexo-deployer-git安装

3、设置上传
- 然后修改 Blog 文件夹下的 _config.yml 这个文件,使用vim 编辑器打开
vim _config

- 按
a或i进入插入模式,找到 Deployment 在下面添加如下内容,按esc退出插入模式,按:进入底线命令模式,输入wq保存退出- type: git
- repo: 新建仓库的HTTPS的地址
- branch: master
# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
type: git
repo: https://github.com/thelnktears/thelnktears.github.io.git
branch: master
新建仓库的地址可以在建完仓库后跳转的页面中得到,如果退出去了则可以在克隆仓库的地址中找到
![[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-94p74YwQ-1584934893880)(%E6%90%AD%E5%BB%BAhexo%E5%8D%9A%E5%AE%A2%E4%B8%8Eyilia%E4%B8%BB%E9%A2%98%E4%BC%98%E5%8C%96/30.png)]](https://i-blog.csdnimg.cn/blog_migrate/774e310218833cf82165db094cfc4a29.png#pic_center)
4、上传博客
- 退出后使用
hexo d把博客部署到远端,在浏览器中输入https://thelnktears.github.io/,也就是你新建仓库的地址,有时GitHub 网比较慢,所以稍微等待
![[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-vHliIrwm-1584934893882)(%E6%90%AD%E5%BB%BAhexo%E5%8D%9A%E5%AE%A2%E4%B8%8Eyilia%E4%B8%BB%E9%A2%98%E4%BC%98%E5%8C%96/31.png)]](https://i-blog.csdnimg.cn/blog_migrate/f69695af1a937f7788858f19cc40b042.png#pic_center)
![[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-WQamehob-1584934893884)(%E6%90%AD%E5%BB%BAhexo%E5%8D%9A%E5%AE%A2%E4%B8%8Eyilia%E4%B8%BB%E9%A2%98%E4%BC%98%E5%8C%96/33.png)]](https://i-blog.csdnimg.cn/blog_migrate/c0042a633ecfd4c1090bb8b003589f8f.png#pic_center)
- 部署成功后
![[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-eNXpB1t6-1584934893887)(%E6%90%AD%E5%BB%BAhexo%E5%8D%9A%E5%AE%A2%E4%B8%8Eyilia%E4%B8%BB%E9%A2%98%E4%BC%98%E5%8C%96/32.png)]](https://i-blog.csdnimg.cn/blog_migrate/04071ee9eda1e7969db6190d1216abac.png#pic_center)
注意,如果你的 GitHub 昵称里有大写,建议你重新修改一下名字,不要有大写,因为大写的话浏览器会改为小写,从而无法访问到正确的地址
七、给个人博客换主题
现在博客的主题是默认带的,不好看,所以我们需要对其进行修改
1、下载主题
这里我们使用 yilia这个主题,写的很好,很多人用
使用git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia 克隆下载 yilia 这个主题

2、修改主题
下载完成后需要将主题应用到我们的博客里面,设置主题我们需要修改Blog 目录下的 _config.yml 这个文件
使用命令 vim _config.yml 打开文件

找到 theme 这行,默认为 landscape ,修改为我们想要替换的主题

修改过后

这样我们的主题就换过来了,我们启动一下看看,使用 hexo clean 、hexo g 、hexo s 在本地启动

八、博客主题优化
此时,我们的博客已经换好主题了,但是不是我们想要的样子,所以对这个主题还要进行修改,换成我们想要的样子
1、网站名称
- 打开 Bolg 目录下的
_config.yml文件,修改名称,即title后的名称,修改为你想要的名称

2、副标题
即 subtitle 后的名称,可以放些你喜欢的句子

3、作者名称以及语言
author 以及language

修改完成后

4、修改头像
发现头像还没改过来,至于头像,我们需要到下载的主题的目录中修改而在下载时,将yilia 的主题下载到了 themes/yilia 这个目录下,所以我们打开这个目录,找到里面的 _config.yml 的文件,即 themes/yilia/_config.yml ,打开这个文件
找到如下行,添加你的头像,将你的头像图片放到 yilia 目录下的 source 中的 img 文件夹下,即Blog\themes\yilia\source\img ,并且将 _config.yml文件的如下行修改,在 avatar: 后面添加 路径 /img/avatar.jpg
#你的头像url
avatar:

5、修改网站图标
将你的图标放到 yilia 目录下的 source 中的 img 文件夹下,即Blog\themes\yilia\source\img ,并且将 _config.yml文件的如下行修改,在 favicon: 后面添加 路径 /img/avatar.jpg

6、修改连接
yilia 的主题帮我们打开了 Github 、微博、知乎等的链接,我不需要这么多,或者这些我用不到,那就修改掉,我想要的有Github 、QQ、微信,QQ 、微信我使用添加好友的二维码代替了

此时就会被修改为如下情况

目前看似差不多了,但是我们点击所有文章、友链、关于我时发现好像还是不对,那接着修改
7、所有文章
点击所有文章会弹出如下情况,按照提示,进行修改

输入 cnpm i hexo-generator-json-content --save

打开 Blog 文件夹下的 _config.yml 文件,添加如下内容
jsonContent:
meta: false
pages: false
posts:
title: true
date: true
path: true
text: false
raw: false
content: false
slug: false
updated: false
comments: false
link: false
permalink: false
excerpt: false
categories: false
tags: true

然后所有文章就改过来了,

8、友链
添加友链,帮忙推广一些技术大佬,添加大佬们的网站、博客地址,同时添加友链也能增加自己博客的访问,打开 yilia 文件夹下的 _config.yml 文件,进行修改

9、关于我
添加一些关于自己的话

10、打赏
现在打开博客文章后,翻到后面会有一个打赏的功能,将其运用起来,如同加载头像、QQ、微信等的链接的方式,添加微信或支付宝的收款码

11、目录
现在博客已经可以了,但是我们点击随笔时会出错,经过查询,我知道了,这是一个标签,通过写的文章的标签添加到这个链接里(我的理解,大佬勿喷),而博客的随笔可能不多,相同这个后,我觉得应该为博客添加一个目录,以后文章多了找起来方便,写文章时添加一个名叫目录的标签,以此达到为博客添加目录的目的,简单易行。

之后每次写文章,在 tags 后面都添加一个目录的标签,就实现了目录的功能,注意每个标签后面都有一个空格,这是人家规定的,必须这样写,否则会出错
修改完启动博客,点击目录就会发现可以跳转到类似于目录的页面

然后使用 hexo d 把博客部署到远端,在浏览器中输入https://thelnktears.github.io/ ,也就是你新建仓库的地址,有时GitHub 网比较慢,所以稍微等待,然后你就会发现,博客被部署到远端了,之后你就可以将这个网址告诉别人,说这是你的博客网站
九、我们的博客

博客搭建好了,我没有添加评论等功能,因为十分麻烦,效果也不明显,就放弃了,现在的功能我已经满意了,剩下的就是多写博客,为博客添加内容。其实除了一些必要的明亮,搭建博客还是很容易的,毕竟别人帮我们写了很多内容,我们只是使用者。我的博客就这样了,我很满意,如果各位有不满意的可以在网上查找相关内容,修改_config.yml 文件,所有设置都是通过这个文件实现。
741

被折叠的 条评论
为什么被折叠?



