X-Git-Url: http://git.roojs.org/?a=blobdiff_plain;f=JSDOC%2FBuildDocs.js;h=5a7690b8ef98524000c560ceb33b8f06edd9a0eb;hb=062db213df300e77bc04e25f2bc37a22dfb8ad6c;hp=783705f8dd383337638aa6fae159d5871a3daf4b;hpb=fb9e9a506a7aa3b48ca0dd3febbc2e6d7ceed860;p=gnome.introspection-doc-generator diff --git a/JSDOC/BuildDocs.js b/JSDOC/BuildDocs.js index 783705f..5a7690b 100644 --- a/JSDOC/BuildDocs.js +++ b/JSDOC/BuildDocs.js @@ -38,8 +38,7 @@ BuildDocs = { Options.init(); - - + Options.LOG.inform("JsDoc Toolkit main() running at "+new Date()+"."); Options.LOG.inform("With options: "); @@ -173,20 +172,31 @@ BuildDocs = { 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; - + Link.base = "../"; var classTemplate = new Template({ templateFile : Options.templatesDir + "/class.tmpl", Link : Link }); - var classesTemplate = new Template( - templateFile : Options.templatesDir +"allclasses.tmpl", + 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; @@ -207,16 +217,15 @@ BuildDocs = { for (var i = 0, l = files.length; i < l; i++) { var file = files[i]; - var srcDir = Options.target + "/symbols/src/"; - makeSrcFile(file, srcDir); + var targetDir = Options.target + "/symbols/src/"; + this.makeSrcFile(file, targetDir); } var classes = symbols.filter(isaClass).sort(makeSortby("alias")); + + var classesIndex = classesTemplate.process(classes); // kept in memory - 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]; @@ -228,34 +237,35 @@ BuildDocs = { 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) + } // regenrate the index with different relative links Link.base = ""; - publish.classesIndex = classesTemplate.process(classes); + var 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; + File.write(Options.target + "/index."+ Options.publishExt, + classesindexTemplate.process(classes) + ); - try { - var fileindexTemplate = new JSDOC.JsPlate(publish.conf.templatesDir+"allfiles.tmpl"); - } - catch(e) { print(e.message); quit(); } + // blank everything???? classesindexTemplate = classesIndex = classes = null; + + + + var documentedFiles = symbols.filter(function ($) { + return ($.is("FILE")) + }); - var documentedFiles = symbols.filter(isaFile); var allFiles = []; for (var i = 0; i < files.length; i++) { - allFiles.push(new JSDOC.Symbol(files[i], [], "FILE", new JSDOC.DocComment("/** */"))); + allFiles.push(new Symbol(files[i], [], "FILE", new JSDOC.DocComment("/** */"))); } for (var i = 0; i < documentedFiles.length; i++) { @@ -264,13 +274,13 @@ BuildDocs = { } allFiles = allFiles.sort(makeSortby("name")); + File.write(Options.target , "/files."+Options.publishExt, + fileindexTemplate.process(allFiles) + ); + + }, - var filesIndex = fileindexTemplate.process(allFiles); - IO.saveFile(publish.conf.outDir, "files"+publish.conf.ext, filesIndex); - fileindexTemplate = filesIndex = files = null; - } - - publishJSON = function(data) + publishJSON = function(file, data) { // what we need to output to be usefull... // a) props.. @@ -322,35 +332,31 @@ BuildDocs = { props : props, events: events }; - return JSON.encode(ret); + File.write(file, JSON.stringify(ret, null, 2 )); // b) methods // c) events - } - makeSrcFile: function(path, srcDir, name) { - if (Options.outputSource) return; + }, + makeSrcFile: function(sourceFile) + { - return; // not done? if (!name) { - name = path.replace(/\.\.?[\\\/]/g, "").replace(/[\\\/]/g, "_"); + name = sourceFile.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); - } + var pretty = PrettyPrint.toPretty(File.read(sourceFile)); + File.write(Options.target+"/symbols/src" + prettyfile, + '' + + '' + files[i].substr(spath.length+1) + '' + + '' + + '' + + pretty + + ''); }