Skip to content

项目目录结构设计方案 #1

@deepracticexs

Description

@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 项目中的对话记录

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions