如题,vite 创建的 vue3 typescript 工程,注释什么的都写好了,想要用工具直接生成对应 md 文档文件。
尝试过 typedoc ,对单一 .ts 文件支持不错,对 .vue 文件就不太行,即使加上了 typedoc-plugin-vue
插件也不太行,因为是用 <script setup>
写的,插件只支持 definecomponent
定义出来的组件。
也想过写个脚本遍历工程,提取 <script>
标签下的内容写个临时的 .ts
文件,生成完文档直接删,但是 typedoc 好像命令行没有什么设置能一次仅处理一个文件。
所以有没有什么好用的工具能直接生成对应文档的?求推荐
# typedoc.json
{
"$schema": "https://typedoc.org/schema.json",
"entryPoints": ["../src/App.vue"],
"out": "./docs",
"plugin": [
"typedoc-plugin-vue",
"typedoc-plugin-markdown"
]
}
# 项目结构示意
# {project}
- public
- typedoc
- docs
- package.json
- typedoc.json
- src
- components
- Title
- Title.vue
- type.ts
- router
- index.ts
- type.ts
- store
- index.ts
- type.ts
- views
- Home
- Home.vue
- type.ts
- Config
- Config.vue
- type.ts
- App.vue
- main.ts
- types.ts
- index.html
- tsconfig.json
- vite.config.ts
- package.json
1
hengshenyu 148 天前
vue-component-meta
|
2
rookie2luochao 148 天前
你可以试试 vite-plugin-dts 看看能不能达到你想要的效果
|
3
rookie2luochao 148 天前
@rookie2luochao 看错了,不好意思,我以为生成 dts 呢
|