doc-render-sdk 0.0.1 → 0.0.3
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 +10 -98
- package/dist/index.d.mts +697 -0
- package/dist/index.d.mts.map +1 -0
- package/dist/index.mjs +3274 -895
- package/dist/index.mjs.map +1 -0
- package/package.json +21 -23
- package/bin/doc-sdk.js +0 -348
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# 文档渲染SDK
|
|
2
2
|
|
|
3
|
-
一个专门用于渲染组件文档站点的SDK
|
|
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
|
|