/* Process a single doc file argv[2] = template file argv[3] = input file argv[4] = output file */ var fs = require("fs"), path = require("path"), markdown = require("./markdown"), argv = process.argv, 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 , first_level = 0 , toc = [ '
', '

Table Of Contents

' ]; 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(""); } if (level > last_level) { toc.push(""); toc.push(""); } } toc.push("
  • "); toc.push(''+text+''); last_level = level; }); for(var c=last_level-first_level; 0 <= c ; c-- ) { toc.push("
    • "); toc.push(""); } toc.push("
    ") toc.push("
    "); 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>/g, "
    ") .replace(/(\([^<]+)(\<\/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], output = template, 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, '.markdown'); if (filename != "_toc" && filename != "index") { if (data) { html = generateToc(data) + "\n" + html; } output = output.replace("{{section}}", filename+" - ") } else { output = output.replace("{{section}}", ""); output = output.replace(/]*)>/, ''); } if (html.length == 0) { html = "Sorry, this section is currently undocumented, \ but we'll be working on it."; } output = output.replace("{{content}}", html); if (argc > 4) { fs.writeFile(argv[4], output); } else { process.stdout.write(output); } }); }