DocsBlogDocsBlog
Log in

博客文章、文档、社交媒体数据的管理方式

内容管理

博客文章

文件位置

博客文章以 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内容类型(如 articletutorialnews
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 中使用相对路径引用:

![图片描述](/images/blog/my-image.png)

对应文件位于 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 文件。