UNPKG

use-on-demand

Version:
97 lines 6.29 kB
"use strict"; var GenTypedocUtil = /** @class */ (function () { function GenTypedocUtil() { /** * */ this.typedocCfg = { // TIP—————————————————————————————————————————————————————————————————————————————————————————————————————————————————————— // TIP——————————————————————————————————————————以下为【输入选项】—————————————————————————————————————————————————————————————— // TIP—————————————————————————————————————————————————————————————————————————————————————————————————————————————————————— /** * 转换项目的模式: * WARN 恰恰相反?很奇怪吧 * file 目录形式,为【基于模块层次、namespace】的树状。 * modules 目录形式,为【文件路径】列表。(对于生成内部使用文档的项目最有用) */ 'mode': 'file', // 'mode' : 'modules', /** * 需要生成文档的目录 */ 'inputFiles': [ // './ts-docs', './sources', ], /** * 排除 某些不需要生成文档 的文件 */ 'exclude': [ // 注意,这里是【星加】,不是【星星】 '**/*+(index|.spec|.e2e).ts', // 不为 【.d.ts】文件 生成专门文档 '**/**.d.ts', 'sources/tradingview/**/*.*', ], /** * 打开【.d.ts】声明文件的解析。(同时应使用【excludeExternals】!) */ 'includeDeclarations': true, /** * 避免为【外部的TypeScript文件】创建文档。(配合【includeDeclarations】使用!) */ 'excludeExternals': true, /** * 指定【外部的TypeScript文件】的格式。 */ 'externalPattern': [ '(lib|external)/**/*.ts', 'lib-cp/**/*.ts', 'examples/**/*.ts', 'packages/**/*.ts', ], /** * 全局TS文件的主入口。(可能并没有这个) * 1.WARN 此处,必须为【内外双层引号】。 */ // 'entryPoint' : '"index"', /** * 即使项目有TypeScript错误,也要生成文档。 * 1.如果仅在成功构建后生成文档,则启用此选项将提供性能优势。 * 2.WARN 我感觉,我需要生成一份【完整文档】,来看一下,是什么样子的。所以可以忽略报错。 */ 'ignoreCompilerErrors': true, // 'ignoreCompilerErrors': false, // 此处,不再允许错误(更加严格) // // // // // // // // // 'excludeNotExported' : '', // 从生成的文档中删除本地符号。默认为false。 // 'excludePrivate' : '', // 从生成的文档中删除私有类成员。默认为false。 // 'excludeProtected' : '', // 从生成的文档中删除受保护的类成员。默认为false。 // 'stripInternal' : '', // 删除@internal以TypeScript识别的注释注释的成员。 // 'media' : '', // 指定将复制到输出文件的媒体目录。可以media://file.jpg在doc注释中将媒体链接到。 // 'includes' : '', // 指定包含文件的目录,该文件可以通过[[include:file.md]]doc注释注入到生成的文档中。 // TIP—————————————————————————————————————————————————————————————————————————————————————————————————————————————————————— // TIP——————————————————————————————————————————以下为【输出选项】—————————————————————————————————————————————————————————————— // TIP—————————————————————————————————————————————————————————————————————————————————————————————————————————————————————— /** * 输出目录 * 1.WARN 此处有一个小技巧,将【ts-docs】文件,放到【vuepress】的子目录下。 */ // 'out': 'ts-docs', 'out': 'lib-docs-dist/ts-docs', }; } GenTypedocUtil.prototype.gen = function () { console.log('开始生成', 'typedoc.json文件'); require('fs').writeFileSync('typedoc.json', JSON.stringify(this.typedocCfg, null, 2)); }; return GenTypedocUtil; }()); new GenTypedocUtil().gen(); //# sourceMappingURL=gen-typedoc.js.map