📚 Docs 项目介绍

Hey，同学！想拥有一个专业的技术文档站点吗？这一篇给你介绍 iFluxArt 的文档系统～ 📖

🤔 Docs 是干嘛的？

Docs 是 iFluxArt 的文档发布系统，专门为技术文档、知识库、API 参考等场景设计。

🏗️ 项目定位

✨ 核心功能

📝 MDX 写作

• 完整的 Markdown 语法
• React 组件支持
• 自定义 MDX 组件库

📂 分类管理

• 文件夹层级结构
• _meta.json 配置导航
• 自动目录生成

🔍 搜索功能

• 全文搜索
• 搜索结果高亮
• 快速定位

🏷️ 标签系统

• 标签云展示
• 标签筛选
• 相关文档推荐

💬 互动功能

• Giscus 评论
• 页面反馈

🔎 SEO 优化

• Meta 标签
• Sitemap
• 结构化数据

🔧 技术设计

为什么选择 MDX？

MDX 让文档既保持 Markdown 的简洁，又有 React 的强大：

# 安装指南

按照以下步骤安装：

<Steps>
  <Step>
    安装依赖：`pnpm install`
  </Step>
  <Step>
    配置环境变量
  </Step>
</Steps>

> 💡 提示：推荐使用 pnpm！

组件系统

Docs 内置了丰富的 MDX 组件：

🎯 适用场景

📊 与其他项目的关系

Web (入口)
   │
   └──🔗 链接──→ Docs (文档)
                  │
                  └──💬 Giscus (评论)
                  │
                  └──🔍 搜索服务
                  │
                  └──🗂️ 文件系统

📖 下一步

• 创建文档 —— 开始写文档
• MDX 组件 —— 组件使用指南
• 分类管理 —— 组织文档结构
• 搜索功能 —— 配置搜索