/* 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 = [ '
', '

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(/\.md/g, ".html") .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]; 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(/]*)>/, ''); } 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); } }); }