博客搭建过程(采用hexo框架+部署到github)
1.前期准备
1.1 注意事项
hexo有2种_config.yml文件,一个是根目录下的全局的_config.yml,一个是各个theme下的
1.2 下载并安装node.js
官网下载:https://nodejs.org/en/
安装与使用:https://blog.csdn.net/qq_43557395/article/details/124325563
安装后验证:node -v
1.3 下载并安装git
官网下载: https://git-scm.com/download/win
安装与使用:https://www.cnblogs.com/itweb666/articles/15670680.html
安装后验证:git -v
1.4 命令行安装cnpm
命令:npm install -g cnpm --registry==https://registry.npm.taobao.org
安装后验证:cnpm -v
1.5 命令行安装hexo
命令:cnpm install -g hexo-cli
安装后验证:hexo -v
2.配置github
2.1 在github上创建仓库
创建:
新建一个名为你的用户名.github.io的仓库
比如说,如果你的github用户名是test,那么你就新建test.github.io的仓库(必须是你的用户名,其它名称无效),将来你的网站访问地址就是 http://test.github.io 了,是不是很方便?由此可见,每一个github账户最多只能创建一个这样可以直接使用域名访问的仓库。
注意:
仓库名字必须是:username.github.io,其中username是你的用户名;
创建成功后,默认会在你这个仓库里生成一些示例页面,以后你的网站所有代码都是放在这个仓库里啦。
- 配置SSH免密登录
为什么要配置这个呢?因为你提交代码肯定要拥有你的github权限才可以,但是直接使用用户名和密码太不安全了,所以我们使用ssh key来解决本地和服务器的连接问题。
操作步骤:
第一步:在C:\Users\blog文件夹下右键打开Git Bash Here输入命令:ssh-keygen -t rsa -C github邮件地址 生成.ssh秘钥,输入后连敲三次回车,出现下图情况代表成功
第二步:最终生成了一个新的 C:\Users\.ssh文件夹,打开这个文件夹,找到.ssh\id_rsa.pub文件,记事本打开并复制里面的内容
第三步:打开你的github主页,进入个人设置 -> SSH and GPG keys -> New SSH key,把复制的内容粘贴进去,title随便填,保存即可,我们的公钥就添加成功了
第四步:检测是否设置成功:
输入命令: $ ssh -T git@github.com # 注意邮箱地址不用改
如果提示Are you sure you want to continue connecting (yes/no)?,输入yes,然后会看到:
Hi liuxianan! You’ve successfully authenticated, but GitHub does not provide shell access.
看到这个信息说明SSH已配置成功!
第五步:此时你还需要配置:
$ git config –global user.name “RickyLove67”// 你的github用户名,非昵称$ git config –global user.email “xxx@qq.com“// 填写你的github注册邮箱
4.使用 hexo 搭建博客
4.1 初始化
第一步:在电脑的某个地方新建一个名为hexo的文件夹(名字可以随便取),比如我的是C:\Users\blog
第二步:在C:\Users\blog文件夹下右键打开 Git Bash Here,输入hexo init 初始化
第三步:执行以下命令之后,hexo就会在public文件夹生成相关html文件,这些文件将来都是要提交到github去的
第四步:hexo s 是开启本地预览服务,打开浏览器访问 http://localhost:4000 即可看到内容,很多人会碰到浏览器一直在转圈但是就是加载不出来的问题,一般情况下是因为端口占用的缘故,因为4000这个端口太常见了,解决端口冲突问题请参考这篇文章https://www.runoob.com/w3cnote/windows-finds-port-usage.html
到这里初始化就完成了
4.2 将博客部署到 github 个人主页上
第一步:在C:\Users\blog目录下安装 hexo-deployer-git 插件
安装命令: npm install hexo-deployer-git --save
必须安装,否则执行hexo d 的话会报如下错误:
第二步:编辑C:\Users\blog目录下的 _config.yml 文件, 在文件末尾添加如下内容:
注意:其中 repo 中的内容即为 github 个人主页链接地址,具体看下图:

