documentation/default-theme/index.js

'use strict';

var fs = require('fs'),
  path = require('path'),
  File = require('vinyl'),
  vfs = require('vinyl-fs'),
  _ = require('lodash'),
  concat = require('concat-stream'),
  formatMarkdown = require('./lib/format_markdown'),
  formatParameters = require('./lib/format_parameters');

module.exports = function (comments, options, callback) {

  var highlight = require('./lib/highlight')(options.hljs || {});

  var namespaces = comments.map(function (comment) {
    return comment.namespace;
  });

  var imports = {
    shortSignature: function (section, hasSectionName) {
      var prefix = '';
      if (section.kind === 'class') {
        prefix = 'new ';
      }
      if (section.kind !== 'function' && !hasSectionName) {
        return '';
      }
      if (hasSectionName) {
        return prefix + section.name + formatParameters(section, true);
      } else if (!hasSectionName && formatParameters(section)) {
        return formatParameters(section, true);
      }
      return '()';
    },
    signature: function (section, hasSectionName) {
      var returns = '';
      var prefix = '';
      if (section.kind === 'class') {
        prefix = 'new ';
      } else if (section.kind !== 'function') {
        return section.name;
      }
      if (section.returns) {
        returns = ': ' +
          formatMarkdown.type(section.returns[0].type, namespaces);
      }
      if (hasSectionName) {
        return prefix + section.name +
          formatParameters(section) + returns;
      } else if (!hasSectionName && formatParameters(section)) {
        return section.name + formatParameters(section) + returns;
      }
      return section.name + '()' + returns;
    },
    md: function (ast, inline) {
      if (inline && ast && ast.children.length && ast.children[0].type === 'paragraph') {
        ast = {
          type: 'root',
          children: ast.children[0].children.concat(ast.children.slice(1))
        };
      }
      return formatMarkdown(ast, namespaces);
    },
    formatType: function (section) {
      return formatMarkdown.type(section.type, namespaces);
    },
    autolink: function (text) {
      return formatMarkdown.link(namespaces, text);
    },
    highlight: function (str) {
      return highlight(str);
    }
  };

  var pageTemplate = _.template(fs.readFileSync(path.join(__dirname, 'index._'), 'utf8'), {
    imports: {
      renderSection: _.template(fs.readFileSync(path.join(__dirname, 'section._'), 'utf8'), {
        imports: imports
      }),
      renderNote: _.template(fs.readFileSync(path.join(__dirname, 'note._'), 'utf8'), {
        imports: imports
      }),
      renderSectionList: _.template(fs.readFileSync(path.join(__dirname, 'section_list._'), 'utf8'), {
        imports: imports
      }),
      highlight: function (str) {
        return highlight(str);
      }
    }
  });

  // push assets into the pipeline as well.
  vfs.src([__dirname + '/assets/**'], { base: __dirname })
    .pipe(concat(function (files) {
      callback(null, files.concat(new File({
        path: 'index.html',
        contents: new Buffer(pageTemplate({
          docs: comments,
          options: options
        }), 'utf8')
      })));
    }));
};