JSDOC/BuildDocs.js

[gnome.introspection-doc-generator] / JSDOC / BuildDocs.js

diff --git a/JSDOC/BuildDocs.js b/JSDOC/BuildDocs.js
index 6e5edf5..dda68aa 100644 (file)
--- a/JSDOC/BuildDocs.js
+++ b/JSDOC/BuildDocs.js
@@ -164,66 +164,85 @@ BuildDocs = {
         
         if (!File.exists(Options.target))
             File.mkdir(Options.target);
-        if (!File.exists(Options.target+"symbols"))
-            File.mkdir(Options.target+"symbols");
-        if (!File.exists(Options.target+"symbols/src"))
-            File.mkdir(Options.target+"symbols/src");
+        if (!File.exists(Options.target+"/symbols"))
+            File.mkdir(Options.target+"/symbols");
+        if (!File.exists(Options.target+"/symbols/src"))
+            File.mkdir(Options.target+"/symbols/src");
         
         // copy everything in 'static' into 
         File.list(Options.templatesDir + '/static').forEach(function (f) {
             File.copy(Options.templatesDir + '/static/' + f, Options.target + '/' + f);
         });
-        
+        if (!File.isDirectory(Options.target +"/json")) {
+            File.makeDir(Options.target +"/json");
+        }
         
         // used to check the details of things being linked to
         Link.symbolSet = symbolSet;
 
         
         var classTemplate = new Template({
-             templateFile : publish.conf.templatesDir+"class.tmpl",
+             templateFile : Options.templatesDir  + "/class.tmpl",
              Link : Link
-           });
-        var classesTemplate = new Template(publish.conf.templatesDir+"allclasses.tmpl");
-        //}
-        //atch(e) {
-        //     print(e.message);
-        ///    quit();
-        //}
-        
-        // filters
+        });
+        var classesTemplate = new Template({
+            templateFile : Options.templatesDir +"/allclasses.tmpl",
+            Link : Link
+        });
+        var classesindexTemplate = new Template({
+            templateFile : Options.templatesDir +"/index.tmpl",
+            Link : Link
+        });
+        var fileindexTemplate = new Template({   
+            templateFile : Options.templatesDir +"/allfiles.tmpl",
+            Link: Link
+        });
+
         
         classTemplate.symbolSet = symbolSet;
         
         
-        function hasNoParent($) {return ($.memberOf == "")}
-        function isaFile($) {return ($.is("FILE"))}
-        function isaClass($) { return ($.is("CONSTRUCTOR") || $.isNamespace); }
+        function hasNoParent($) {
+            return ($.memberOf == "")
+        }
+        function isaFile($) {
+            return ($.is("FILE"))
+        }
+        function isaClass($) { 
+            return ($.is("CONSTRUCTOR") || $.isNamespace); 
+        }
         
         var symbols = symbolSet.toArray();
         
-        var files = JSDOC.opt.srcFiles;
+        var files = Options.srcFiles;
+        
         for (var i = 0, l = files.length; i < l; i++) {
             var file = files[i];
-            var srcDir = publish.conf.outDir + "symbols/src/";
-            makeSrcFile(file, srcDir);
+            var srcDir = Options.target + "/symbols/src/";
+            this.makeSrcFile(file, srcDir);
         }
         
         var classes = symbols.filter(isaClass).sort(makeSortby("alias"));
         
         Link.base = "../";
+        
         publish.classesIndex = classesTemplate.process(classes); // kept in memory
         
-        IO.makeDir(publish.conf.outDir+"json");
+        
         
         for (var i = 0, l = classes.length; i < l; i++) {
             var symbol = classes[i];
             var output = "";
             
-            output = classTemplate.process(symbol);
-            println("write " + publish.conf.outDir+"symbols/" +symbol.alias+publish.conf.ext);
-            IO.saveFile(publish.conf.outDir+"symbols/", symbol.alias+publish.conf.ext, output);
+            File.write(Options.target+"/symbols/" +symbol.alias+'.' + Options.publishExt ,
+                    classTemplate.process(symbol));
+            
+            print("write " + Options.target+"/symbols/" +symbol.alias+'.' + Options.publishExt);
+            
             // dump out a 
-            IO.saveFile(publish.conf.outDir+"json/",  symbol.alias+'.json' , publish.jsonRender(symbol));
+            
+            this.publishJSON(Options.target+"/json/",  symbol.alias+'.json', symbol)
+            
             
             
         }
@@ -232,11 +251,7 @@ BuildDocs = {
         Link.base = "";
         publish.classesIndex = classesTemplate.process(classes);
         
-        try {
-            var classesindexTemplate = new JSDOC.JsPlate(publish.conf.templatesDir+"index.tmpl");
-        }
-        catch(e) { print(e.message); quit(); }
-        
+          
         var classesIndex = classesindexTemplate.process(classes);
         IO.saveFile(publish.conf.outDir, "index"+publish.conf.ext, classesIndex);
         classesindexTemplate = classesIndex = classes = null;
@@ -265,7 +280,88 @@ BuildDocs = {
         fileindexTemplate = filesIndex = files = null;
     }
 
-     
+    publishJSON = function(file, data)
+    {
+        // what we need to output to be usefull...
+        // a) props..
+        var cfgProperties = [];
+        if (!data.comment.getTag('singleton').length) {
+            cfgProperties = data.configToArray();
+            cfgProperties = cfgProperties.sort(makeSortby("name"));
+            
+        }
+        var props = []; 
+        //println(cfgProperties.toSource());
+        var p ='';
+        for(var i =0; i < cfgProperties.length;i++) {
+            p = cfgProperties[i];
+            props.push( {
+                name : p.name,
+                type : p.type,
+                desc : p.desc,
+                memberOf : p.memberOf == data.alias ? '' : p.memberOf
+            });
+        }
+        
+         
+        var ownEvents = data.methods.filter( function(e){
+                return e.isEvent && !e.comment.getTag('hide').length;
+            }).sort(makeSortby("name"));
+             
+        
+        var events = [];
+        var m;
+        for(var i =0; i < ownEvents.length;i++) {
+            m = ownEvents[i];
+            events.push( {
+                name : m.name.substring(1),
+                sig : makeFuncSkel(m.params),
+                type : 'function',
+                desc : m.desc
+            });
+        }
+        //println(props.toSource());
+        // we need to output:
+        //classname => {
+        //    propname => 
+        //        type=>
+        //        desc=>
+        //    }
+
+        var ret = {
+            props : props,
+            events: events
+        };
+        File.write(file, JSON.stringify(ret, null, 2 ));
+        
+        
+        // b) methods
+        // c) events
+        
+        
+    },
+    makeSrcFile: function(path, srcDir, name) {
+        if (Options.outputSource) return;
+        
+        return; // not done?
+        
+        if (!name) {
+            name = path.replace(/\.\.?[\\\/]/g, "").replace(/[\\\/]/g, "_");
+            name = name.replace(/\:/g, "_");
+        }
+        
+        var src = {
+                path: path, 
+                name:name, 
+                charset: IO.encoding, 
+                hilited: ""
+        };
+        
+         
+        if (src.hilited) {
+            IO.saveFile(srcDir, name+publish.conf.ext, src.hilited);
+        }
+    }
      
     
 };