21 Oct 2011 4:04 AM #1
JSDuck - the tool for documenting your Ext JS apps
Today I'm happy to announce the release of JSDuck 3.0.
The project has grown quite tremendously since the initial 0.1 release almost a year ago. No more is it an alternative documentation generator, but an official one. Therefore I'm closing the old forum thread which has lots of outdated information and start a new fresh one.
Check out JSDuck at Github.
Although a lot has changed, the main features of JSDuck have remained the same:
* Support for Markdown, so you can write human-readable comments.
* Strong adherence to the DRY principle, so you don't have to repeat in comments what you already have said in code.
Over time JSDuck has been extended outside the realm of basic API documentation, allowing the creation of guides, examples and other things you see in the official Ext JS 4 documentation.
But for most users, these aren't as useful, so for this 3.0 release I'd like to highlight the latest and greatest API documentation related features:
* Inline examples allow you embed live demos of your components (no more limited to Ext JS 4 components) inside the documentation. No more will you need to create screenshots to show how your component looks like. Simple add an @example tag, and there you have it.
* Custom tags allow you to add support for metadata tags that JSDuck doesn't support natively, like @license, @date, @version.
Read the Advanced Usage Guide for details.
Like always, JSDuck is just a simple gem install away:
$ [sudo] gem install jsduck
For latest changes, see the changelog.
Last edited by renku; 24 Oct 2011 at 1:54 AM. Reason: Add windows download link
21 Oct 2011 4:04 PM #2
When installing JSDuck on Ubuntu I'm getting this:
nickolay@nickolay-note:~$ sudo gem install jsduck Building native extensions. This could take a while... Building native extensions. This could take a while... ERROR: Error installing jsduck: jsduck requires RubyGems version >= 1.3.7 nickolay@nickolay-note:~$ gem -v 1.3.5 nickolay@nickolay-note:~$
22 Oct 2011 2:24 AM #3
Strange that nobody has asked for this before. I downgraded the required RubyGems to 1.3.5 and released JSDuck 3.0.1.
The only reason I required 1.3.7 was me having this version when I released JSDuck 0.1.
22 Oct 2011 8:11 PM #4
- Join Date
- Mar 2007
- Melbourne, Australia (aka GMT+10)
- Vote Rating
woo hoo! can't wait for the final win version!Lead Trainer / Sencha Specialist
Teahouse Training Company
SenchaWorld.com - Videos, and stuff
Sencha.Community - Tools, Extensions and Resources
TeahouseHQ.com - Sencha Ecosystem Training Portal
Code Validation : JSLint | JSONLint | JSONPLint
24 Oct 2011 1:54 AM #5
The Windows binary is now also available.
24 Oct 2011 10:37 PM #6
When I get an image not found warning, there is no indication as to where the image is referenced (i.e. no file or line number).
I am having difficulty with the --images option. How do I specify multiple image folders? I've tried doing
but it doesn't work. What is the proper delimiter to use?
Also, can you provide an example of the --img option - I have been unable to get it to work.
29 Oct 2011 1:39 AM #7
29 Oct 2011 7:12 AM #8
@BillHubbard: Could you provide a test case that causes this crash. The line that you removed alone in a file doesn't seem to cause any problems, but I'd like to find out what does.
31 Oct 2011 11:08 AM #9
I'll let you know if I encounter it again.
31 Oct 2011 11:10 AM #10
Open by default
When the help page opens, the Ext branch is expanded by default. Is there a way to make it closed by default, or to specify a different branch to be open?
Thread Participants: 43
- jack.slocum (1 Post)
- tryanDLS (9 Posts)
- dawesi (1 Post)
- jsakalos (2 Posts)
- fermo111 (1 Post)
- Zyclops (3 Posts)
- Schlurcher (1 Post)
- mankz (1 Post)
- zombeerose (5 Posts)
- demongloom (3 Posts)
- SamuraiJack1 (6 Posts)
- mono blaine (5 Posts)
- SimoAmi (17 Posts)
- danguba (4 Posts)
- stephen.friedrich (5 Posts)
- Spongerusher (6 Posts)
- Tim Toady (2 Posts)
- ykey (2 Posts)
- xuebi1109 (2 Posts)
- stoeffel (2 Posts)
- shmeltex (5 Posts)
- droessner (3 Posts)
- suzuki1100nz (1 Post)
- BillHubbard (14 Posts)
- aaronho (1 Post)
- burnnat (2 Posts)
- sasklacz (3 Posts)
- DJFliX (1 Post)
- zonaib (3 Posts)
- dwahli (4 Posts)
- limscoder (4 Posts)
- tengl (2 Posts)
- aspasojevic (2 Posts)
- lsdriscoll (6 Posts)
- kstudio (6 Posts)
- Mosely (6 Posts)
- Xorcist (1 Post)
- thejonz (1 Post)
- Morfi (2 Posts)
- AssetWorks (3 Posts)
- maheshjagadeesan (2 Posts)
- howest525 (1 Post)
- testerl (1 Post)