about-hexo

Usage

一、创建 Hexo 站点

# 全局安装 Hexo CLI
npm install -g hexo-cli

# 初始化博客项目
hexo init myblog
cd myblog

# 安装依赖
npm install

---

二、文章管理

1. 创建新文章

# 基础命令（默认生成到 source/_posts/）
hexo new "文章标题"

# 指定自定义路径（自动创建目录）
hexo new "技术笔记/Hexo使用指南" --path tech/hexo-guide.md

# 指定布局（默认为 post）
hexo new "关于我" --layout page

2. 删除文章

# 直接删除 Markdown 源文件
rm source/_posts/文章标题.md

# 清理缓存并重新生成
hexo clean && hexo generate

3. 草稿管理

# 创建草稿（保存到 source/_drafts/）
hexo new draft "未完成的草稿"

# 发布草稿（移动到 _posts 目录）
hexo publish draft "未完成的草稿"

---

三、本地操作

1. 启动本地服务器

# 默认访问 http://localhost:4000
hexo server

# 带实时重载和调试模式
hexo server --debug --draft  # --draft 显示草稿

2. 生成静态文件

# 生成到 public/ 目录
hexo generate

# 强制重新生成（文件有变化时建议使用）
hexo generate --watch  # 监听文件变动

---

四、部署到服务器

# 安装 Git 部署插件
npm install hexo-deployer-git --save

# 配置 _config.yml
deploy:
  type: git
  repo: git@your-server.com:/path/to/repo.git
  branch: main

# 执行部署（自动生成并推送）
hexo deploy

---

五、常用进阶操作

1. 主题管理

# 通过 Git 子模块安装主题（推荐）
git submodule add https://github.com/theme-name/hexo-theme.git themes/theme-name

# 更新主题
cd themes/theme-name
git pull origin master

2. 插件管理

# 安装插件（以 RSS 生成插件为例）
npm install hexo-generator-feed --save

# 卸载插件
npm uninstall hexo-generator-feed --save

3. 数据清理

# 清除缓存文件和已生成的静态文件
hexo clean

# 删除 node_modules 重新安装
rm -rf node_modules && npm install

---

六、实用技巧

1. Front-Matter 配置

在文章 Markdown 文件头部添加元数据：

---
title: 文章标题
date: 2023-08-20 14:00:00
tags:
  - Hexo
  - 教程
categories: 技术文档
cover: /images/cover.jpg
---

2. 多设备同步

1. 将整个 Hexo 目录纳入 Git 仓库
2. 忽略 public/ 和 node_modules/：

   /public/
   /node_modules/
   .DS_Store

3. 其他设备克隆后运行：

   npm install
   git submodule update --init  # 若使用子模块主题

3. 快捷命令

# 生成+部署组合命令
hexo generate && hexo deploy

# 新建文章后直接启动服务器
hexo new "新文章" && hexo server

---

七、常见问题处理

1. 页面未更新：

   hexo clean && hexo generate

2. 部署失败：

   • 检查服务器 Git 仓库权限
   • 确认 SSH 密钥已配置

3. 主题不生效：

   • 检查 _config.yml 的 theme 配置
   • 确保主题目录存在