chore(): begin adding ionic components to mono-repo.

packages/ionic-angular/scripts/docs/dgeni-config.js

@@ -0,0 +1,192 @@
+var Package = require('dgeni').Package;
+var jsdocPackage = require('dgeni-packages/jsdoc');
+var nunjucksPackage = require('dgeni-packages/nunjucks');
+var typescriptPackage = require('dgeni-packages/typescript');
+var linksPackage = require('dgeni-packages/links');
+var gitPackage = require('dgeni-packages/git');
+var path = require('path');
+var semver = require('semver');
+var fs = require('fs');
+var _ = require('lodash');
+var config = require('../config.json');
+
+// Define the dgeni package for generating the docs
+module.exports = function(currentVersion, initialVersionBuild) {
+
+  return new Package('ionic-v2-docs',
+                     [jsdocPackage, nunjucksPackage, typescriptPackage,
+                      linksPackage, gitPackage])
+
+.processor(require('./processors/latest-version'))
+.processor(require('./processors/index-page'))
+.processor(require('./processors/remove-private-members'))
+.processor(require('./processors/jekyll'))
+.processor(require('./processors/hide-private-api'))
+.processor(require('./processors/collect-inputs-outputs'))
+.processor(require('./processors/parse-returns-object'))
+.processor(require('./processors/parse-optional'))
+.processor(require('./processors/parse-sass'))
+
+// for debugging docs
+// .processor(function test(){
+//   return {
+//
+//     $runBefore: ['rendering-docs'],
+//     $process: function(docs){
+//       docs.forEach(function(doc){
+//         if (doc.name == "Searchbar"){
+//           console.log(doc.input);
+//           doc.members.forEach(function(method){
+//             if (method.name === "load") {
+//               console.log(method);
+//             }
+//           })
+//         }
+//       })
+//     }
+//   }
+// })
+
+.config(function(log) {
+  log.level = 'error'; //'silly', 'debug', 'info', 'warn', 'error'
+})
+
+.config(function(renderDocsProcessor, computePathsProcessor, versionInfo) {
+  try {
+    versions = fs.readdirSync(path.resolve(__dirname, '../../' + config.docsDest + '/'))
+      .filter(semver.valid)
+  } catch(e) {
+    versions = [];
+  }
+
+  // new version, add it to the versions list
+  if (currentVersion != 'nightly' && !_.includes(versions, currentVersion)){
+    versions.unshift(currentVersion);
+  }
+
+  // sort by version so we can find latest
+  versions.sort(semver.rcompare);
+  // add nightly if it isn't in the list
+  !_.includes(versions, 'nightly') && versions.unshift('nightly');
+
+  //First semver valid version is latest
+  var latestVersion = _.find(versions, semver.valid);
+  versions = versions.map(function(version) {
+    // Set nightly as docs root
+    //var folder = version == 'nightly' ? '' : version;
+    //Instead set latest version in docs root if not initial build
+    var folder = (version == latestVersion) && !initialVersionBuild ? '' : version;
+    return {
+      href: path.join('/' + config.v2DocsDir, folder).replace('/content',''),
+      folder: folder,
+      name: version
+    };
+  });
+
+  var versionData = {
+    list: versions,
+    current: _.find(versions, { name: currentVersion }),
+    latest: _.find(versions, {name: latestVersion}) || _.first(versions),
+    initialVersionBuild: initialVersionBuild
+  };
+
+  renderDocsProcessor.extraData.version = versionData;
+  renderDocsProcessor.extraData.versionInfo = versionInfo;
+
+  computePathsProcessor.pathTemplates = [{
+    docTypes: ['class', 'var', 'function', 'let'],
+    getOutputPath: function(doc) {
+      // strip ionic from path root
+      var docPath = doc.fileInfo.relativePath.replace(/^src\//, '');
+      // remove filename since we have multiple docTypes per file
+      docPath = docPath.substring(0, docPath.lastIndexOf('/') + 1);
+      docPath += doc.name + '/index.md';
+      var path = config.v2DocsDir + '/' + (versionData.current.folder || '') +
+                     '/api/' +  docPath;
+      path = path.replace('/home/ubuntu/ionic/src', '')
+              .replace(__dirname.replace('ionic/scripts/docs', ''),'')
+              .replace('/ionic/src','');
+      return path;
+    }
+  }];
+})
+
+//configure file reading
+.config(function(readFilesProcessor, readTypeScriptModules) {
+
+  // Don't run unwanted processors since we are not using the normal file reading processor
+  readFilesProcessor.$enabled = false;
+  readFilesProcessor.basePath = path.resolve(__dirname, '../..');
+
+  readTypeScriptModules.basePath = path.resolve(path.resolve(__dirname, '../..'));
+  readTypeScriptModules.sourceFiles = [
+    'src/index.ts'
+  ];
+})
+
+.config(function(parseTagsProcessor) {
+  parseTagsProcessor.tagDefinitions = parseTagsProcessor.tagDefinitions.concat(require('./tag-defs/tag-defs'));
+})
+
+// .config(function(parseTagsProcessor) {
+//   // We actually don't want to parse param docs in this package as we are getting the data out using TS
+//   parseTagsProcessor.tagDefinitions.forEach(function(tagDef) {
+//     console.log(tagDef);
+//     if (tagDef.name === 'param') {
+//       tagDef.docProperty = 'paramData';
+//       tagDef.transforms = [];
+//     }
+//   });
+// })
+
+// Configure allowedDocTypes
+.config(function(extractAccessTransform) {
+  var allowedDocTypes = ['member'];
+  allowedDocTypes.forEach(function(docType) {
+    extractAccessTransform.allowedDocTypes.add(docType);
+  });
+})
+
+// Configure links
+.config(function(getLinkInfo) {
+  getLinkInfo.useFirstAmbiguousLink = false;
+})
+
+// Configure file writing
+.config(function(writeFilesProcessor) {
+  writeFilesProcessor.outputFolder  = config.sitePath;
+})
+
+// Configure rendering
+.config(function(templateFinder, templateEngine) {
+
+  // Nunjucks and Angular conflict in their template bindings so change the Nunjucks
+  // Also conflict with Jekyll
+  templateEngine.config.tags = {
+    variableStart: '<$',
+    variableEnd: '$>',
+    blockStart: '<@',
+    blockEnd: '@>',
+    commentStart: '<#',
+    commentEnd: '#>'
+  };
+
+  // add custom filters to nunjucks
+  templateEngine.filters.push(
+    require('./filters/capital'),
+    require('./filters/code'),
+    require('./filters/dump'),
+    require('./filters/platform')
+  );
+
+  templateFinder.templateFolders.unshift(path.resolve(__dirname, 'templates'));
+
+  // Specify how to match docs to templates.
+  templateFinder.templatePatterns = [
+    '${ doc.template }',
+    '${ doc.docType }.template.html',
+    'common.template.html'
+  ]
+})
+
+}