Skip to content

Commit e5354d6

Browse files
committed
fix: 更新文档
1 parent 9cf62e3 commit e5354d6

File tree

3 files changed

+116
-92
lines changed

3 files changed

+116
-92
lines changed

packages/beidou-webpack/README-ZH.md

+58-45
Original file line numberDiff line numberDiff line change
@@ -189,6 +189,26 @@ module.exports = (app, defaultConfig, dev, target) => {
189189
};
190190
```
191191

192+
> Class Plugin Struct
193+
```
194+
class Plugin {
195+
object , // instance object for webpack plugin
196+
class, // class for webpack plugin
197+
opitons, // initialize config
198+
alias
199+
}
200+
201+
```
202+
203+
> Class Rule Struct
204+
```
205+
class Rule {
206+
opitons, // initialize config for rule
207+
alias
208+
}
209+
210+
```
211+
192212
> app.webpackFactory 提供的函数如下:
193213
194214
### 重置配置项: reset(value)
@@ -213,106 +233,99 @@ module.exports = (app, defaultConfig, dev, target) => {
213233
#### return
214234
* {*}
215235

216-
### 获取{param}配置实例: env(param)
236+
### 获取{key}配置实例: env(key)
217237
#### Parameters
218-
* param {String} 配置实例标识
238+
* key {String} 配置实例标识
219239

220240
#### return
221241
* {Object}
222242

223243
### 获取webpack配置: getConfig()
224244
#### Parameters
225-
* key {String}
226245

227246
#### return
228-
* value {*}
247+
* {Object}
229248

230249

231-
### 增加插件配置: addPlugin(params1, params2,params3)
250+
### 增加插件配置: addPlugin(args, options,alias)
232251
#### Parameters
233-
* params1 {Object|Class|String} 插件实例|构造函数|已定义的插件名
234-
* [params1] {Object} 插件配置项
235-
* [params2] {String} 插件别名
252+
* args {Object|Class|String} 插件实例|构造函数|已定义的插件名
253+
* [options] {Object} 插件配置项
254+
* [alias] {String} 插件别名
236255

237256
#### return
238257
* this
239258

240259

241-
### getPlugin(params1) 获取插件配置
260+
### getPlugin(filter) 获取插件配置
242261
#### Parameters
243-
* params1 {String|Function} 别名|自定义函数
262+
* filter {String|Function} 别名|自定义函数
244263

245264
#### return
246-
* {Object}
265+
* {Plugin}
247266

248-
### 设置插件配置: setPlugin(params1, params2,params3)
267+
### 设置插件配置: setPlugin(args, options,alias)
249268

250269
#### Parameter
251-
* params1 {Object|Class} 插件实例|构造函数
252-
* [params1] {Object} 插件配置项
253-
* [params2] {String} 插件别名
270+
* args {Object|Class} 插件实例|构造函数
271+
* [options] {Object} 插件配置项
272+
* [alias] {String} 插件别名
254273

255274
#### return
256275
* this
257276

258-
### 定义插件: definePlugin(params1, params2,params3)
277+
### 定义插件: definePlugin(args, options,alias)
259278
#### Parameters
260-
* params1 {Object|Class} 插件实例|构造函数
261-
* [params1] {Object} 插件配置项
262-
* [params2] {String} 插件别名
279+
* args {Object|Class} 插件实例|构造函数
280+
* [options] {Object} 插件配置项
281+
* [alias] {String} 插件别名
263282
#### return
264283
* this
265284

266-
### 获取定义的插件: usePlugin(params1)
285+
### 获取定义的插件: usePlugin(alias)
267286
#### Parameters
268-
* params1 {String} 插件别名
287+
* alias {String} 插件别名
269288
#### return
270-
* {Object}
289+
* {Plugin}
271290

272-
### 增加配置规则: addRule(params1,params2)
273-
#### Parameters
274-
* params1 {Object} 配置项
275-
* [params2] {String} 别名
276-
#### return
277-
* this
278291

279-
### 设置配置规则: addRule(params1,params2)
292+
### 设置配置规则: addRule(options,alias)
280293
#### Parameters
281-
* params1 {Object} 配置项
282-
* [params2] {String} 别名
294+
* options {Object} 配置项
295+
* [alias] {String} 别名
283296
#### return
284297
* this
285298

286-
### 获取配置规则: getRule(params1)
299+
### 获取配置规则: getRule(filter)
287300
#### Parameters
288-
* params1 {String|Function} 配置项|自定义函数
301+
* filter {String|Function} 配置项|自定义函数
289302
#### return
290-
* {Object}
303+
* {Rule}
291304

292-
### 定义配置规则: defineRule(params1,params2)
305+
### 定义配置规则: defineRule(options,alias)
293306
#### Parameters
294-
* params1 {Object} 配置项
295-
* [params2] {String} 别名
307+
* options {Object} 配置项
308+
* [alias] {String} 别名
296309
#### return
297310
* this
298311

299-
### 获取定义的配置规则: usePlugin(params1)
312+
### 获取定义的配置规则: useRule(alias)
300313
#### Parameters
301-
* params1 {String} 别名
314+
* alias {String} 别名
302315

303316
#### return
304-
* {Object}
317+
* {Rule}
305318

306-
### 定义Loader: defineLoader(params1,params2)
319+
### 定义Loader: defineLoader(alias,loader)
307320
#### Parameters
308-
* params1 {String} 别名
309-
* [params2] {String} 路径,默认值为 require.resolve(params1)
321+
* alias {String} 别名
322+
* [loader] {String} 路径,默认值为 require.resolve(params1)
310323
#### return
311324
* this
312325

313-
### 获取定义Loader: useLoader(params1)
326+
### 获取定义Loader: useLoader(alias)
314327
#### Parameters
315-
* params1 {String} 别名
328+
* alias {String} 别名
316329
#### return
317330
* {path}
318331

packages/beidou-webpack/README.md

+58-47
Original file line numberDiff line numberDiff line change
@@ -190,8 +190,27 @@ module.exports = (app, defaultConfig, dev, target) => {
190190
return factory.getConfig(); // return the final config for webpack
191191

192192
};
193+
194+
```
195+
> Class Plugin Struct
193196
```
197+
class Plugin {
198+
object , // instance object for webpack plugin
199+
class, // class for webpack plugin
200+
opitons, // initialize config
201+
alias
202+
}
194203
204+
```
205+
206+
> Class Rule Struct
207+
```
208+
class Rule {
209+
opitons, // initialize config for rule
210+
alias
211+
}
212+
213+
```
195214
> app.webpackFactory methods list:
196215
197216
### reset(value)
@@ -216,108 +235,100 @@ module.exports = (app, defaultConfig, dev, target) => {
216235
#### return
217236
* {*}
218237

219-
### generate {param} factory for webpack: env(param)
238+
### generate {key} factory for webpack: env(key)
220239
#### Parameters
221-
* param {String} factory flag
240+
* key {String} factory flag
222241

223242
#### return
224243
* {Object}
225244

226245
### Get the final config for webpack : getConfig()
227246
#### Parameters
228-
* key {String}
229-
230247
#### return
231-
* value {*}
248+
* {Object}
232249

233250

234-
### addPlugin(params1, params2,params3)
251+
### addPlugin(args, options,alias)
235252
#### Parameters
236-
* params1 {Object|Class|String} 插件实例|构造函数|已定义的插件名
237-
* [params1] {Object} 插件配置项
238-
* [params2] {String} 插件别名
253+
* args {Object|Class|String}
254+
* [options] {Object}
255+
* [alias] {String}
239256

240257
#### return
241258
* this
242259

243260

244-
### getPlugin(params1)
261+
### getPlugin(filter)
245262
#### Parameters
246-
* params1 {String|Function}
263+
* filter {String|Function}
247264

248265
#### return
249-
* {Object}
266+
* {Plugin}
250267

251-
### 设置插件配置: setPlugin(params1, params2,params3)
268+
### setPlugin(args, options,alias)
252269

253270
#### Parameter
254-
* params1 {Object|Class}
255-
* [params1] {Object}
256-
* [params2] {String}
271+
* args {Object|Class}
272+
* [options] {Object}
273+
* [alias] {String}
257274

258275
#### return
259276
* this
260277

261-
### definePlugin(params1, params2,params3)
278+
### definePlugin(args, options,alias)
262279
#### Parameters
263-
* params1 {Object|Class}
264-
* [params1] {Object}
265-
* [params2] {String}
280+
* args {Object|Class}
281+
* [options] {Object}
282+
* [alias] {String}
266283
#### return
267284
* this
268285

269-
### usePlugin(params1)
286+
### usePlugin(alias)
270287
#### Parameters
271-
* params1 {String}
288+
* alias {String}
272289
#### return
273-
* {Object}
290+
* {Plugin}
274291

275-
### addRule(params1,params2)
276-
#### Parameters
277-
* params1 {Object}
278-
* [params2] {String}
279-
#### return
280-
* this
281292

282-
### addRule(params1,params2)
293+
### addRule(options,alias)
283294
#### Parameters
284-
* params1 {Object}
285-
* [params2] {String}
295+
* options {Object}
296+
* [alias] {String}
286297
#### return
287298
* this
288299

289-
### getRule(params1)
300+
### getRule(filter)
290301
#### Parameters
291-
* params1 {String|Function}
302+
* filter {String|Function}
292303
#### return
293-
* {Object}
304+
* {Rule}
294305

295-
### defineRule(params1,params2)
306+
### defineRule(options,alias)
296307
#### Parameters
297-
* params1 {Object}
298-
* [params2] {String}
308+
* options {Object}
309+
* [alias] {String}
299310
#### return
300311
* this
301312

302-
### usePlugin(params1)
313+
### useRule(alias)
303314
#### Parameters
304-
* params1 {String}
315+
* alias {String}
305316

306317
#### return
307-
* {Object}
318+
* {Rule}
308319

309-
### defineLoader(params1,params2)
320+
### defineLoader(alias,loader)
310321
#### Parameters
311-
* params1 {String}
312-
* [params2] {String}
322+
* alias {String}
323+
* [loader] {String}
313324
#### return
314325
* this
315326

316-
### useLoader(params1)
327+
### useLoader(alias)
317328
#### Parameters
318-
* params1 {String}
329+
* alias {String}
319330
#### return
320-
* {path}
331+
* {String}
321332

322333

323334

0 commit comments

Comments
 (0)