项目目录结构设计方案

[deepracticexs]

DeepracticeX 目录结构设计

项目定位

• 项目名称: DeepracticeX
• 一句话介绍: Everything of Deepractice
• 核心定位: deepractice.ai 的内容平台，包含博客、研究、社区、资源等所有内容

目录结构设计

DeepracticeX/
├── blog/                    # 博客文章（时间驱动的内容）
│   ├── 2025-01-26-xxx.md   # 技术洞察、公司动态等
│   └── authors.yml          # 作者信息
│
├── docs/                    # 结构化文档（主题驱动的内容）
│   ├── research/           # 研究内容
│   │   ├── monogent/      # Monogent 理论体系
│   │   ├── dpml/          # DPML 协议
│   │   └── pateoas/       # PATEOAS 架构
│   │
│   ├── products/          # 产品文档
│   │   ├── promptx/       # PromptX 文档
│   │   └── future/        # 未来产品
│   │
│   ├── community/         # 社区内容（重点板块）
│   │   ├── conversations/ # 聊天记录精华
│   │   ├── showcases/     # 用户案例
│   │   ├── contributions/ # 社区贡献
│   │   └── events/        # 社区活动
│   │
│   └── resources/         # 资源中心
│       ├── prompts/       # Prompt 示例
│       ├── tutorials/     # 教程
│       └── tools/         # 工具推荐
│
├── src/                   # 源代码
│   ├── pages/            # 自定义页面
│   ├── components/       # 自定义组件
│   └── css/             # 样式文件
│
├── static/               # 静态资源
│   ├── img/             # 图片
│   └── data/            # 数据文件
│
└── i18n/                # 国际化（中英文）

关键设计决策

1. blog vs docs 的区分

• blog: 时效性内容，按时间组织
• docs: 永久性内容，按主题组织

2. community 作为核心板块

• 聊天记录、用户案例、社区贡献统一放在 community 下
• 体现"Everything of Deepractice"的理念

3. 多语言支持

• 使用 Docusaurus 的 i18n 功能
• 优先中文，核心内容提供英文版

4. 技术选型

• 框架: Docusaurus 2.x
• 部署: Vercel/GitHub Pages
• 协议: CC BY 4.0（内容）+ MIT（代码）

下一步行动

1. 初始化 Docusaurus 项目
2. 配置基础目录结构
3. 迁移现有内容（从 Website 项目）
4. 设计视觉主题（延续紫色主题）

---

相关讨论: ContradictionManagement 项目中的对话记录

[deepracticexs]

🔄 导航结构更新

基于实际使用体验，我们对导航结构进行了优化：

新的顶部导航设计

[DeepracticeX]  首页  博客  产品  社区  GitHub

目录结构调整

docs/
├── products/          # 产品文档（包含 PromptX 等）
├── research/          # 研究内容（作为产品侧边栏的一部分）
├── community/         # 社区内容（独立侧边栏）
└── resources/         # 资源中心（作为产品侧边栏的一部分）

侧边栏设计

1. 产品侧边栏 (productSidebar)

   • 产品概览
   • PromptX
   • 研究
   • 资源

2. 社区侧边栏 (communitySidebar)

   • 社区首页
   • 精彩对话
   • 用户案例
   • 贡献指南

改进点

• ✅ 更清晰的信息架构
• ✅ 产品和社区独立管理
• ✅ 符合用户导航习惯
• ✅ 便于未来扩展

相关 commit: 37619f8