X-Git-Url: http://git.roojs.org/?a=blobdiff_plain;f=docs.js;h=4e0aef9af74f213e4f05a6a4613440f507cc55a2;hb=0732f9319979576e2ad7d49f21b0233bb71b1253;hp=9755ebe76869bd791206f21af5d597792894dd74;hpb=8a6ce52283c2e5f8e5a44e247a2063641c7091f9;p=gnome.introspection-doc-generator

diff --git a/docs.js b/docs.js
index 9755ebe..4e0aef9 100644
--- a/docs.js
+++ b/docs.js
@@ -1,15 +1,28 @@
 //<Script type="text/javascript">
 
+GIRepository = imports.gi.GIRepository;
+GLib        = imports.gi.GLib;
+
+// we add this in, as it appears to get lost sometimes if we set it using the ENV. variable in builder.sh
+GIRepository.Repository.prepend_search_path(GLib.get_home_dir() + '/.Builder/girepository-1.2.1');
+
+
+
 Gtk = imports.gi.Gtk;
 Gio = imports.gi.Gio;
 Gdk = imports.gi.Gdk;
 
-imports['Object.js'].load(Object); 
+// generic libraries
+XObject     = imports.XObject.XObject;
+File        = imports.File.File; 
+console     = imports.console.console; 
+Template    = imports.JsTemplate.Template.Template; 
+
+// Introspecion specific..
+NameSpace   = imports.Introspect.NameSpace.NameSpace; 
+Link        = imports.Introspect.Link.Link; 
+
 
-File        = imports['File.js'].File; 
-JSDOC       = imports['JSDOC.js'].JSDOC; 
-console     = imports['console.js'].console; 
-Introspect  = imports['JSDOC/Introspect.js'].Introspect; 
 
 var outputdir = Seed.argv[2];
 
@@ -21,41 +34,110 @@ if (!outputdir) {
     };
 }
 
+
 if (!File.isDirectory(outputdir)) {
     console.log("Creating directory " + outputdir);
     File.mkdir(outputdir);
 };
 
-// list namespace..
-//var ns_list = [ 'GIRepository' ];
-
-
+ 
+// Which libraries to build.
 
-var ns_list = JSDOC.Introspect.namespaces();
+var ns_list = NameSpace.namespaces();
 if (typeof(Seed.argv[3]) == 'string') {
     console.log(Seed.argv.length);
     ns_list = Seed.argv[3].split(',');
 }
- 
+
+
 ns_list = ns_list.sort();
+// let's try and load them, so we find out early what will fail.
+print("loading library to make sure it works.");
+ns_list_clean = [];
+ns_list.forEach(function(ns_name) 
+{
+    try {
+    
+        var  core = imports.gi[ns_name];
+        ns_list_clean.push(ns_name);
+    } catch( e) {
+        print(JSON.stringify(e));
+    }
+    
+});
+ns_list = ns_list_clean;
 
-var cls_template = new JSDOC.Template(__script_path__ + '/docs/class.html');
-var cls_ix_template = new JSDOC.Template(__script_path__ + '/docs/class_ix.html');
-var reference_template = new JSDOC.Template(__script_path__ + '/docs/references.html');
+
+
+// which languages do we want to output for.
+langs=[];
+File.list(__script_path__ + '/templates/').forEach(function(f) {
+    if (!File.isDirectory(__script_path__ + '/templates/' + f)) {
+        return;
+    }
+    if (f == 'resources') {
+        return;
+    }
+    langs.push({
+        name : f,
+        cls_template       : new Template( {
+            templateFile : __script_path__ + '/templates/' + f + '/class.html',
+            Link : Link // links might be specific to languages..
+        }),
+        cls_ix_template    : new Template( {
+            templateFile : __script_path__ + '/templates/' + f + '/class_ix.html',
+            Link : Link // links might be specific to languages..
+        }),
+        reference_template : new Template({
+            templateFile : __script_path__ + '/templates/' + f + '/references.html',
+            Link : Link // links might be specific to languages..
+        }),
+    });
+});
+
+
+/*
+var cls_template = new Template(__script_path__ + '/templates/class.html');
+var cls_ix_template = new Template(__script_path__ + '/templates/class_ix.html');
+var reference_template = new Template(__script_path__ + '/templates/references.html');
+*/
+
+print("Looping throught namespaces");
 var ns_idx = [];
