Web 开发人员的文档生成工具【推荐】

工欲善其事必先利其器，在此给 Web 开发人员推荐几款优秀的开源文档生成工具，希望能对大家有所帮助。

1、JavaScript

JSDoc 3

这是一款根据 Javascript 文件中注释信息，生成 JavaScript 应用、库、模块的 API 文档的工具。你可以使用它记录如：命名空间、类、方法、方法参数等。该项目还衍生出了许多模板和其他工具来帮助生成和自定义文档，比如：

模板

• jaguarjs-jsdoc
• DocStrap (example)
• jsdoc3Template (example)
• minami
• docdash (example)
• tui-jsdoc-template (example)

构建工具

• JSDoc Grunt plugin
• JSDoc Gulp plugin

其它工具

• jsdoc-to-markdown
• Integrating GitBook with JSDoc

ESDoc

一个 JavaScript 文档生成器，按照规范编写代码注释，即可生成友好的 JavaScript 代码文档。它可以将测试代码和用户手册一并集成到文档中，支持通过插件添加自定义功能。

Demo

image.png

2、API

apiDoc

这是一款 RESTful Web API 文档生成工具，一个在注释里边编写 API 文档的小工具。有了它，只需在写源码的时候顺手写上一些简单的注释，就可以生成出漂亮的文档了。项目支持大部分主流语言，注释维护起来也比较方便，不需要额外再维护一份文档。

Demo

image.png

GraphQL Voyager

这是一款将任意 GraphQL API 表示为交互式图形的工具，可以直观地浏览 GraphQL API 。在设计或讨论数据模型时，非常有用。

3、CSS / Style Guide

Knyle Style Sheets（KSS）

KSS 既是一份文档规格说明，也是一种编写样式指南的格式，旨在帮助开发者自动化地创建可读、可解析的样式指南。它为团队编写具有可维护性、可文档化的 CSS 提供一套方法。

image.png

React Styleguidist

顾名思义，这是一款 React 样式指南生成器，可与你的团队分享在线样式指南。它列出组件支持类型，并展示基于 Markdown 文件的实时、可编辑的使用示例。

Demo

![

](https://upload-images.jianshu.io/upload_images/13133049-efc738781eee8643.png?imageMogr2/auto-orient/strip|imageView2/2/w/1240)

自己是一个五年的前端工程师

这里推荐一下我的前端学习交流群：784783012 ，里面都是学习前端的，如果你想制作酷炫的网页，想学习知识。自己整理了一份2018最全面前端学习资料，从最基础的HTML CSS JS到移动端HTML5到各种框架都有整理，送给每一位前端小伙伴，有想学习web前端的，或是转行，或是大学生，还有工作中想提升自己能力的，正在学习的小伙伴欢迎加入学习。