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,开始您的博客之旅!