138 lines
3.4 KiB
JavaScript
138 lines
3.4 KiB
JavaScript
/*
|
|
Process a single doc file
|
|
|
|
argv[2] = template file
|
|
argv[3] = input file
|
|
argv[4] = output file
|
|
*/
|
|
|
|
var fs = require("fs");
|
|
var path = require("path");
|
|
var markdown = require("./lib/markdown");
|
|
var argv = process.argv;
|
|
var argc = argv.length;
|
|
var template = fs.readFileSync(argv[2], "utf8");
|
|
|
|
|
|
function formatIdString( str ) {
|
|
str = str
|
|
.replace(/\([^)}]*\)/gmi, "")
|
|
.replace(/[^A-Za-z0-9_.]+/gmi, "_");
|
|
return str.substr(0, 1).toLowerCase() + str.substr(1);
|
|
}
|
|
|
|
|
|
function generateToc(data) {
|
|
var last_level = 0;
|
|
var first_level = 0;
|
|
var toc = [ '<div id="toc">', '<h2>Table Of Contents</h2>' ];
|
|
|
|
data.replace(/(^#+)\W+([^$\n]+)/gmi, function(src, level, text) {
|
|
level = level.length;
|
|
|
|
if (first_level == 0) first_level = level;
|
|
|
|
if (level <= last_level) toc.push("</li>");
|
|
|
|
if (level > last_level) {
|
|
toc.push("<ul>");
|
|
} else if (level < last_level) {
|
|
for (var c = last_level-level; 0 < c ; c--) {
|
|
toc.push("</ul>");
|
|
toc.push("</li>");
|
|
}
|
|
}
|
|
|
|
toc.push("<li>");
|
|
toc.push('<a href="#'+formatIdString(text)+'">'+text+'</a>');
|
|
|
|
last_level = level;
|
|
});
|
|
|
|
for (var c = last_level-first_level; 0 <= c ; c--) {
|
|
toc.push("</li>");
|
|
toc.push("</ul>");
|
|
}
|
|
|
|
toc.push("<hr />")
|
|
toc.push("</div>");
|
|
|
|
return toc.join("");
|
|
}
|
|
|
|
|
|
var includeExpr = /^@include\s+([A-Za-z0-9-_]+)(?:\.)?([a-zA-Z]*)$/gmi;
|
|
// Allow including other pages in the data.
|
|
function loadIncludes(data, current_file) {
|
|
return data.replace(includeExpr, function(src, name, ext) {
|
|
try {
|
|
var include_path =
|
|
path.join(current_file, "../", name+"."+(ext || "markdown"))
|
|
return loadIncludes(fs.readFileSync(include_path, "utf8"), current_file);
|
|
} catch(e) {
|
|
return "";
|
|
}
|
|
});
|
|
}
|
|
|
|
|
|
function convertData(data) {
|
|
// Convert it to HTML from Markdown
|
|
var html = markdown.toHTML(markdown.parse(data), {xhtml:true})
|
|
.replace(/<hr><\/hr>/g, "<hr />")
|
|
.replace(/\.md/g, ".html")
|
|
.replace(/(\<h[2-6])\>([^<]+)(\<\/h[1-6]\>)/gmi, function(o, ts, c, te) {
|
|
return ts+' id="'+formatIdString(c)+'">'+c+te;
|
|
});
|
|
|
|
return html;
|
|
}
|
|
|
|
|
|
if (argc > 3) {
|
|
var filename = argv[3];
|
|
var output = template;
|
|
var version = require(__dirname + '/../package.json').version;
|
|
var html;
|
|
|
|
fs.readFile(filename, "utf8", function(err, data) {
|
|
if (err) throw err;
|
|
|
|
// go recursion.
|
|
data = loadIncludes(data, filename);
|
|
// go markdown.
|
|
html = convertData(data);
|
|
filename = path.basename(filename, '.md');
|
|
|
|
if (filename != "_toc" && filename != "index") {
|
|
if (data) {
|
|
html = generateToc(data) + "\n" + html;
|
|
}
|
|
|
|
var nfilename =
|
|
filename.replace(/[_-]/g, ' ').replace(/\w\S*/g, function(txt){
|
|
return txt.charAt(0).toUpperCase() + txt.substr(1).toLowerCase()
|
|
});
|
|
output = output.replace(/{{section}}/g, nfilename)
|
|
} else {
|
|
output = output.replace(/{{section}}/g, "");
|
|
output = output.replace(/<body([^>]*)>/,
|
|
'<body class="'+filename+'" $1>');
|
|
}
|
|
|
|
if (html.length == 0) {
|
|
html = "Sorry, this section is currently undocumented, \
|
|
but we'll be working on it.";
|
|
}
|
|
output = output.replace(/{{content}}/g, html);
|
|
|
|
output = output.replace(/{{version}}/g, 'v' + version);
|
|
|
|
if (argc > 4) {
|
|
fs.writeFileSync(argv[4], output);
|
|
} else {
|
|
process.stdout.write(output);
|
|
}
|
|
});
|
|
}
|