写在前边

我的第一篇博客,关于博客搭建的(hexo + github),记录搭建过程以及我踩过的坑!

有兴趣可以点开看看哦!


目录

  1. 安装 git
  2. 安装 node.js
  3. 安装 hexo
  4. 注册一个 github 账号
  5. 搭建仓库
  6. 生成SSH Keys
  7. 生成博客内容
  8. 发布博客至互联网

安装git

​ 首先,我们先来了解一下什么是 git;简单来说 git 是开源的分布式版本控制系统,用于敏捷高效地处理项目。我们网站在本地搭建好了,需要使用 git 同步到 GitHub 上。这里,我们就不多说了!

​ 附上 git 官网地址:git官网

​ 去官网下载适合自己电脑的版本,下一步,下一步跟着安装即可!我这里提供个教程,仅供参考!git安装教程 步骤可能有些不一样,不过一般都按默认即可。

安装完成后,我们可以测试一下安装成功与否:按键盘上 win + R 键,输入 cmd ,打开命令提示符窗口,接着输入 git --version ,看其是否出现版本号;如下图:

​ 如果出现,那么恭喜你,安装成功!(如果命令提示符上没有可以重启电脑后再次查看或在git上查看)

​ 这时候你会发现,鼠标右击后会出现两个新的菜单 Git GUI HereGit Bash Here,我们平时只会用到后者,不要搞错了!

安装node.js

​ 因为,我们的博客是基于 hexo 的,而 hexo 又是基于 node.js 的,所以这是必不可少的!

​ 我们可以去其官网,下载并安装;也是直接下一步、下一步就行;这里我也放个教程,可以参考一下:node.js 安装详细步骤教程;不过,值得注意的是:安装 node.js 会包含环境变量及 npm 的安装

​ 安装好以后,我们要检测 node 与 npm 是否安装成功:按键盘上 win + R 键,输入 cmd ,打开命令提示符窗口,分别输入 node -vnpm -v 看其是否出现版本号;

安装hexo

​ hexo 就是我们的个人博客网站的框架;安装的话也很简单,按键盘上 win + R 键,输入 cmd ,打开命令提示符窗口,输入npm install -g hexo-cli,进行安装hexo,等待安装好后,我们检验其是否安装成功输入hexo -v看是否出现版本号;如下图:

如果安装不成功(前提是按照node.js 安装详细步骤教程的步骤来进行)那么可以按照此方法来进行设置,给完权限后再次执行安装hexo的命令即可安装成功了!

注册github

​ 我们打开github官网,然后点右上角的Sign up,即可注册,其实也很简单;这里还是提供一篇教程,不会的可以看看:github注册教程注意:一定要记住注册名、注册邮箱和注册密码哦!!

至此,我们的准备工作就做完了,接下来就是实操时间!


搭建仓库

​ 注册完账号后登陆,点击右上角的 + 号,选择 New repository ;然后,仓库名字填你的注册名 + .github.io,例如我的就是 seatoro.github.io,之后的 Description 可填可不填; 接下来选择 Public ,否则别人访问不了你的博客!然后把 Add a README file 勾上;最后,点击最下边的 Create repository 的按钮就能创建好你的仓库了!如下图:

生成SSH Keys

​ 我们可以在合适的盘新建一个文件夹,可以命名为MyBlog,hexo 框架与以后你自己发布的网页都会在这个文件夹中。一定要记住路径哦,别之后找不到了!打开这个文件夹,鼠标右键,点击 Git Bash Here,然后我们就会进入一个黑框框页面;直接输入 SSH ,来检测我们是否装有SSH,其实默认是装过的!然后输入 ssh-keygen -t rsa -C "你注册github的邮件地址"。之后敲4次回车键(注意:不是连着敲,敲一次,等里面的内容不再变化后再敲下一次!)最后,你会看到一个用短线组成的框框,到这儿你就成功了!不要关闭这个窗口,一会还要用!!

​ 按 Win + E 打开文件资源管理器,打开C盘 –> 用户文件夹 –> 个人文件夹 –> .ssh文件夹,进入后我们可以看到里面有两个文件,用文本编辑器打开名为 id_rsa.pub的文件,ctrl + a ctrl + c复制里面的全部内容!

​ 打开 github ,点击右上角头像找到 Setting ,点进去,往下划在左侧栏找到 SSH and GPG keys,点进去,第一个就是SSH Keys,点击 New SSH Key ,Title 随便填如:MyBlog;Key 就填你刚才复制 id_rsa.pub 里的一大串内容,(以你的邮箱结尾);点 Add SSH Key 按钮即可。

​ 测试是否绑定成功:在刚刚到黑框中输入 ssh -T git@github.com,敲回车,再输入 yes 敲回车即可,只要出现Hi 你的github用户名,就说明成功了!

生成本地博客内容

​ 进入你在上一步中创建的文件夹,在空白处右键,点击 Git Bash Here,在出现的黑框中输入 hexo init来初始化我们的hexo,等待执行完成(如果出现错误,可多尝试几次),成功的标志:INFO Start blogging with Hexo!,这时我们打开上一步中创建的文件夹就会发现里面多了很多内容!

​ 继续在黑框中敲命令:hexo s,启动本地服务器,看到出现 http://localhost:4000后就大功告成,接着我们只需要复制这个地址,去浏览器打开,就能看到我们的博客了;关闭服务器的话只需按 ctrl + c(没错就是复制的快捷键)就能关闭了,关闭后浏览器就打不开你的博客了!

发布博客至互联网

​ 进入你在上上一步中创建的文件夹,找到config.yml文件(注意:没有扩展名是因为你没有开启这个功能,开启方法点这儿 )并用文本编辑器打开,找到最后几行更改为下图所示。(注意:最后一行要空出来,即branch: main 后面要空一行;每个冒号后面有一个空格)另,repo后面的内容把我的用户名(seatoro)改为你自己的!!保存,退出即可。

​ 进入你的博客文件夹,在空白处右键,点击 Git Bash Here,在出现的黑框中输入 npm install hexo-deployer-git --save,安装 hexo-deployer-git ;安装成功后接着敲命令hexo g,回车;执行完后接着敲 hexo d,这个命令是发布网页至服务器中的!(如若出错,多试几次)这时需要验证你的github账号,用户名,就是github用户名,密码就不是你设置的密码了;我们打开github,点击右上角头像找到 Setting ,点进去,往下划在左侧栏找到 Developer settings,点进去,在左侧栏找到 Personal access tokens ,点进去,Note 随便填,Expiration 默认30天就行,下边的复选框全部勾上,最后点击 Generate token 按钮生成令牌。复制生成的令牌,它只会出现一次,一定要记好;将复制的内容粘贴到刚才的密码框中点击 OK 就行了!这时就将本地内容上传到 github 中了,然后你就能通过网址访问了,网址就是你 github 主页左上角的网址,如下:


​ 至此,hexo + github 搭建博客就算是成功了,恭喜!!

​ 不过这只是最初的内容,其实还有好多内容,比如:怎样美化你的博客、更换主题;怎样添加各种小功能;怎样新建、删除文章;怎样搭建自己的图床等等!

​ 但我实在是不想写了,写教程太累了,😭 看情况,之后有时间再补充吧!如果在搭建过程中遇到了问题,可以将错误内容复制到百度,搜一下,你肯定会看到解答的;因为你肯定不是第一个遇到问题的人,如果没有搜到,只能说,你搜索的姿势不对,可以考虑换个姿势再来一次,哈哈哈!

​ 就这样吧!!