博客文章、文档、社交媒体数据的管理方式
内容管理
博客文章
文件位置
博客文章以 MDX 格式存放在 content/blog/ 目录下,按语言分目录:
content/blog/en/— 英文文章content/blog/zh-hans/— 中文文章
每篇文章为一个 .mdx 文件,文件名即为 URL slug。
Frontmatter 字段
每篇文章顶部需要包含 YAML frontmatter:
---
title: 文章标题
description: 文章摘要描述
date: 2025-01-15
categories:
- blockchain
- defi
tags:
- ethereum
- layer2
author: frank
cover: /images/blog/my-cover.jpg
contentType: article
draft: false
---| 字段 | 必填 | 说明 |
|---|---|---|
title | 是 | 文章标题 |
description | 是 | 摘要描述,用于列表页和 SEO |
date | 是 | 发布日期,格式 YYYY-MM-DD |
categories | 否 | 分类数组,引用分类注册表中的 slug |
tags | 否 | 标签数组 |
author | 否 | 作者 slug,引用 src/config/authors.ts 中的作者 |
cover | 否 | 封面图片路径 |
contentType | 否 | 内容类型(如 article、tutorial、news) |
draft | 否 | 设为 true 则不在列表页显示 |
文章正文
Frontmatter 下方即为 MDX 正文内容,支持标准 Markdown 语法和 React 组件。
文档
文件位置
文档同样以 MDX 格式存放,按语言分目录:
content/docs/en/— 英文文档content/docs/zh-hans/— 中文文档
侧边栏导航
每个文档目录下的 meta.json 文件控制侧边栏导航结构和页面排序:
{
"title": "文档",
"pages": [
"index",
"getting-started",
"configuration"
]
}pages 数组定义了文档页面的显示顺序,每个值对应同级目录下的 .mdx 文件名(不含扩展名)。子目录也可以作为 pages 的一项,实现嵌套导航。
图片使用
图片文件放在 public/ 目录下,在 MDX 中使用相对路径引用:
对应文件位于 public/images/blog/my-image.png。
建议按模块组织图片目录:
public/
└── images/
├── blog/ # 博客文章图片
├── docs/ # 文档图片
└── icons/ # 图标Twitter 数据
Twitter/X 账号数据存放在 content/twitters/ 目录下,每个账号一个 JSON 文件。文件包含账号的基本信息(用户名、显示名、头像、简介、分类等)。
可通过后台 /admin/twitter 界面管理,也可以直接编辑 JSON 文件。
YouTube 数据
YouTube 频道数据存放在 content/youtubes/ 目录下,每个频道一个 JSON 文件。文件包含频道的基本信息(频道名、头像、简介、订阅数、分类等)。
可通过后台 /admin/youtube 界面管理,也可以直接编辑 JSON 文件。