chore(docs): setting up dgeni and circle CI

scripts/docs/processors/hide-private-api.js

@@ -0,0 +1,18 @@
+module.exports = function removePrivateApi() {
+  return {
+    name: 'remove-private-api',
+    description: 'Prevent the private apis from being rendered',
+    $runBefore: ['rendering-docs'],
+    $process: function(docs) {
+      var publicDocs = [];
+       docs.forEach(function(doc){
+        if(!doc.private){
+          publicDocs.push(doc);
+          return doc
+        }
+      })
+     docs = publicDocs;
+     return docs;
+    }
+  }
+};

scripts/docs/processors/jekyll.js

@@ -0,0 +1,35 @@
+module.exports = function jekyll(renderDocsProcessor) {
+  return {
+    name: 'jekyll',
+    description: 'Create jekyll includes',
+    $runAfter: ['paths-computed'],
+    $runBefore: ['rendering-docs'],
+    $process: function(docs) {
+      var currentVersion = renderDocsProcessor.extraData.version.current.name;
+
+      // pretty up and sort the docs object for menu generation
+      docs = docs.filter(function(doc) {
+        return (!!doc.name && !!doc.outputPath) || doc.docType === 'index-page';
+      });
+      docs.sort(function(a, b) {
+        textA = a.name ? a.name.toUpperCase() : '';
+        textB = b.name ? b.name.toUpperCase() : '';
+        return (textA < textB) ? -1 : (textA > textB) ? 1 : 0;
+      });
+      docs.forEach(function(doc, i) {
+        docs[i].URL = doc.outputPath.replace('docs/v2//','docs/v2/')
+                                    .replace('/index.md','');
+      });
+
+      docs.push({
+        docType: 'platform_menu-menu',
+        id: 'platform_menu-menu',
+        template: 'platform_menu.template.html',
+        outputPath: '_includes/v2_fluid/platform_menu.html'
+      });
+
+      // returning docs will replace docs object in the next process
+      return docs;
+    }
+  };
+};

scripts/docs/processors/latest-version.js

@@ -0,0 +1,33 @@
+var copy = require('cpr').cpr;
+var mkdirp = require('mkdirp');
+var path = require('canonical-path');
+var q = require('q');
+var fs = require('fs');
+
+module.exports = function latestVersion(renderDocsProcessor) {
+  return {
+    name: 'latest-version',
+    $runAfter: ['files-written'],
+    description: 'Copy the latest version (that was compiled to docs/) into docs/versionName',
+    $process: function(docs) {
+      var versionData = renderDocsProcessor.extraData.version;
+
+      var docsBase = 'dist/ionic-site/docs/v2/';
+      var versionDir = path.resolve(docsBase, versionData.latest.name);
+      var latestDir = path.resolve(docsBase, 'api');
+
+      var deferred = q.defer();
+
+      mkdirp(versionDir, function() {
+        copy(latestDir, path.join(versionDir, 'api'), {
+          deleteFirst: true,
+          overwrite: true
+        }, function(err, files) {
+          deferred.resolve(docs);
+        });
+      });
+
+      return deferred.promise;
+    }
+  }
+};

scripts/docs/processors/remove-private-members.js

@@ -0,0 +1,19 @@
+module.exports = function removePrivateMembers() {
+  return {
+    name: 'remove-private-members',
+    description: 'Remove member docs with @private tags',
+    $runAfter: ['tags-parsed'],
+    $runBefore: ['rendering-docs'],
+    $process: function(docs) {
+      docs.forEach(function(doc){
+        if (doc.members) {
+          doc.members = doc.members.filter(function(member){
+            return !member.tags.tagsByName.get("private");
+          })
+        }
+      })
+
+      return docs;
+    }
+  }
+};