我需要创建我们在reactjs应用程序中定义的每个组件的doc文件.我正在寻找可用于创建任何扩展文档的npm,以便它可以提取代码,评论来自我的组件并将其更改为任何扩展名的文档.如何帮助我?我的问题与关于jsdoc的其他问题不同,因为我正在使用jsdoc在reactjs中查找文档.
最后我找到了解决方案,首先转到此链接并正确阅读文档: - 阅读文档 现在执行以下步骤: -
打开命令提示符
通过命令全局安装JSDoc:npm install jsdoc -g
现在转到项目文件夹的路径并运行命令:jsdoc src -r -d docs
上面的命令将在项目目录的doc文件夹中创建文档.我们使用React Styleguidist记录我们的React组件库.
它将使用以下功能解析您的代码:
从您定义的PropTypes生成API/props文档.
创建实时可编辑示例文档,让人们可以轻松复制粘贴代码段.
它具有良好的可配置性,并具有热重新加载以实现内部文档.
它的工作原理是通过Webpack构建一个Web应用程序,您可以在本地使用,也可以在所有开发人员的位置托管.
对我们来说,它运作良好,随着时间的推移它们会改进.
编辑:是否使用react-docgen.