doc-render-sdk 0.0.1 → 0.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # 文档渲染SDK
2
2
 
3
- 一个专门用于渲染组件文档站点的SDK,从原有的doc目录抽象而来。
3
+ 一个专门用于渲染组件文档站点的SDK
4
4
 
5
5
  ## 特性
6
6
 
@@ -18,13 +18,13 @@
18
18
  ### 安装
19
19
 
20
20
  ```bash
21
- npm install doc-sdk
21
+ npm install doc-render-sdk
22
22
  ```
23
23
 
24
24
  ### 基本使用
25
25
 
26
26
  ```javascript
27
- import DocSDK from 'doc-sdk';
27
+ import DocSDK from 'doc-render-sdk';
28
28
 
29
29
  const docSdk = new DocSDK({
30
30
  title: '我的组件库文档',
@@ -52,100 +52,18 @@ const docSdk = new DocSDK({
52
52
  docSdk.render('#app');
53
53
  ```
54
54
 
55
- ## 架构设计
56
-
57
- ### 核心模块
58
-
59
- - **DocRenderer** - 文档渲染器核心
60
- - **ConfigManager** - 配置管理器
61
- - **ComponentRegistry** - 组件注册表
62
- - **ThemeManager** - 主题管理器
63
- - **PluginManager** - 插件管理器
64
- - **RouterManager** - 路由管理器
65
-
66
- ### 组件系统
67
-
68
- - **Layout** - 布局组件
69
- - **Navigation** - 导航组件
70
- - **Demo** - 演示组件
71
- - **ApiDoc** - API文档组件
72
- - **CodeBlock** - 代码块组件
73
- - **Search** - 搜索组件
74
-
75
- ## 目录结构
76
-
77
- ```
78
- doc-sdk/
79
- ├── src/
80
- │ ├── core/ # 核心模块
81
- │ │ ├── DocRenderer.js # 文档渲染器
82
- │ │ ├── ConfigManager.js # 配置管理器
83
- │ │ ├── ComponentRegistry.js # 组件注册表
84
- │ │ ├── ThemeManager.js # 主题管理器
85
- │ │ ├── PluginManager.js # 插件管理器
86
- │ │ └── RouterManager.js # 路由管理器
87
- │ ├── components/ # 文档组件
88
- │ │ ├── Layout.jsx # 主布局组件
89
- │ │ ├── Navigation.jsx # 导航组件
90
- │ │ ├── Header.jsx # 头部组件
91
- │ │ ├── Content.jsx # 内容组件
92
- │ │ ├── Demo.jsx # Demo展示组件
93
- │ │ ├── ApiDoc.jsx # API文档组件
94
- │ │ ├── CodeBlock.jsx # 代码块组件
95
- │ │ ├── Search.jsx # 搜索组件
96
- │ │ ├── Home.jsx # 首页组件
97
- │ │ └── Footer.jsx # 页脚组件
98
- │ ├── themes/ # 主题文件
99
- │ │ └── default.js # 默认主题
100
- │ ├── config/ # 配置文件
101
- │ │ └── default.js # 默认配置
102
- │ ├── utils/ # 工具函数
103
- │ │ └── index.js # 工具函数集合
104
- │ └── index.js # 入口文件
105
- ├── bin/ # CLI工具
106
- │ └── doc-sdk.js # 命令行工具
107
- ├── tools/ # 构建工具
108
- │ └── migrate.js # 迁移工具
109
- ├── examples/ # 示例项目
110
- │ ├── index.html # 示例HTML
111
- │ └── index.js # 示例配置
112
- ├── lib/ # CommonJS构建输出
113
- ├── es/ # ES模块构建输出
114
- ├── docs-new/ # 迁移示例
115
- └── README.md # 说明文档
116
- ```
117
-
118
- ## 🎯 设计理念
119
-
120
- ### 核心原则
121
-
122
- 1. **组件化架构** - 高度模块化,每个功能都是独立的组件
123
- 2. **配置驱动** - 通过配置文件控制所有行为,减少硬编码
124
- 3. **主题化设计** - 支持深度定制,满足不同项目需求
125
- 4. **插件扩展** - 提供插件系统,支持功能扩展
126
- 5. **开发友好** - 提供完整的开发工具链和迁移工具
127
-
128
- ### 技术栈
129
-
130
- - **React** - 组件渲染
131
- - **Webpack** - 模块打包
132
- - **Babel** - 代码转换
133
- - **Less/CSS** - 样式处理
134
- - **Highlight.js** - 代码高亮
135
- - **Mini-event** - 事件系统
136
-
137
55
  ## 🚀 快速开始
138
56
 
139
57
  ### 安装
140
58
 
141
59
  ```bash
142
- npm install doc-sdk
60
+ npm install doc-render-sdk
143
61
  ```
144
62
 
145
63
  ### 基本使用
146
64
 
147
65
  ```javascript
148
- import DocSDK from 'doc-sdk';
66
+ import DocSDK from 'doc-render-sdk';
149
67
 
150
68
  const docSdk = new DocSDK({
151
69
  title: '我的组件库',
@@ -172,20 +90,20 @@ const docSdk = new DocSDK({
172
90
  docSdk.render('#app');
173
91
  ```
174
92
 
175
- ### CLI 工具
93
+ ### CLI 工具 (待支持)
176
94
 
177
95
  ```bash
178
96
  # 创建新项目
179
- npx doc-sdk create my-docs
97
+ npx doc-render-sdk create my-docs
180
98
 
181
99
  # 启动开发服务器
182
- npx doc-sdk dev
100
+ npx doc-render-sdk dev
183
101
 
184
102
  # 构建项目
185
- npx doc-sdk build
103
+ npx doc-render-sdk build
186
104
 
187
105
  # 迁移旧项目
188
- npx doc-sdk migrate --source ./doc --target ./docs-new
106
+ npx doc-render-sdk migrate --source ./doc --target ./docs-new
189
107
  ```
190
108
 
191
109
  ## 📚 详细文档
@@ -225,12 +143,6 @@ const config = {
225
143
  apis: [...]
226
144
  }
227
145
  },
228
-
229
- // 搜索配置
230
- search: {
231
- enabled: true,
232
- placeholder: '搜索...'
233
- }
234
146
  };
235
147
  ```
236
148