Include api docs in index

1 files changed, 54 insertions, 19 deletions

diff --git a/scripts/index-build.js b/scripts/index-build.js
index 412711a46..331fa3a48 100644
--- a/scripts/index-build.js
+++ b/scripts/index-build.js
@@ -1,25 +1,60 @@
 #!/usr/bin/env node
 var fs = require("fs")
   , path = require("path")
-  , docdir = path.resolve(__dirname, "..", "doc")
+  , cli = path.resolve(__dirname, "..", "doc", "cli")
+  , clidocs = null
+  , api = path.resolve(__dirname, "..", "doc", "api")
+  , apidocs = null
+  , readme = path.resolve(__dirname, "..", "README.md")
 
-console.log(
-  "npm-index(1) -- Index of all npm documentation\n" +
-  "==============================================\n")
-fs.readdir(docdir, function (er, docs) {
+fs.readdir(cli, done("cli"))
+fs.readdir(api, done("api"))
+
+function done (which) { return function (er, docs) {
   if (er) throw er
-  ;["../README.md"].concat(docs.filter(function (d) {
-    return d !== "index.md"
-         && d.charAt(0) !== "."
-         && d.match(/\.md$/)
-  })).forEach(function (d) {
-    var doc = path.resolve(docdir, d)
-      , s = fs.lstatSync(doc)
-      , content = fs.readFileSync(doc, "utf8").split("\n")[0].split("--")[1]
-
-    if (s.isSymbolicLink()) return
-
-    console.log(d.replace(/^.*?([^\/]*)\.md$/, "## npm-$1(1)") + "\n")
-    console.log(content + "\n")
+  if (which === "api") apidocs = docs
+  else clidocs = docs
+
+  if (apidocs && clidocs) next()
+}}
+
+function filter (d) {
+  return d !== "index.md"
+       && d.charAt(0) !== "."
+       && d.match(/\.md$/)
+}
+
+function next () {
+  console.log(
+    "npm-index(1) -- Index of all npm documentation\n" +
+    "==============================================\n")
+
+  apidocs = apidocs.filter(filter).map(function (d) {
+    return [3, path.resolve(api, d)]
   })
-})
+
+  clidocs = [[1, readme]].concat(clidocs.filter(filter).map(function (d) {
+    return [1, path.resolve(cli, d)]
+  }))
+
+  console.log("# Command Line Documentation")
+
+  clidocs.forEach(writeLine)
+
+  console.log("# API Documentation")
+  apidocs.forEach(writeLine)
+}
+
+function writeLine (sd) {
+  var sxn = sd[0]
+    , doc = sd[1]
+    , d = path.basename(doc, ".md")
+    , s = fs.lstatSync(doc)
+
+  if (s.isSymbolicLink()) return
+
+  var content = fs.readFileSync(doc, "utf8").split("\n")[0].split("--")[1]
+
+  console.log("## npm-%s(%d)\n", d, sxn)
+  console.log(content + "\n")
+}