第三步:在C:\Users\blog目录下, 输入命令:hexo d 将本地 blog 推送到 github仓库, 也可能需要输入 username & pwd。
推送成功后, 在浏览器中输入对应域名, 即可访问 https://yoursname.github.io
- 更换主题
5.1 寻找主题
hexo官网:https://hexo.io/themes/,可在里面下载主题,点击主题名即可跳转到github上,也可以直接在github上搜索主题
在这里我使用github上一个大佬的主题blinkfox/hexo-theme-matery
链接:https://github.com/blinkfox/hexo-theme-matery
5.2 下载主题
第一步:Git Bash Here中先cd到C:\Users\blog目录
第二步:再输入命令 $ git clone 主题http链接 themes/主题名称
注意:
C:\Users\blog目录下的 theme 文件夹下存放的就是博客的主题,主题是否下载成功可到该目录下查看:
5.3 使用主题
打开C:\Users\blog目录下的_config.yml文件,在里面找到theme: landscape改为theme: blinkfox (blinkfox为我们要使用的主题名),然后重新执行hexo g来重新生成。
如果出现一些莫名其妙的问题,可以先执行hexo clean来清理一下public的内容,然后再执行hexo g 和 hexo s 重新生成和发布。
再次在浏览器中输入对应域名, 即可发现主题已更换
5.4 修改主题内容
在这里我使用的是blinkfox主题,后期相关修改参考这个主题文档
文档链接:https://github.com/blinkfox/hexo-theme-matery/blob/develop/README_CN.md
注意:一些非md文件可以把他们放到source文件夹下,这里的所有文件都会原样复制(除了md文件)到public目录的
修改文件,记得修改后的文件需要关闭后,再在blog根目录右键打开Git Bash Here,输入两个命令:hexo g 重新生成,hexo s 开启本地预览服务,等修改的符合要求了,再输入 hexo d 推送到github仓库即可
这样就可以输入网址查看更改后的内容了
文档上没有提及的修改:
返回按钮样式修改:在主题下面的 blinkfox\layout\_partial 文件夹中的 back-top.esj 文件中修改
特别注意:
修改生成的默认页面信息,要到主题下面的_config.yml文件里面去改,而不是根目录下的_config.yml文件
要把根目录下的_config.yml文件中的这些信息替换成自己的和设置中文
6.利用Typora软件来写博客
6.1 Typora介绍
Typora–一款简单高效的Markdown编辑器,保存后直接为md格式,Markdown中点击导入就可以。
Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式,其目标是实现易读易写,说人话就是删减版的HTML语言
Markdown教程:https://www.runoob.com/markdown/md-tutorial.html
6.2 安装Typora
官网:https://www.typora.io/#windows
6.3 写博客的步骤
第一步:创建.md文件
方法1:定位到我们的hexo根目录,Git Bash Here 中执行命令: hexo new 'my-first-blog' hexo会帮我们在C:\Users\blog\source\_posts 下生成相关.md文件,用这个命令的好处是帮我们自动生成了时间。(但是本人尝试后未能成功发布,鉴于本人也是初学者,还未找到原因)
方法2:当然你也可以直接自己打开E:\xpzsData\hexocode\source\_posts 目录新建.md文件
第二步:编写并保存
我们只需要用typora打开这个文件就可以开始写博客了,写完后Ctrl+S 保存关闭即可
第三步:清理然后再生成一下,生成后推送到远程仓库即可,hexo根目录下右键Git Bash Here 中依次输入如下命令:
hexo clean
hexo g
hexo d
6.4 Typora快捷键
Typora中只要记住一些基本的快捷键就可以了,所有功能软件里面都有对应按钮,这点不用慌。
快捷键文章:https://blog.csdn.net/weixin_39533052/article/details/111115263
6.5 注意:所使用的主题的文章 Front-matter 语法
依据使用的不同主题,一些文章功能所使用的语法可能不一样,例如写博客时给文章添加标签的语法等等,这些都要看所使用的主题的文档,例如我们这里使用的是 blinkfox 主题,打开主题文档,往下翻找到” 文章 Front-matter 介绍 “即可。
参考文献:
1:https://github.com/blinkfox/hexo-theme-matery/blob/develop/README_CN.md
2:https://www.cnblogs.com/liuxianan/p/build-blog-website-by-hexo-github.html
3:https://www.jianshu.com/p/f72aaad7b852
4:https://blog.csdn.net/qq_43557395/article/details/124325563