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

2017 年 9 月 22 日 开源中国 OSC-王练


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


1、JavaScript


JSDoc 3

https://www.oschina.net/p/jsdoc

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

模板

  • jaguarjs-jsdoc:https://github.com/davidshimjs/jaguarjs-jsdoc

  • DocStraphttps://github.com/docstrap/docstrap

  • jsdoc3Template:https://github.com/DBCDK/jsdoc3Template

  • minami:https://github.com/Nijikokun/minami

  • docdashhttps://github.com/clenemt/docdash

  • tui-jsdoc-template:https://github.com/nhnent/tui.jsdoc-template

构建工具

  • JSDoc Grunt plugin:https://github.com/krampstudio/grunt-jsdoc

  • JSDoc Gulp plugin:https://github.com/mlucool/gulp-jsdoc3

其它工具

  • jsdoc-to-markdown:https://github.com/jsdoc2md/jsdoc-to-markdown

  • Integrating GitBook with JSDoc:https://medium.com/@kevinast/integrate-gitbook-jsdoc-974be8df6fb3


ESDoc

https://esdoc.org/

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

Demo


2、API


apiDoc

http://apidocjs.com/

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

Demo


GraphQL Voyager

https://apis.guru/graphql-voyager/

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


3、CSS / Style Guide


Knyle Style Sheets(KSS)

http://warpspire.com/kss

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


React Styleguidist

https://react-styleguidist.js.org/

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

Demo



推荐阅读

6 款可替代 Reddit 的最佳开源免费方案

这些优秀的主流代码编辑器,你用过多少款?

可能是国内最火的开源项目 —— Python 篇

CSDN CODE 项目整体迁移到码云平台的公告

点击“阅读原文”查看更多精彩内容

登录查看更多
0

相关内容

【Manning新书】现代Java实战,592页pdf
专知会员服务
98+阅读 · 2020年5月22日
Python导论,476页pdf,现代Python计算
专知会员服务
255+阅读 · 2020年5月17日
计算机视觉最佳实践、代码示例和相关文档
专知会员服务
17+阅读 · 2019年10月9日
Pupy – 全平台远程控制工具
黑白之道
43+阅读 · 2019年4月26日
使用 C# 和 Blazor 进行全栈开发
DotNet
6+阅读 · 2019年4月15日
刚开始学编程?这几款小工具能让你事半功倍
值得收藏的45个Python优质资源(附链接)
数据派THU
4+阅读 · 2018年2月10日
精选Top30!最实用的python开源项目都在这里
乌镇智库
4+阅读 · 2018年1月26日
Python 开源项目 Top30 | 值得收藏
人工智能头条
8+阅读 · 2018年1月19日
码农日常工具推荐
架构文摘
4+阅读 · 2017年9月26日
Arxiv
10+阅读 · 2020年4月5日
Arxiv
100+阅读 · 2020年3月4日
A Comprehensive Survey on Transfer Learning
Arxiv
117+阅读 · 2019年11月7日
Knowledge Based Machine Reading Comprehension
Arxiv
4+阅读 · 2018年9月12日
VIP会员
相关资讯
Pupy – 全平台远程控制工具
黑白之道
43+阅读 · 2019年4月26日
使用 C# 和 Blazor 进行全栈开发
DotNet
6+阅读 · 2019年4月15日
刚开始学编程?这几款小工具能让你事半功倍
值得收藏的45个Python优质资源(附链接)
数据派THU
4+阅读 · 2018年2月10日
精选Top30!最实用的python开源项目都在这里
乌镇智库
4+阅读 · 2018年1月26日
Python 开源项目 Top30 | 值得收藏
人工智能头条
8+阅读 · 2018年1月19日
码农日常工具推荐
架构文摘
4+阅读 · 2017年9月26日
相关论文
Arxiv
10+阅读 · 2020年4月5日
Arxiv
100+阅读 · 2020年3月4日
A Comprehensive Survey on Transfer Learning
Arxiv
117+阅读 · 2019年11月7日
Knowledge Based Machine Reading Comprehension
Arxiv
4+阅读 · 2018年9月12日
Top
微信扫码咨询专知VIP会员