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
【推荐】国内首个AI IDE,深度理解中文开发场景,立即下载体验Trae
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· 分享4款.NET开源、免费、实用的商城系统
· 全程不用写代码,我用AI程序员写了一个飞机大战
· MongoDB 8.0这个新功能碉堡了,比商业数据库还牛
· 白话解读 Dapr 1.15:你的「微服务管家」又秀新绝活了
· 上周热点回顾(2.24-3.2)