Newer
Older
![JSDuck](https://raw.github.com/senchalabs/jsduck/master/opt/jsduck-logo-dark.png)
===================================================================================
[![Build Status](https://travis-ci.org/senchalabs/jsduck.png)](https://travis-ci.org/senchalabs/jsduck)
API documentation generator for Sencha JavaScript frameworks.
JSDuck aims to be a better documentation generator for [Ext JS][] than
the old [ext-doc][] was. It is used by Sencha to document [Ext JS
4][ext4-docs], [Sencha Touch][touch2-docs] and [several other][other-docs]
The highlights of JSDuck are [Markdown][] support and keeping you DRY
by inferring a lot of information from code. Read the
[documentation][] for full overview.
**New to JSDuck?** Watch [introductory talk by Nick Poulden][video]:
[<img src="http://b.vimeocdn.com/ts/227/178/227178682_200.jpg" alt="SenchaCon 2011 JSDuck talk" />][video]
[Ext JS]: http://www.sencha.com/products/js/
[Markdown]: http://daringfireball.net/projects/markdown/
[ext4-docs]: http://docs.sencha.com/extjs/
[touch2-docs]: http://docs.sencha.com/touch/
[documentation]: https://github.com/senchalabs/jsduck/wiki
[video]: http://vimeo.com/33465319
Or download the [Windows binary][winbin]. When you run into problems,
see the [installation guide][].
[winbin]: https://sourceforge.net/projects/jsduck/files/
[installation guide]: https://github.com/senchalabs/jsduck/wiki/Installation
For the simplest test-run just use the `--builtin-classes` option to
write documentation for JavaScript builtin classes like Array, String
and Object into `docs` directory:
To generate docs for [Ext JS 4][] add path to the corresponding src/ dir:
And to create docs for your own Ext JS project, list the directory
with your files in addition to the Ext JS source files (this way the
docs of your classes will list all the properties and methods they
inherit from Ext JS classes):
Unfortunately the above will throw lots of warnings at you, as
building the full Ext JS docs requires lots of additional settings.
For start you might want to simply ignore all these warnings
originating from Ext JS source:
$ jsduck ext-4.2.1/src my-project/js --output docs \
--warnings=-all:ext-4.2.1/src
But see the [Usage guide][] for more information on building Ext JS 4
docs.
[Ext JS 4]: http://www.sencha.com/products/extjs/
[Usage guide]: https://github.com/senchalabs/jsduck/wiki/Usage
Read the [documentation][] and take a look at [example.js][example].
[example]: https://github.com/senchalabs/jsduck/blob/master/opt/example.js
Hacking it
----------
See [Hacking guide](https://github.com/senchalabs/jsduck/wiki/Hacking) in wiki.
Who's using JSDuck?
-------------------
- Appcelerator [Titanium SDK](http://docs.appcelerator.com/titanium/2.0/index.html)
- AT&T [API Platform SDK for HTML5](https://code-api-att.com/SenchaSdk20Drop23Docs/)
- Bryntum [Siesta unit testing framework](http://www.bryntum.com/products/siesta/docs/)
- [CKEditor](http://docs.ckeditor.com)
- [GeoExt 2](https://github.com/geoext/geoext2)
- Rally Software [Rally App SDK](https://prod.help.rallydev.com/apps/2.0rc1/doc/)
- [Sencha](http://docs.sencha.com) - obviously :)
These are some that we know of. Want your project listed here? Drop us a line.
JSDuck is distributed under the terms of the GNU General Public
JSDuck was developed by [Rene Saarsoo](http://triin.net),
with many contributions from [Nick Poulden](https://github.com/nick).
Thanks to [Ondřej Jirman](https://github.com/megous),
[Thomas Aylott](https://github.com/subtleGradient),
[johnnywengluu](https://github.com/johnnywengluu),
[gevik](https://github.com/gevik),
[ligaard](https://github.com/ligaard),
[Bill Hubbard](http://www.sencha.com/forum/member.php?272458-BillHubbard),
[Ed Spencer](https://github.com/edspencer),
[atian25](https://github.com/atian25),
Katherine Chu,
[Rob Dougan](https://github.com/rdougan),
[Dave Thompson](https://github.com/limscoder),
[burnnat](https://github.com/burnnat),
[vjetteam](https://github.com/vjetteam),
[Chris Westbrook](https://github.com/cnstaging),
[Scott Whittaker](https://github.com/scottrobertwhittaker),
[Timo Tijhof](https://github.com/Krinkle),
and many-many others who reported bugs, submitted patches, and
provided a lot of useful input.
Changelog
---------
See [Changelog](https://github.com/senchalabs/jsduck/wiki/Changelog) page in wiki.
More questions?
---------------
Feel free to [post an issue][issues], but read the [FAQ][] first.
[issues]: https://github.com/senchalabs/jsduck/issues
[FAQ]: https://github.com/senchalabs/jsduck/wiki/FAQ