Hans的资讯博客

深度学习、机器学习、AI开发技术分享

Hexo 使用手册

发表于 分类于 ， 本文字数： 673 阅读时长 ≈ 2 分钟
详细介绍如何使用 Hexo 创建和管理博客，包括安装、初始化、创建文章、预览和发布的完整流程。

使用 Hexo 创建 Markdown 文件的过程非常简单，Hexo 提供了命令行工具，帮助你快速生成新的文章文件。以下是详细的操作步骤：

1. 确保 Hexo 已安装

如果还没有安装 Hexo，请确保你的环境中已安装 Node.js 和 npm，然后通过以下命令安装 Hexo：

1
npm install -g hexo-cli

安装完成后，在终端中运行以下命令，验证 Hexo 是否安装成功：

1
hexo -v

2. 初始化 Hexo 博客项目

如果你还没有初始化 Hexo 项目，可以使用以下命令：

1
2
3
hexo init my-blog
cd my-blog
npm install

现在你的 Hexo 博客目录已经准备好，主要结构如下：

  • source/_posts/：存放 Markdown 文件的目录。
  • _config.yml：Hexo 配置文件。
  • themes/：主题文件目录。

3. 使用 Hexo 命令创建 Markdown 文件

运行以下命令，在 source/_posts/ 目录下生成一篇新的文章：

1
hexo new "文章标题"
  • 例子：
1
hexo new "My First Blog"

执行后，Hexo 会在 source/_posts/ 目录下创建一个名为 my-first-blog.md 的文件。

4. 编辑 Markdown 文件

找到生成的 .md 文件（例如 source/_posts/my-first-blog.md），打开它，你会看到 Hexo 默认生成的内容格式：

1
2
3
4
5
---
title: My First Blog
date: 2024-12-18 12:00:00
tags:
---

你可以编辑以下部分：

  1. title：文章标题。
  2. date：发布时间，Hexo 会自动生成当前时间。
  3. tags：可以为文章设置多个标签（以数组形式表示）。

之后，你可以在 YAML 头信息下面用 Markdown 语法撰写你的文章内容。

5. 本地预览文章

编辑完成后，可以在本地启动 Hexo 服务器来预览效果：

1
hexo server
  • 打开浏览器，访问 http://localhost:4000，查看你的博客内容。

6. 发布文章

当文章编辑完成且预览没有问题后，可以用以下命令生成静态文件并发布：

1
2
hexo generate
hexo deploy

这两步需要在 _config.yml 中正确配置你的部署信息（如 GitHub Pages）。

7. 快捷命令总结

命令 功能
hexo new "title" 创建新文章
hexo server 本地启动预览
hexo generate 生成静态文件
hexo deploy 部署博客

8. 小技巧

  • 如果你需要创建一个页面（比如关于页面），可以用以下命令
1
hexo new page "about"

文件会被生成在 source/about/index.md。

  • 文章可以根据标签或分类进行组织，灵活使用 categories 和 tags 会让你的博客更清晰。

完成以上步骤后，你的 Hexo 博客已经可以流畅运行并生成 Markdown 文章文件。

参考更多关于 Hexo 的信息，请访问 Hexo 官方网站。