@enterthenamehere/esdoc
Version:
Good Documentation Generator For JavaScript, updated for new decade
66 lines (48 loc) • 2.06 kB
Markdown
This is an updated version of esdoc. It uses babel 7, so it can parse most modern code including TypeScript and Flow.
Please use updated plugins too. It is not compatible with original [esdoc](https://github.com/esdoc/esdoc).
Main changes:
- updated dependencies
- updated to babel 7
- replaced code-prettify with highlightjs
- ecmascript-proposal plugin is now part of standard-plugin
# ESDoc
ESDoc is a documentation generator for JavaScript.<br/>
Please <a href="https://try.esdoc.org">try it out</a>!
<img class="screen-shot" src="https://raw.githubusercontent.com/esdoc/esdoc/master/manual/asset/image/top.png" width="500px" style="max-width: 500px; border: 1px solid rgba(0,0,0,0.1); box-shadow: 1px 1px 1px rgba(0,0,0,0.5);">
# Features
- Generates good documentation.
- Measures documentation coverage.
- Integrate test codes into documentation.
- Integrate manual into documentation.
- Parse ECMAScript proposals.
- [ESDoc Hosting Service](https://doc.esdoc.org)
# Users
- [ESDoc](https://doc.esdoc.org/github.com/esdoc/esdoc/) (self-hosting 😄)
- [RxJS](http://reactivex.io/rxjs/)
- [Sketch API](http://developer.sketchapp.com/reference/api/)
And [more](https://github.com/search?o=desc&q=esdoc+filename%3Apackage.json+-user%3Ah13i32maru+-user%3Aesdoc+-user%3Aes-doc&ref=searchresults&s=indexed&type=Code&utf8=%E2%9C%93).
# Quick Start
```sh
# Move to a your project directory.
cd your-project/
# Install ESDoc and standard plugin.
npm install --save-dev @enterthenamehere/esdoc @enterthenamehere/esdoc-standard-plugin
# Create a configuration file.
echo '{
"source": "./src",
"destination": "./docs",
"plugins": [{"name": "@enterthenamehere/esdoc-standard-plugin"}]
}' > .esdoc.json
# Run ESDoc.
esdoc
or
./node_modules/@enterthenamehere/esdoc
# View a documentation
open ./docs/index.html
```
# Document
please visit [esdoc.org](https://esdoc.org) to see more documentation.
# License
MIT
# Author
[Ryo Maruyama@h13i32maru](https://twitter.com/h13i32maru)