flutter 如何使用dartdoc 6.1.2生成markdown文档

6rvt4ljy  于 2023-05-19  发布在  Flutter
关注(0)|答案(1)|浏览(143)

我曾经使用dartdoc 5.1.2为我的项目生成markdown文档,但是,当我将dartdoc更新到版本6.1.2时,我发现没有生成markdown文档的命令或选项
我尝试了这些命令:

dart doc --format md
dart doc --format=md
dart doc . -- formar md

但是得到这个错误:

Could not find an option named "format".
vddsk6oq

vddsk6oq1#

我想你把dart doc和dartdoc弄混了。dart doc是dart和flutter自带的工具,https://dart.dev/tools/dart-doc你可能会在env变量中丢失dart二进制文件的路径。它会生成html,并且无法更改格式。另一方面,有一个名为dartdoc https://pub.dev/packages/dartdoc的软件包,它是可安装的cli工具dart pub global activate dartdoc*它可以在markdown和html中生成文档,并且有一堆其他参数可以传递。您也可以使用yaml文件来自定义输出。6.2.2上运行良好,刚刚检查过。我的env变量中没有FLUTTER_ROOT。所以它必须是dart缺少的誓言,默认情况下它是不暴露的,你必须添加类似C:\flutter\bin\cache\dart-sdk\bin的东西到Path env变量中,它是如何在pub.dev包页面中显示的并运行dartdoc --format md*

相关问题