link.js

var INLINE_LINK = /(\S+)(?:\s+(.+))?/;
var log = require('winston');

module.exports = {
  name: 'link',
  description: 'Process inline link tags (of the form {@link some/uri Some Title}), replacing them with HTML anchors',
  handlerFactory: function(partialNames, config) {

    return function handleLinkTags(doc, tagName, tagDescription) {
      var versionData = config.get('versionData');

      // Parse out the uri and title
      return tagDescription.replace(INLINE_LINK, function(match, uri, title) {

        var linkInfo = partialNames.getLink(uri, title, doc);

        if ( !linkInfo.valid ) {
          log.warn(linkInfo.error, 'in', doc.relativePath + '#' + doc.name);
          linkInfo.title = 'TODO:' + linkInfo.title;
        }

        return '<a href="' + versionData.current.href + '/' + linkInfo.url + '">' + linkInfo.title + '</a>';
      });
    };
  }
};