node2docfx/jsdocs/plugins/dfm.js

(function () {
  function convertLinkToGfm(text, uidPrefix) {
    var linkRules = [
      {
        // [link text]{@link namepathOrURL}
        regexp: /\[(?:([^\]]+))\]{(@link|@linkcode|@linkplain) +([^}| ]+)}/g,
        callback: function (match, p1, p2, p3) {
          return generateDfmLink(p2, p3, p1);
        }
      },
      {
        // {@link namepathOrURL}
        // {@link namepathOrURL|link text}
        // {@link namepathOrURL link text (after the first space)}
        regexp: /\{(@link|@linkcode|@linkplain) +([^}| ]+)(?:(?:\|| +)([^}]+))?\}/g,
        callback: function (match, p1, p2, p3) {
          return generateDfmLink(p1, p2, p3);
        }
      }
    ];

    if (!text) return '';
    var result = text;
    linkRules.forEach(function (r) {
      result = result.replace(r.regexp, r.callback);
    });
    return result;

    function generateDfmLink(tag, target, text) {
      var result = '';
      if (!text) {
        // if link text is undefined, it must link to namepath(uid)
        result = '<xref:' + convertNamepathToUid(target) + '>';
        if (tag === '@linkcode') {
          return '<code>' + result + '</code>';
        }
      } else {
        result = text;
        if (tag === '@linkcode') {
          result = '<code>' + result + '</code>';
        }
        result = '[' + result + '](';
        // http://stackoverflow.com/questions/3809401/what-is-a-good-regular-expression-to-match-a-url#answer-3809435
        if (!/https?:\/\/(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&//=]*)/.test(target)) {
          // if target isn't a url, it must be a namepath(uid)
          result += 'xref:';
          target = convertNamepathToUid(target);
        }
        result += target + ')';
      }
      return result;

      function convertNamepathToUid(namepath) {
        var uid = encodeURIComponent(namepath);
        if (uidPrefix) {
          uid = uidPrefix + uid;
        }
        return uid;
      }
    }
  }

  module.exports = {
    convertLinkToGfm: convertLinkToGfm
  };
})();