hexo使用说明

模板结构分析

你的博客是一个 Hexo 站点，主题是 loststar。主要结构可以分成三部分：

1. 根目录：站点配置和命令
2. source：文章和页面内容
3. loststar：主题模板和样式

1. 根目录文件

_config.yml

这是 Hexo 的全局配置文件，包含：

• 站点标题 title
• 站点描述 description
• 作者 author
• 站点地址 url
• 文章生成规则 permalink
• 主题名 theme: loststar
• 分页、分类、标签等 Hexo 内部设置

你想修改博客基本信息，就改这里：

• title
• subtitle
• description
• author
• url

package.json

这里是项目依赖和常用命令：

• npm run server：本地预览
• npm run build：生成静态文件
• npm run clean：清理 Hexo 缓存

2. 内容目录

_posts

这里是你的文章内容。你现在已有：

• hello-world.md

Hexo 的文章文件通常是 Markdown，并且包含 Front-matter（头部元数据），例如：

1
2
3
4
5
6

---
title: Hello World
date: 2026-05-28 00:00:00
tags:
- 示例
---

你要写新文章，直接在这里添加新的 .md 文件。

scaffolds

这是 Hexo 新文章默认模板。一般你用 hexo new post "标题" 创建文章时，会按这个模板生成内容。

3. 主题目录：loststar

这是你的博客外观和交互逻辑的核心。

_config.yml

这是主题配置文件，决定很多页面效果和主题功能，比如：

• 头像 avatar
• 背景图 background
• 加载图 loading
• 侧边卡片 card
• 菜单导航 menu
• 页脚 footer
• 代码高亮、数学、搜索、评论等开关

你要改“主题风格”、“导航菜单”、“侧边信息”等，基本都改这里。

layout

这里是页面模板：

• layout.ejs：整体页面骨架，头部、主体、底部都在这里组合
• index.ejs：首页
• post.ejs：文章页
• archives.ejs：归档页
• categories.ejs、tags.ejs：分类和标签页
• comment.ejs：评论区
• menu.ejs、footer.ejs：菜单和页脚部分

如果你想修改页面结构、添加新的模块、改变页面布局，就要改这些 .ejs 文件。

source

这个目录放的是主题的前端资源：

• css/main.css
• js/main.js
• images/
• js/lib/ 中的脚本

修改主题样式、动画、交互效果时，通常在这里改。

4. public 文件夹说明

public 是 Hexo 生成出来的静态站点文件，不是你直接编辑的源文件。

• public 由 npm run build 或 hexo generate 生成
• 你平时改的是 source 和 themes，然后重新生成

5. 你该怎么修改

修改博客基本信息

编辑 _config.yml：

• title
• author
• description
• url

修改主题设置

编辑 _config.yml：

• 修改头像、背景图、菜单、版权、功能开关
• 关闭/开启搜索、评论、数学公式、星空效果等

修改页面样式或布局

编辑 themes/loststar/layout/*.ejs 和 main.css

写新文章

在 _posts 新建 .md 文件：

• title
• date
• tags
• 内容用 Markdown 写

预览网站

在根目录运行：

• npm install（如果你还没安装依赖）
• npm run server
  然后打开浏览器看本地效果

6. 你现在可以先做的两件事

1. 打开 _config.yml，把 avatar、menu、footer 改成你自己的
2. 在 _posts 里新建一篇 Markdown 文章，写一句简单的内容

如果你愿意，我可以继续帮你：

• 讲解 _config.yml 每个配置项的含义
• 给你一个适合这个主题的首页和文章模板
• 帮你搭建“关于我”页面和“归档页”内容