相关工具介绍

Hexo

Hexo 是一个快速、简洁且高效的博客框架。 Hexo 使用 Markdown(或其他标记语言)解析文章,在几秒内,即可利用靓丽的主题生成静态网页。

官方网址

Github Pages

GitHub Pages是 GitHub 提供的一个免费的静态网站托管服务,它允许 GitHub 用户创建和托管自己的静态网站,这些网站可以通过特定的 GitHub 仓库进行管理和托管。

官方网址

由于Github Pages提供了免费托管静态网站的服务,基于Hexo,我们就可以部署自己定制的的Bolg到Github Pages,还不用自己买服务器。

不过免费的代价就是要耗费一定的时间。(果然天下没有免费的东西:cold_sweat:)

好的,废话不多说,下面开始直接进入到教程!!

前期环境准备

  • Node.js (Node.js 版本需不低于 10.13,建议使用 Node.js 12.0 及以上版本)

  • Git

  • Github账号:申请一个Github账号、

    • 假如这么不巧,Github又被仁慈的墙了有两个解决方法:
      1. 可以考虑用国内的Gitee(码云)来实现,Gitee也实现了免费的静态网页托管服务Gitee Pages。(基于Gitee搭建Hexo的教程后面有空一定)
      2. 试一下看看外面的世界(翻墙),推荐使用跑路云,里面已经带有详细的教程,这里就不说了。

环境检查

  • 运行cmd后,依次输入以下命令
1
2
3
node -v
npm -v (node会自带)
git -v
  • 检查是否都正常输出对应工具的版本号,如果是则下载成功。

安装Hexo

  • 所有必备的应用程序安装完成后,即可使用 npm 安装 Hexo。
1
npm install -g hexo-cli
  • 在cmd输入以下命令来检查是否安装成功
1
hexo -v

Github建立仓库

建立新仓库

  • 登录你自己的Github账号:Github
  • 点击new新建一个仓库

image-20241213171408129

  • 仓库名必须按照Hexo给定的格式来: <username>.github.io,把这里的<username>替换成自己GitHub的账号名。直接看Owner叫什么,<username>就填什么就好
  • 若之前已将 Hexo 上传至其他储存库,将该储存库重命名即可。
  • 仓库的可见性这里,填Public就好。
  • 勾选一下Add a README file,这样子就不至于是一个空仓库,比较好操作。
  • 最后点一下Create repository就完成仓库的创建了

image-20241213180059799

在Github配置ssh

打开GitBash

  • 从左下角搜索GitBash应用

image-20241213181811696

  • 又或者随便打开一个文件夹,点击右键,选择Git Bash Here

image-20241213182109998

  1. 检查本地是否已经存在ssh key
1
2
cd ~/.ssh
ls

像下面显示的这样,则表示 电脑已经存在ssh key,可以直接跳到第5步。

image-20241213182655571

  1. 配置用户名:
1
git config --global user.name "username"    //( "username"是自己的账户名,)

image-20241213182216662

  1. 配置邮箱:
1
git config --global user.email "[email protected]"     //("[email protected]"注册账号时用的邮箱)

image-20241213182330015

  1. 检查是否配置成功
1
git config --global --list 

image-20241213182443148

  1. 生成 ssh key
1
ssh-keygen -t rsa

执行后一直回车即可

image-20241213184059841

  1. 获取ssh key 公钥
1
2
cd ~/.ssh
cat id_rsa.pub

复制这段内容

image-20241214001132991

  1. 在Githhub上添加你的公钥(就是你上面复制的内容)

image-20241214002412659

image-20241214002517864

Title这里输入你这个公钥的设备的昵称(我的电脑啥的),把上面复制的工公钥黏贴到Key里面,然后点击Add SSh key就完成了。

image-20241214002656673

  1. 验证是否配置成功

执行以下命令

1
ssh -T [email protected]

显示以下内容就代表配置成功了!!

image-20241214003012389

之后拥有这个公钥设备,可以通过ssh免密的与你的github账号的仓库进行互动了(push,pull等)

本地构建博客

  • 在电脑内找一个合适的地方新建一个文件夹,用于保存博客的内容(例如新建一个Blog文件夹)
  • 然后在空白处点击右键,打开Git Bash Here

image-20241214010129126

  • 按顺序输入以下命令,记得先等上一个执行完再执行下一个
1
2
3
hexo init				// 初始化hexo项目
hexo g // 生成静态文件
hexo s // 启动本地服务器

当看到出现一下的输出,就代表Hexo本地服务器构建成功,通过点击生成的连接访问博客网站。

image-20241214012022473

image-20241214013028263

恭喜,到这里你已经成功了一半了!!

剩下的只需要把博客上线到github就完成了。

上线博客

  • 安装hexo提供的上传文件到git的插件
1
npm install hexo-deployer-git --save
  • 回到Blog所在的文件夹,找到根目录下的网站配置文件:_config.yml

    • 在文件的最后,添加上GitHub的配置信息

    image-20241214013719010

    • repo要改成你上面创建的仓库的地地址,这里是以我的项目为示例。(也可以到仓库页面,点击Code,复制HTTPS的内容)
  • 再次在当前文件夹内右键,打开Git Bash Here,在Bash里面依次输入以下命令

    1
    2
    hexo g(生成静态文件)
    hexo d(上传静态文件到你上面配置的仓库)
  • 第一次执行hexo d可能会有弹框需要登录GitHub,正常登录就行。

查看Blog

博客的地址就是之前设置的仓库名:.github.io

赶紧登录看看吧!!

结语

恭喜!!!:clap::clap::clap:

到这里你已经成功搭建好了自己的Blog了,虽然简陋,但是(可能)也是你的第一个Blog,看着自己努力过后的回报,也会给人继续努力的动力。