senchalabs / jsduck

Simple JavaScript Duckumentation generator.
http://docs.sencha.com/
GNU General Public License v3.0
1.5k stars 238 forks source link

Rake's "gem" task is broken #275

Open Reinmar opened 11 years ago

Reinmar commented 11 years ago

When I ran rake gem I had the following error:

ReferenceError: Can't find variable: Ext

  phantomjs://webpage.evaluate():6
  phantomjs://webpage.evaluate():1
  /usr/local/SenchaSDKTools-2.0.0-beta3/compat/scripts/phantomjs-jsb.js:230

This is caused by incorrect URI: https://github.com/senchalabs/jsduck/blob/master/Rakefile#L107

There's a hardcoded URI for what? :) It took me an hour to figure out that it has to point to already built documentation :).

I saw in commits history that there were some troubles with building from local build-js.html file. It'd be nice if it worked, because this is the only convenient way. But if not, then at least https://github.com/senchalabs/jsduck/wiki/Hacking should mention that.

nene commented 11 years ago

Hi. Sorry for all the troubles.

Like you correctly noted, this was a workaround for problems I ran into with the old build approach. I intended it as a temporary patch, but unfortunately I still haven't got to actually fixing it. Part of the problem is that I really need to upgrade to Sencha Command 3.x, so fixing it for the 2.x is a bit of a wasted effort, but my attempts with 3.x have so far failed with lots of mysterious errors etc.

I've updated the hacking guide for now.

Reinmar commented 11 years ago

Hi.

Thanks. No problem, at least I learnt something about JSDuck and Sencha :D

BTW. Here are our docs - http://docs.ckeditor.com - we really like them :).

Thanks for great work :).