如何使用Hexo写文章？

如何使用Hexo写文章？

以下是针对 Hexo + Butterfly 主题的详细文章创建教程：

一、基础文章创建

  1. 新建文章
       - 推荐使用命令生成：
         
    1
         hexo new "文章标题"

         会在 source/_posts 目录生成 .md 文件
       - 或手动创建：
         直接在 source/_posts 新建 文章标题.md
  2. 基础文件格式
1
2
3
4
5
6
7
8
9
10
11
12
13
14
---
title: 你的文章标题
date: 2023-08-20 14:30:00
tags: 
  - 标签1
  - 标签2
categories: 
  - 分类1
  - 子分类1
cover: /images/cover.jpg # 封面图路径
---
<!-- 正文内容 -->
# 这里是文章内容
使用 Markdown 语法编写...

二、Front-matter 进阶配置（Butterfly 主题专属）

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
---
title: 
date: 
updated:  # 最后更新时间
type: # 特殊文章类型（可选）
comments: true # 是否开启评论
mathjax: false # 数学公式支持
top_img: false # 是否显示顶部图
aside: true # 显示侧边栏
toc: true # 显示目录
toc_number: false # 目录自动编号
copyright: true # 显示版权声明
password: # 文章密码
keywords: # SEO关键词
description: # 文章描述

三、分类与标签设置

  1. 创建分类/标签页（首次需要）
       
    1
    2
       hexo new page categories
       hexo new page tags
  2. 修改生成的页面文件
       
    1
    2
    3
    4
    5
       ---
       title: 分类
       date: 2023-08-20 14:30:00
       type: "categories"
       ---
  3. 配置主题配置文件 (_config.butterfly.yml)
       
    1
    2
    3
       menu:
         分类: /categories/ || fas fa-folder-open
         标签: /tags/ || fas fa-tags

四、文章发布流程

  1. 编写完成后本地预览：
       
    1
       hexo clean && hexo s
  2. 生成静态文件：
       
    1
       hexo g
  3. 部署到服务器：
       
    1
       hexo d

五、Butterfly 主题特色功能

  1. 文章置顶：
       
    1
       sticky: 100  # 数值越大越靠前
  2. 文章封面样式：
       
    1
    2
    3
    4
    5
    6
    7
       cover: 
         # 图片路径
         img: /images/cover.jpg
         # 是否暗化
         darken: true 
         # 暗化程度 0-1
         darken_opacity: 0.3
  3. 图库支持：
       
    1
    2
    3
    4
       {% gallery %}
      ![图片描述](url1)
      ![图片描述](url2)
      {% endgallery %}

六、推荐目录结构

1
2
3
4
5
6
7
8
9
source
├── _posts
│   └── 文章.md
├── images
│   └── 文章配图文件夹
├── categories
│   └── index.md
└── tags
    └── index.md

七、常见问题处理

  1. 标签/分类页面404：
       - 确认已执行 hexo new page 命令
       - 检查主题配置中菜单项是否正确
  2. 图片不显示：
       - 使用相对路径时确保开启 post_asset_folder
       - 在配置文件中设置：
         
    1
         post_asset_folder: true
  3. Butterfly 特效不生效：
       - 确保主题版本 ≥ 4.0.0
       - 检查主题配置中的对应功能开关
    建议配合 Hexo 官方文档 (https://hexo.io/zh-cn/docs/) 和 Butterfly 主题文档 (https://butterfly.js.org/) 使用更佳。