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') {
57 cls_template : new Template(__script_path__ + '/templates/' + f + '/class.html'),
58 cls_ix_template : new Template(__script_path__ + '/templates/' + f + '/class_ix.html'),
59 reference_template : new Template(__script_path__ + '/templates/' + f + '/references.html'),
65 var cls_template = new Template(__script_path__ + '/templates/class.html');
66 var cls_ix_template = new Template(__script_path__ + '/templates/class_ix.html');
67 var reference_template = new Template(__script_path__ + '/templates/references.html');
72 ns_list.forEach(function(ns_name)
75 //if (ns_idx.length) { return ;/* do one - for testing */ }
77 var core = imports.gi[ns_name];
78 var idx = { name: ns_name};
79 console.log("START:" + ns_name);
81 var ns = Introspect.ns(ns_name);
83 if (File.exists(ns.gir_file)) {
84 File.copyFile(ns.gir_file, outputdir + '/'+ ns.gir_filename, Gio.FileCopyFlags.OVERWRITE);
88 ns['left_bar'] = cls_ix_template.process(ns);
91 Gio.simple_write(outputdir + '/'+ ns_name + '.html', cls_template.process(ns));
93 // left bar index of elements in namespace...
94 Gio.simple_write(outputdir + '/_ix_'+ ns_name + '.shtml', cls_ix_template.process(ns));
99 'interfaces' : 'Interface',
100 'structs' : 'Struct',
105 for (var i in actions) {
106 // we flag GLib as a GObject lib...
107 idx[i]= ns_name == 'GLib' ? 1 : ns[i].length ;
108 ns[i].forEach( function(n) {
111 Gio.simple_write(outputdir + '/'+ ns_name + '.' + n + '.html',
112 cls_template.process(
114 Introspect.factory(actions[i], ns_name, n),
115 { 'left_bar' :ns['left_bar'] }
120 console.log(ns_name + '.' +n);
128 var html_file_path = '';
132 for (var i in Introspect.references) {
133 html_file_path = File.join(outputdir, i + '.html');
135 if (i == 'undefined') {
136 console.log("Undefined name space - ignored");
139 if (!File.isFile(html_file_path)) {
140 console.log("No HTML file " + html_file_path + " to insert references into - ignored");
144 refs = reference_template.process(Introspect.references[i]);
146 // HTML to put refs into
147 html = File.read(html_file_path);
149 // do the replacement
150 html = html.replace(/\<!--references--\>/, refs);
152 // write back to file
153 Gio.simple_write(html_file_path, html);
157 var ix_template = new Template(__script_path__ + '/templates/index.html');
158 Gio.simple_write(outputdir + '/index.html', ix_template.process(ns_idx));
159 File.silentRecursiveCopy(__script_path__ + '/templates/resources/', outputdir, Gio.FileCopyFlags.OVERWRITE);