chore(docs): add a processor to get the name of a guide doc from its markdown

Author: petebacondarwin

docs/dgeni-package/index.js

@@ -29,7 +29,7 @@ module.exports = new Package('angular', [jsdocPackage, nunjucksPackage])
 .processor(require('./processors/processModuleDocs'))
 .processor(require('./processors/processClassDocs'))
 .processor(require('./processors/generateNavigationDoc'))
-
+.processor(require('./processors/extractTitleFromGuides'))
 
 // Configure the log service
 .config(function(log) {

docs/dgeni-package/processors/extractTitleFromGuides.js

@@ -0,0 +1,24 @@
+var _ = require('lodash');
+
+module.exports = function extractTitleFromGuides() {
+
+  return {
+    $runAfter: ['processing-docs'],
+    $runBefore: ['docs-processed'],
+    $process: function(docs) {
+      _(docs).forEach(function(doc) {
+        if (doc.docType === 'guide') {
+          doc.name = doc.name || getNameFromHeading(doc.description);
+        }
+      });
+    }
+  };
+};
+
+
+function getNameFromHeading(text) {
+  var match = /^\s*#\s*(.*)/.exec(text);
+  if (match) {
+    return match[1];
+  }
+}