Hexo博客框架入门教程

Hexo是一个快速、简洁且高效的博客框架，使用Node.js开发，让您可以专注于写作而不必关心太多技术细节。本文将介绍如何从零开始搭建一个Hexo博客。

一、环境准备

在开始之前，您需要安装以下软件：

1. Node.js

Hexo基于Node.js运行，所以首先需要安装Node.js和npm（Node.js的包管理器）。

1
2
3
# 查看是否安装成功
node -v
npm -v

2. Git

Git用于部署博客到GitHub Pages等远程服务器，以及安装主题等。

1
2
# 查看是否安装成功
git --version

二、安装Hexo

使用npm全局安装Hexo命令行工具：

1
npm install -g hexo-cli

三、创建博客

1. 初始化博客

1
2
3
4
# 创建博客文件夹并初始化
hexo init blog
cd blog
npm install

2. 目录结构

1
2
3
4
5
6
7
8
.
├── _config.yml     # 网站配置文件
├── package.json    # 应用程序信息
├── scaffolds       # 模版文件夹
├── source          # 存放用户资源的地方
|   ├── _drafts     # 草稿箱
|   └── _posts      # 文章
└── themes          # 主题文件夹

四、基本配置

编辑_config.yml文件，设置网站的基本信息：

1
2
3
4
5
6
7
8
9
10
11
# 网站
title: 我的个人博客
subtitle: '副标题'
description: '网站描述'
keywords: 关键词
author: 作者名
language: zh-CN
timezone: 'Asia/Shanghai'

# URL
url: http://yoursite.com

五、创建文章

1
hexo new "文章标题"

这将在source/_posts目录下创建一个新的Markdown文件，您可以使用任意Markdown编辑器编辑它。

六、本地预览

1
hexo server

执行后，可以通过http://localhost:4000访问您的博客。

七、安装主题

Hexo默认主题是landscape，您也可以安装其他主题：

1
git clone https://github.com/theme-next/hexo-theme-next themes/next

然后修改_config.yml中的theme配置：

1
theme: next

八、部署博客

1. 安装部署插件

1
npm install hexo-deployer-git --save

2. 配置部署信息

编辑_config.yml：

1
2
3
4
deploy:
  type: git
  repo: https://github.com/用户名/用户名.github.io.git
  branch: master

3. 生成静态文件并部署

1
2
3
hexo clean    # 清除缓存
hexo generate  # 生成静态文件
hexo deploy    # 部署到远程服务器

九、常用命令

1
2
3
4
5
6
hexo new "标题"     # 创建新文章
hexo new page "页面" # 创建新页面
hexo generate       # 生成静态文件
hexo server         # 本地预览
hexo deploy         # 部署
hexo clean          # 清除缓存和已生成的静态文件

十、进阶使用

  1. 添加分类和标签：在文章的Front-matter中添加categories和tags。
  2. 创建自定义页面：如关于页面、分类页面等。
  3. 添加插件：如搜索功能、评论系统、数据统计等。
  4. 自定义主题：修改CSS、模板等。

结语

Hexo是一个非常强大的静态博客框架，通过简单的配置就能搭建出自己的个人博客。希望本教程能帮助您快速上手Hexo，开始您的博客之旅！