初识Hexo

hexo是什么

Hexo 是一个快速、简洁且高效的静态博客框架,它基于 Node.js 运行,可以将我们撰写的 Markdown 文档解析渲染成静态的 HTML 网页。

因此我们首先需要下载好node.js——直接通过官网下载即可

mag1code@zhanghaoyangdeMacBook-Air blog % node -v
v22.16.0
mag1code@zhanghaoyangdeMacBook-Air blog % npm -v
10.9.2

创建GitHub pages

GitHub Pages 是由 GitHub 官方提供的一种免费的静态站点托管服务,让我们可以在 GitHub 仓库里托管和发布自己的静态网站页面。

GitHub 主页右上角加号 -> New repository:

  • Repository name 中输入 用户名.github.io
  • 勾选 “Initialize this repository with a README”
  • Description 选填

填好后点击 Create repository 创建。
这样创建后会自动生成HTTPS,博客地址为:https://用户名.github.io

安装hexo

使用npm一键安装hexo应用程序
npm install -g hexo-cli

初始化并安装所以组件

hexo init 
npm install

完成后输入下面命令测试:

hexo clean
hexo g
hexo s

访问 http://localhost:4000,出现 Hexo 默认页面,本地博客安装成功!

部署heox到GitHub page

本地博客测试成功后,就是上传到 GitHub 进行部署,使其能够在网络上访问。
首先安装 hexo-deployer-git:
npm install hexo-deployer-git --save
然后修改 _config.yml 文件末尾的 Deployment 部分,修改成如下:

deploy:
type: git
repository: git@github.com:用户名/用户名.github.io.git
branch: main

完成后通过hexo d将网站上传到部署GitHub Pages。
OVER~,这个时候访问我们的 GitHub域名:用户名.github.io就可以在互联网上看到我们的博客了。

绑定更换域名(非必要)

博客搭建完成使用的是 GitHub 的子域名(用户名.http://github.io),我们可以为 Hexo 博客绑定自己的域名替换 GitHub 域名,更加个性化和专业,也利于 SEO。

开了代理发现hexo d失败
解决办法:
通过sudo rm -rf .deploy_git清除git配置文件的内容,重新hexo d部署上传代码解决了因为代理导致hexo d失败的问题。