-ns_list.map(function(ns_name) 
+ns_list.forEach(function(ns_name) 
 {
+    
+    //if (ns_idx.length) {         return ;/* do one - for testing */ } 
+    
     var  core = imports.gi[ns_name];
     var idx = { name: ns_name}; 
     console.log("START:" + ns_name);
    
-    var ns = Introspect.ns(ns_name);
-    ns['left_bar'] = cls_ix_template.process(ns);
+    var ns = NameSpace.ns(ns_name);
+    
+    // gir goes in top level...
+    if (File.exists(ns.gir_file)) {
+        File.copyFile(ns.gir_file, outputdir + '/'+ ns.gir_filename, Gio.FileCopyFlags.OVERWRITE);
+    }
 
-    Gio.simple_write(outputdir + '/'+ ns_name +  '.html', cls_template.process(ns));
     
-    // left bar index of elements in namespace...
-    Gio.simple_write(outputdir + '/_ix_'+ ns_name +  '.shtml', cls_ix_template.process(ns));
+    
+
+    langs.forEach(function(lang) {
+        ns['left_bar'] = lang.cls_ix_template.process(ns);
+        // namespace template
+        
+        if (!File.exists(outputdir + '/'+ lang.name)) {
+               File.mkdir(outputdir + '/'+ lang.name );
+        }
+      
+        
+        Gio.simple_write(outputdir + '/'+ lang.name+ '/' +ns_name +  '.html', lang.cls_template.process(ns));
+        
+        // left bar index of elements in namespace...
+        Gio.simple_write(outputdir + '/'+ lang.name + '/_ix_'+ ns_name +  '.shtml', lang.cls_ix_template.process(ns));
+            
+    });
      
     
     var actions = {
@@ -66,58 +148,73 @@ ns_list.map(function(ns_name)
         'enums' : 'Enum'
         
     };
+    
     for (var i in actions) {
-        idx[i]= ns[i].length;
-        ns[i].map( function(n) {
-            Gio.simple_write(outputdir + '/'+ ns_name + '.' + n + '.html', 
-                cls_template.process(
-                    Object.extend(
-                        Introspect.factory(actions[i], ns_name, n),
-                        { 'left_bar' :ns['left_bar'] }
-                    )
+        // we flag GLib as a GObject lib...
+        idx[i]= ns_name == 'GLib' ? 1 : ns[i].length ;
+        
+        ns[i].forEach( function(n) {
+            
+            print('NameSpace.factory(' + actions[i] +','+ns_name+','+n);
+            var odata = XObject.extend(
+                NameSpace.factory(actions[i], ns_name, n),
+                { 'left_bar' :ns['left_bar'] }
+            );
+            
+            langs.forEach(function(lang) {
+                Gio.simple_write(outputdir +  '/'+ lang.name + '/' + ns_name + '.' + n + '.html', 
+                    lang.cls_template.process(odata)
                 )
-            )
-                       
+            });
             console.log(ns_name + '.' +n);
         }); 
     }
     ns_idx.push(idx);
-      
+    
 });
 
 var refs = '';
 var html_file_path = '';
 var html = ''
 
-
-for (var i in Introspect.references) {
-    html_file_path = File.join(outputdir, i + '.html');
-  
-    if (i == 'undefined') {
-      console.log("Undefined name space - ignored");
-      continue;
-    }
-    if (!File.isFile(html_file_path)) {
-      console.log("No HTML file " + html_file_path + " to insert references into - ignored");
-      continue;
-    }
+// output cross reference data..
+langs.forEach(function(lang) {
     
-    refs = reference_template.process(Introspect.references[i]);
-
-      // HTML to put refs into
-    html =  File.read(html_file_path);
-
-      // do the replacement
-    html = html.replace(/\<!--references--\>/, refs);
-
-      // write back to file
-    Gio.simple_write(html_file_path, html);
+    for (var i in NameSpace.references) {
+        
+        html_file_path = [ outputdir, lang.name, i + '.html'].join('/');
+      
+        if (i == 'undefined') {
+          console.log("Undefined name space - ignored");
+          continue;
+        }
+        
+        if (!File.isFile(html_file_path)) {
+          console.log("No HTML file " + html_file_path + " to insert references into - ignored");
+          continue;
+        }
+        
+        refs = lang.reference_template.process(NameSpace.references[i]);
 
-}
+          // HTML to put refs into
+        html =  File.read(html_file_path);
 
-var ix_template = new JSDOC.Template(__script_path__ + '/docs/index.html');
-Gio.simple_write(outputdir + '/index.html', ix_template.process(ns_idx));
-File.silentRecursiveCopy(__script_path__ + '/docs/resources/', outputdir);
+          // do the replacement
+        html = html.replace(/\<!--references--\>/, refs);
 
+          // write back to file
+        Gio.simple_write(html_file_path, html);
 
+    }
+});
 
+// set up index and resources.
+langs.forEach(function(lang) {
+    var ix_template = new Template({
+        templateFile : __script_path__ + '/templates/' + lang.name + '/index.html',
+        Link : Link, // lang specifc?
+    });
+    Gio.simple_write(outputdir + '/' + lang.name +  '/index.html', ix_template.process(ns_idx));
+    File.silentRecursiveCopy(__script_path__ + '/templates/resources/', 
+        outputdir + '/'  + lang.name , Gio.FileCopyFlags.OVERWRITE);
+});