1 //<Script type="text/javascript">
6 XObject = imports.XObject.XObject;
10 File = imports.File.File;
11 console = imports.console.console;
12 Introspect = imports['JSDOC/Introspect.js'].Introspect;
13 Template = imports['JSDOC/Template.js'].Template;
16 var outputdir = Seed.argv[2];
20 name: "ArgumentError",
21 message: "No output directory specified on the command line\n" +
22 "Usage seed docs.js /var/www/seed [Gtk] \n"
27 if (!File.isDirectory(outputdir)) {
28 console.log("Creating directory " + outputdir);
29 File.mkdir(outputdir);
33 // Which libraries to build.
35 var ns_list = Introspect.namespaces();
36 if (typeof(Seed.argv[3]) == 'string') {
37 console.log(Seed.argv.length);
38 ns_list = Seed.argv[3].split(',');
41 ns_list = ns_list.sort();
44 // which languages do we want to output for.
46 File.list(__script_path__ + '/templates/').forEach(function(f) {
47 if (!File.isDirectory(__script_path__ + '/templates/' + f)) {
50 if (f == 'resources') {
55 cls_template : new Template(__script_path__ + '/templates/' + f + '/class.html'),
56 cls_ix_template : new Template(__script_path__ + '/templates/' + f + '/class_ix.html'),
57 reference_template : new Template(__script_path__ + '/templates/' + f + '/references.html'),
63 var cls_template = new Template(__script_path__ + '/templates/class.html');
64 var cls_ix_template = new Template(__script_path__ + '/templates/class_ix.html');
65 var reference_template = new Template(__script_path__ + '/templates/references.html');
70 ns_list.forEach(function(ns_name)
73 //if (ns_idx.length) { return ;/* do one - for testing */ }
75 var core = imports.gi[ns_name];
76 var idx = { name: ns_name};
77 console.log("START:" + ns_name);
79 var ns = Introspect.ns(ns_name);
81 // gir goes in top level...
82 if (File.exists(ns.gir_file)) {
83 File.copyFile(ns.gir_file, outputdir + '/'+ ns.gir_filename, Gio.FileCopyFlags.OVERWRITE);
87 ns['left_bar'] = cls_ix_template.process(ns);
89 langs.forEach(function(lang) {
91 Gio.simple_write(outputdir + '/'+ lang.name+ '/' +ns_name + '.html', lang.cls_template.process(ns));
93 // left bar index of elements in namespace...
94 Gio.simple_write(outputdir + '/'+ lang.name + '/_ix_'+ ns_name + '.shtml', lang.cls_ix_template.process(ns));
101 'interfaces' : 'Interface',
102 'structs' : 'Struct',
107 for (var i in actions) {
108 // we flag GLib as a GObject lib...
109 idx[i]= ns_name == 'GLib' ? 1 : ns[i].length ;
110 ns[i].forEach( function(n) {
111 var odata = XObject.extend(
112 Introspect.factory(actions[i], ns_name, n),
113 { 'left_bar' :ns['left_bar'] }
115 langs.forEach(function(lang) {
116 Gio.simple_write(outputdir + '/'+ lang.name + '/' + ns_name + '.' + n + '.html',
117 lang.cls_template.process(odata)
120 console.log(ns_name + '.' +n);
128 var html_file_path = '';
131 // output cross reference data..
132 langs.forEach(function(lang) {
134 for (var i in Introspect.references) {
136 html_file_path = [ outputdir, lang.name, i + '.html'].join('/');
138 if (i == 'undefined') {
139 console.log("Undefined name space - ignored");
143 if (!File.isFile(html_file_path)) {
144 console.log("No HTML file " + html_file_path + " to insert references into - ignored");
148 refs = langs.reference_template.process(Introspect.references[i]);
150 // HTML to put refs into
151 html = File.read(html_file_path);
153 // do the replacement
154 html = html.replace(/\<!--references--\>/, refs);
156 // write back to file
157 Gio.simple_write(html_file_path, html);
161 var ix_template = new Template(__script_path__ + '/templates/index.html');
162 Gio.simple_write(outputdir + '/index.html', ix_template.process(ns_idx));
163 File.silentRecursiveCopy(__script_path__ + '/templates/resources/', outputdir, Gio.FileCopyFlags.OVERWRITE);