api-builder: move ngdoc stuff out from doc-package and into content package

tools/api-builder/docs-package/index.js

@@ -10,9 +10,6 @@ var fs = require('fs');
 // Define the dgeni package for generating the docs
 module.exports = new Package('angular-v2-docs', [jsdocPackage, nunjucksPackage, typescriptPackage, linksPackage, gitPackage])
 
-// Register the services and file readers
-.factory(require('./readers/ngdoc'))
-
 // Register the processors
 .processor(require('./processors/convertPrivateClassesToInterfaces'))
 .processor(require('./processors/extractDirectiveClasses'))
@@ -36,9 +33,8 @@ module.exports = new Package('angular-v2-docs', [jsdocPackage, nunjucksPackage,
 })
 
 // Configure file reading
-.config(function(readFilesProcessor, ngdocFileReader, readTypeScriptModules) {
-  readFilesProcessor.fileReaders = [ngdocFileReader];
-  // set the readFilesProcessor base path to point to angular repo.
+.config(function(readTypeScriptModules) {
+
   var angular_repo_path =  path.resolve(__dirname, '../../../../angular');
   // confirm that the angular repo is actually there.
   if (!fs.existsSync(angular_repo_path)) {
@@ -54,6 +50,7 @@ module.exports = new Package('angular-v2-docs', [jsdocPackage, nunjucksPackage,
 
 .config(function(parseTagsProcessor, getInjectables) {
   // We actually don't want to parse param docs in this package as we are getting the data out using TS
+  // TODO: rewire the param docs to the params extracted from TS
   parseTagsProcessor.tagDefinitions.forEach(function(tagDef) {
     if (tagDef.name === 'param') {
       tagDef.docProperty = 'paramData';
@@ -95,29 +92,4 @@ module.exports = new Package('angular-v2-docs', [jsdocPackage, nunjucksPackage,
     '${ doc.docType }.template.html',
     'common.template.html'
   ];
-})
-
-
-// Configure ids and paths
-.config(function(computeIdsProcessor, computePathsProcessor) {
-
-  computeIdsProcessor.idTemplates.push({
-    docTypes: ['guide'],
-    getId: function(doc) {
-      return doc.fileInfo.relativePath
-                    // path should be relative to `modules` folder
-                    .replace(/.*\/?modules\//, '')
-                    // path should not include `/docs/`
-                    .replace(/\/docs\//, '/')
-                    // path should not have a suffix
-                    .replace(/\.\w*$/, '');
-    },
-    getAliases: function(doc) { return [doc.id]; }
-  });
-
-  computePathsProcessor.pathTemplates.push({
-    docTypes: ['guide'],
-    pathTemplate: '/${id}',
-    outputPathTemplate: 'partials/guides/${id}.html'
-  });
-});
+});

tools/api-builder/docs-package/readers/ngdoc.js

@@ -1,32 +0,0 @@
-var path = require('canonical-path');
-
-/**
- * @dgService ngdocFileReader
- * @description
- * This file reader will pull the contents from a text file (by default .ngdoc)
- *
- * The doc will initially have the form:
- * ```
- * {
- *   content: 'the content of the file',
- *   startingLine: 1
- * }
- * ```
- */
-module.exports = function ngdocFileReader() {
-  var reader = {
-    name: 'ngdocFileReader',
-    defaultPattern: /\.md$/,
-    getDocs: function(fileInfo) {
-
-      // We return a single element array because ngdoc files only contain one document
-      return [{
-        docType: 'guide',
-        content: fileInfo.content,
-        startingLine: 1
-      }];
-    }
-  };
-
-  return reader;
-};

tools/api-builder/docs-package/readers/ngdoc.spec.js

@@ -1,45 +0,0 @@
-var ngdocFileReaderFactory = require('./ngdoc');
-var path = require('canonical-path');
-
-describe('ngdocFileReader', function() {
-
-  var fileReader;
-
-  var createFileInfo = function(file, content, basePath) {
-    return {
-      fileReader: fileReader.name,
-      filePath: file,
-      baseName: path.basename(file, path.extname(file)),
-      extension: path.extname(file).replace(/^\./, ''),
-      basePath: basePath,
-      relativePath: path.relative(basePath, file),
-      content: content
-    };
-  };
-
-
-  beforeEach(function() {
-    fileReader = ngdocFileReaderFactory();
-  });
-
-
-  describe('defaultPattern', function() {
-    it('should match .md files', function() {
-      expect(fileReader.defaultPattern.test('abc.md')).toBeTruthy();
-      expect(fileReader.defaultPattern.test('abc.js')).toBeFalsy();
-    });
-  });
-
-
-  describe('getDocs', function() {
-    it('should return an object containing info about the file and its contents', function() {
-      var fileInfo = createFileInfo('project/path/modules/someModule/foo/docs/subfolder/bar.ngdoc', 'A load of content', 'project/path');
-      expect(fileReader.getDocs(fileInfo)).toEqual([{
-        docType: 'guide',
-        content: 'A load of content',
-        startingLine: 1
-      }]);
-    });
-  });
-});
-