Using external library

[Bartheleway]

Hi, I'm currently developping an application using Ember. In the external I put this:

"external": {
    "data": [
        "http://builds.emberjs.com/tags/v1.5.0/ember-docs.json",
        "http://builds.emberjs.com/tags/v1.0.0-beta.6/ember-data-docs.json"
    ]
}

But then when I do @extends DS.Model, it creates a link to http://builds.emberjs.com/tags/v1.0.0-beta.6/ember-data-docs.jsonclasses/DS.Model.html.

So the first problem is that there is a missing /. The second problem is that the online documentation is available at http://emberjs.com/api/data/ and not http://builds.emberjs.com/tags/v1.0.0-beta.6/ember-data-docs.json/.

Is there a way to specify the api url ? Something like this:

"external": {
    "data": [
        {
            "data": "http://builds.emberjs.com/tags/v1.5.0/ember-docs.json",
            "url": "http://emberjs.com/api"
        }, {
            "data": "http://builds.emberjs.com/tags/v1.0.0-beta.6/ember-data-docs.json",
            "url": "http://emberjs.com/api/data"
        }
    ]
}

[mmpestorich]

Here's a patch to yuidocjs that allows you to do just that.

--- a/lib/builder.js      2014-03-08 15:28:16.000000000 -0800
+++ b/lib/builder.js    2014-07-20 12:39:10.000000000 -0700
@@ -399,8 +399,14 @@
             var stack = new Y.Parallel();
             info.data.forEach(function (i) {
                 var base;
+                if (typeof i === 'object') {
+                    base = i.base;
+                    i = i.json;
+                }
                 if (i.match(/^https?:\/\//)) {
-                    base = i.replace('data.json', '');
+                    if (!base) {
+                        base = i.replace('data.json', '');
+                    }
                     Y.use('io-base', stack.add(function () {
                         Y.log('Fetching: ' + i, 'info', 'builder');
                         Y.io(i, {
@@ -419,7 +425,9 @@
                         });
                     }));
                 } else {
-                    base = path.dirname(path.resolve(i));
+                    if (!base) {
+                        base = path.dirname(path.resolve(i));
+                    }
                     var data = Y.Files.getJSON(i);
                     data.base = base;
                     //self.options.externalData = Y.mix(self.options.externalData || {}, data);

After applying this patch you can specify a base for the given json.

external: {
            data: [
              { base: 'http://emberjs.com/api/', json: 'http://builds.emberjs.com/tags/v1.5.1/ember-docs.json' },
              { base: 'http://emberjs.com/api/', json: 'http://builds.emberjs.com/tags/v1.0.0-beta.6/ember-data-docs.json' }
            ]
          }

[Bartheleway]

This is great, could you make a PR so that everyone will be able to use it ?

[caridy]

@mmpestorich the diff seems to be ok, feel free to send the PR, I will consider it.

[okuryu]

#253 has been merged. It will be available in the next version.