0

Reference Documentation Anchor Links

Michael Mortensen

25 January 2013 00:27

None

Follow

Is it possible for Document! X to do a target="_blank" on all external referenced namespaces?

For instance, if i specify %Cuemon.Annotations% it correctly links to my assemblies with a default target of _self as expected.
However, if I reference %System.Annotations% then I would expect these to have a default target of _blank instead of _self.
This should - IMO - apply to all namespaces different from what you are documenting. 

Is this possible with a hidden setting?

I am using the latest version of Document! X (2012.1.108.0). 

Thanks in advance for your help.

• Facebook
• Twitter
• LinkedIn

3 comments

• 0
  
  Permanently deleted user 29 January 2013 13:23

  Personally, I like to retain the context of the Table of Contents etc. when calling out to MSDN links, but I can see how you might prefer those pages to open in a separate tab.

  If you are generating help for outputs other than Microsoft Help Viewer or Help 2.x, the links to external namespaces are funneled through a navigateToHelp2Keyword() javascript function. So you could create a custom template and modify the javascript in there to open a new window.

  If you are using the 2012 template, that code is in the dx.net.2012.js javascript file.

• 0
  
  Michael Mortensen 29 January 2013 14:14

  Hi Richard,

  Thank you for the suggestion; I will try to decipher and modify the dx.net.2012.js file.
  It would be nice though, if this could be possible from your UI in a future version .. just an idea .. :-)

• 0
  
  Michael Mortensen 29 January 2013 21:18

  For those who might be interested, i followed Richard's advise and made the following change:
  
  From:

  function navigateToHelp2Keyword(Keyword, OnlineKeyword, ReplacePage) {
  window.status = "Resolving link. Please wait a moment...";
  var URL = resolveHelp2Keyword(Keyword, OnlineKeyword);
  window.status = "";
  if (ReplacePage == true) {
  location.replace(URL);
  }
  else {
  window.open(URL);
  }
  }

  To:

  function navigateToHelp2Keyword(Keyword, OnlineKeyword, ReplacePage) {
  window.status = "Resolving link. Please wait a moment...";
  var URL = resolveHelp2Keyword(Keyword, OnlineKeyword);
  window.status = "";
  if (ReplacePage == true) {
  window.open(URL, '_blank', '', true);
  }
  else {
  window.open(URL, '_blank');
  }
  }

  It works like a charm and once again proves the excellent flexibility of Document! X - thanks.