hexo 博客系统搭建和配置

记录一下 hexo 的安装和配置，以及一些常用命令

Hexo 安装和配置

hexo 官网文档

前置要求

• Git: brew install git
• nodejs：
  • 最低要求版本 Node.js 10.13, 推荐版本 12.0 或更高
  • 使用 brew 安装 nodejs: brew install node
  • 2022年11月18日安装版本: v19.1.0

安装 hexo 博客框架

安装命令: npm install hexo-cli -g

初始化博客目录: hexo init blog

进入目录: cd blog

安装依赖: npm install

开启 hexo 服务: hexo server

之后即可在 http://localhost:4000 看到预览页面

hexo 常用命令

hexo new "name"       # 新建文章
hexo new page "name"  # 新建页面 hexo new [layout] <title>, post 是默认的 layout
hexo g                # 生成页面 hexo generate
hexo d                # 部署 hexo deploy
hexo g -d             # 生成页面并部署
hexo s                # 本地预览 hexo server
hexo clean            # 清除缓存和已生成的静态文件
hexo help             # 帮助

目录介绍

在 _config.yml 内定义，具体参考 https://hexo.io/docs/configuration

• source 目录为存放 Markdown 文档等目录
• public 生成的静态站点文件所在目录
• scaffolds 目录下是模板文件，不同layout对应不同的文件

Layout	Path	scaffolds
post	source/_post	post.md
page	source	page.md
draft	source/_drafts	draft.md

部署Github Pages

为了方便部署，安装 hexo-deployer-git
npm install hexo-deployer-git --save

然后配置 .config.yml

deploy:
  type: git
  repo: git@github.com:xiaosong97/xiaosong97.github.io.git
  branch: main

之后使用 hexo d 即可部署

注：repo 配置使用的是 ssh 的方式进行连接（将ssh公钥正确添加到 github 账户），这样只要在本地能够用 ssh 连接到 github，就可以完成部署，而不会发生因为鉴权失败导致的部署失败

打赏