hexo 使用及命令

Hexo 命令

Hexo 是一个快速、简洁且高效的博客框架。它使用 Markdown 编辑文章,在几秒内,即可利用靓丽的主题生成静态网页。

安装

安装 Hexo 相当简单,只需要先安装下列应用程序即可:

  • Node.js (Node.js 版本需不低于 10.13,建议使用 Node.js 12.0 及以上版本)
  • Git

安装完毕后,运行以下命令安装 Hexo:

1
npm install hexo

创建博客

安装完毕后,运行以下命令创建博客:

1
hexo init <博客名称>

例如,创建一个名为 “我的博客” 的博客:

1
hexo init 我的博客

这将在当前目录下创建一个名为 “我的博客” 的文件夹,该文件夹包含 Hexo 所需的所有文件和目录。

编写文章

Hexo 使用 Markdown 编辑文章。Markdown 是一种轻量级标记语言,可以使用易读易写的纯文本格式来编写文档,然后转换成有效的 HTML 文档。

要编写文章,只需在 source/_posts 目录下创建一个新文件,文件名必须以 YYYY-MM-DD-标题.md 的格式命名。例如,创建一篇名为 “我的第一篇文章” 的文章:

1
hexo new posts/2023-11-26-我的第一篇文章.md

打开 posts/2023-11-26-我的第一篇文章.md 文件,编写文章内容:

1
2
3
# 我的第一篇文章

这是我的第一篇文章。

生成静态网页

编写完文章后,运行以下命令生成静态网页:

1
hexo generate

这将在 public 目录下生成静态网页。

启动本地服务

要启动本地服务,运行以下命令:

1
hexo server

这将在本地端口 4000 上启动一个 HTTP 服务。

部署到线上

要将博客部署到线上,可以使用 GitHub Pages 或其他静态网站托管服务。

GitHub Pages

要将博客部署到 GitHub Pages,需要在 GitHub 上创建一个仓库,并将仓库的根目录设置为 Hexo 项目的根目录。然后,在仓库的 README.md 文件中添加以下内容:

1
2
3
4
---
title: 我的博客
description: 我的博客
---

最后,将仓库设置为 GitHub Pages 的博客:

1
2
git remote add origin git@github.com:<用户名>/<仓库名>.git
git push origin master

其他静态网站托管服务

其他静态网站托管服务的部署方式各不相同,请参考相关文档进行设置。

常用命令

Hexo 提供了许多常用命令,可以帮助开发者快速完成各种操作。

命令 说明
hexo init <博客名称> 创建博客
hexo new <文件类型> <文件名> 创建新文件
hexo generate 生成静态网页
hexo server 启动本地服务
hexo clean 清除缓存
hexo publish 发布博客