build(aio): move doc-gen stuff from angular.io (#14097)

tools/docs/examples-package/processors/collect-examples.js

@@ -0,0 +1,67 @@
+const {mapObject} = require('../utils');
+
+module.exports = function collectExamples(exampleMap, regionParser, log, createDocMessage) {
+  return {
+    $runAfter: ['files-read'],
+    $runBefore: ['parsing-tags'],
+    $validate: {exampleFolders: {presence: true}},
+    $process: function(docs) {
+      const exampleFolders = this.exampleFolders;
+      const regionDocs = [];
+      docs = docs.filter((doc) => {
+        if (doc.docType === 'example-file') {
+          try {
+            // find the first matching folder
+            exampleFolders.some((folder) => {
+              if (doc.fileInfo.relativePath.indexOf(folder) === 0) {
+                const relativePath =
+                    doc.fileInfo.relativePath.substr(folder.length).replace(/^\//, '');
+                exampleMap[folder] = exampleMap[folder] || {};
+                exampleMap[folder][relativePath] = doc;
+
+                const parsedRegions = regionParser(doc.content, doc.fileInfo.extension);
+
+                log.debug(
+                    'found example file', folder, relativePath, Object.keys(parsedRegions.regions));
+
+                doc.renderedContent = parsedRegions.contents;
+
+                // Map each region into a doc that can be put through the rendering pipeline
+                doc.regions = mapObject(parsedRegions.regions, (regionName, regionContents) => {
+                  const regionDoc =
+                      createRegionDoc(folder, relativePath, regionName, regionContents);
+                  regionDocs.push(regionDoc);
+                  return regionDoc;
+                });
+
+                return true;
+              }
+            });
+
+            return false;
+
+          } catch (e) {
+            throw new Error(createDocMessage(e.message, doc, e));
+          }
+        } else {
+          return true;
+        }
+      });
+
+      return docs.concat(regionDocs);
+    }
+  };
+};
+
+function createRegionDoc(folder, relativePath, regionName, regionContents) {
+  const path = folder + '/' + relativePath;
+  const id = path + '#' + regionName
+  return {
+    docType: 'example-region',
+    path: path,
+    name: regionName,
+    id: id,
+    aliases: [id],
+    contents: regionContents
+  };
+}