Hexo 静态博客框架使用指南
Hexo 是一个快速、简洁且高效的静态博客框架,基于 Node.js 开发。它可以将 Markdown 文档快速转换成静态网页,并支持多种主题和插件。本文将介绍 Hexo 的基本使用方法。
一、安装 Hexo
1. 安装前提
在安装 Hexo 之前,您需要先安装以下两个工具:
2. 安装 Hexo CLI
安装好上述工具后,通过 npm 安装 Hexo 命令行工具:
npm install -g hexo-cli
二、创建新项目
1. 初始化博客
在您选择的目录下运行以下命令:
hexo init my-blog
cd my-blog
npm install
2. 目录结构
初始化后,项目目录结构如下:
.
├── _config.yml # 网站配置文件
├── package.json # 应用程序信息
├── scaffolds # 模板文件夹
├── source # 源文件目录
| ├── _drafts # 草稿
| └── _posts # 文章
└── themes # 主题目录
三、基本使用
1. 创建新文章
hexo new "文章标题"
文章会创建在 source/_posts
目录下,使用 Markdown 格式编写。
2. 本地预览
hexo server
# 或简写为
hexo s
启动后,在浏览器中访问 http://localhost:4000
查看效果。
3. 生成静态文件
hexo generate
# 或简写为
hexo g
生成的静态文件会放在 public
目录中。
4. 部署到服务器
hexo deploy
# 或简写为
hexo d
注意:部署前需要配置 _config.yml
中的 deploy 部分。
四、配置网站
编辑 _config.yml
文件可以配置网站的基本信息:
# 网站信息
title: 我的博客
subtitle: 欢迎来到我的博客
description: 这里是我的个人空间
author: 你的名字
language: zh-CN
timezone: Asia/Shanghai
# 部署设置
deploy:
type: git
repo: <repository url>
branch: [branch]
五、主题安装与使用
1. 安装主题
以 NexT 主题为例:
git clone https://github.com/theme-next/hexo-theme-next themes/next
2. 启用主题
修改 _config.yml
:
theme: next
3. 更新主题
进入主题目录并拉取更新:
cd themes/next
git pull
六、常用插件
Hexo 支持丰富的插件系统,常用插件包括:
hexo-deployer-git: Git 部署插件
npm install hexo-deployer-git --save
hexo-generator-feed: 生成 RSS 订阅
npm install hexo-generator-feed --save
hexo-generator-sitemap: 生成站点地图
npm install hexo-generator-sitemap --save
七、高级功能
1. 草稿功能
创建草稿:
hexo new draft "草稿标题"
发布草稿:
hexo publish "草稿标题"
2. 自定义页面
hexo new page "about"
3. 资源文件夹
在 _config.yml
中启用:
post_asset_folder: true
八、部署到 GitHub Pages
安装部署插件:
npm install hexo-deployer-git --save
配置
_config.yml
:deploy: type: git repo: https://github.com/username/username.github.io.git branch: master
部署:
hexo clean && hexo deploy
九、常用命令总结
命令 | 描述 |
---|---|
hexo new "标题" | 创建新文章 |
hexo server | 启动本地服务器 |
hexo generate | 生成静态文件 |
hexo deploy | 部署网站 |
hexo clean | 清除缓存和生成的文件 |
Hexo 是一个功能强大且灵活的静态博客框架,通过简单的 Markdown 编写和命令操作,您可以快速搭建并维护一个专业的博客网站。随着对 Hexo 的深入了解,您可以探索更多高级功能和自定义选项来打造独特的个人博客。