CocosCreator + Vscode + Ts 代码注释生成文档,利用typedoc
需求: 脚本的代码注释,生成为文档
基本搭建环境: (cocoscreator 2.4.x + vscode + ts) 、(nodejs + npm)
步骤:
1、安装typedoc:
npm install -g typedoc
2、项目根目录添加/创建 typedoc.json 文件
3、然后再项目 tsconfig.json 文件 加入 (4步骤报错可选)
"downlevelIteration": true
4、配置 typedoc.json, 参考如下
`
{
"name": "api说明", // 文档项目名称
"entryPoints": ["./assets//*.ts"], // TypeScript文件的入口点,通常是存放您的脚本的目录
"tsconfig":"./tsconfig.json", // 指定config路径
"out": "docs", // 文档输出目录-自己创建,可以自定义
// "mode": "file",
"theme": "default",// 默认主题
// // "includes": "path/to/your/customIncludes", // 可选,如果您有自定义的文档部分,可以指定其路径
"exclude": [
"/node_modules/", // 排除node_modules文件夹
"/build/", // 排除build文件夹,如果有的话
"/*.d.ts" // 排除所有的TypeScript声明文件
],
}
`
5、项目终端运行 typedoc 即可

6、生成后运行文件里的 index.html即可看到注释
其他可遇到的问题:
1、如果版本问题可以用 : npm install -g typedoc@latest
CocosCreator + Vscode + Ts 代码注释生成文档,利用typedoc 更多相关文章
JavaScript CSS Vue3 实现一个简单的Loading
配置和使用nvm免安装版本(nvm-noinstall.zip)
HarmonyOS:使用Node-API实现ArkTS与C/C++跨语言交互
【NodeJS】NodeJS+mongoDB在线版开发简单RestfulAPI (一):项目简介及安装依赖
【NodeJS】NodeJS+mongoDB在线版开发简单RestfulAPI (四):状态码的使用
【NodeJS】NodeJS+mongoDB在线版开发简单RestfulAPI (五):POST上传文件的设置
【NodeJS】NodeJS+mongoDB在线版开发简单RestfulAPI (六):token的设置
【NodeJS】NodeJS+mongoDB在线版开发简单RestfulAPI (七):MongoDB的设置
【NodeJS】NodeJS+mongoDB在线版开发简单RestfulAPI (三):Cors的设置及.env文件的设置
【NodeJS】NodeJS+mongoDB在线版开发简单RestfulAPI (二):项目文件夹架构及路由的设置
【NodeJS】NodeJS+mongoDB在线版开发简单RestfulAPI (八):API说明(暂时完结,后续考虑将在线版mongoDB变为本地版)
报error:0308010C:digital envelope routines::unsupported错--nodejs版本过高(nvm安装(更换)不同版本nodejs)
小结---安装nvm解决node版本不兼容的问题(node版本切换)