ms-help://Hx/HxRuntime/HxLink.css and https://

Topics: User Forum
Jun 18, 2012 at 2:05 PM

I have built a website using SHFB and deployed it to an external web server, that is accessible only using the https: - protocol. When viewed in IE, I get messages:

"Internet Explorer restricted this webpage from running scripts or ActiveX controls"

and

"Only secure contents is displayed"

When viewed in Chrome, the https:// part of the URL is shown with a red line across it - which according to Google means: "The site uses SSL, but Google Chrome has detected either high-risk insecure content on the page or problems with the site’s certificate. "

I have isolated this problem to the fact, that the generated HTML-pages all contain the following markup:

<link rel="stylesheet" type="text/css" href="ms-help://Hx/HxRuntime/HxLink.css" />

As far as I can tell, ms-help:// refers to some Help compiler runtime. I am not sure that I can / am allowed to install this runtime on the server in question.

Microsoft says:

"HxLink.css is required for Help links (<MSHelp:link> links) to function correctly in the compiled Help file. Standard HTML-based links ("<a href>" links) are not affected by this style sheet."

- see http://msdn.microsoft.com/en-us/library/bb164680(v=vs.90).aspx 

I manually removed the reference from a couple of HTML-files - that eliminated the messages.

I tried building a website only (not a .chm-file), but the references causing the problem still appeared in the HTML files.

So my question is: is there a way to remove this reference from the generated HTML-files in the website? Those messages are annoying for my readers..

Coordinator
Jun 18, 2012 at 4:08 PM

A workaround for now would be to comment out the parts of the XSL transformations that put them in.  As long as you aren't generating anything other than Help 1 or website output, it won't harm anything.  Longer term, I can look at adding code to the HTML extract tool to remove those elements as they aren't needed for the Help 1 and website formats.

Eric

 

Jun 18, 2012 at 4:23 PM
Hi Eric.

Thank you for swift reply (as usual).

Well, I thought of that myself (after starting the discussion).
I am using the vs2005 presentation style, so I opened the file <program
files>\EWSoftware\Sandcastle Help File Builder\Templates\VS2005.xsl file,
commented out the offending line:
<!--<link rel="stylesheet" type="text/css"
href="ms-help://Hx/HxRuntime/HxLink.css" />-->
Then I rebuilt the website. But the stylesheet reference still appeared in
the generated HTML-files ?!?.
I even restarted Visual Studio and built once more - no change.
I could not find any other files to edit. Maybe I am doing something
wrong ? I will double-check tomorrow...

Regards,

Verner Lundsteen | Application Developer | +45 3614 7229

CSC • This is a PRIVATE message. If you are not the intended recipient,
please delete without copying and kindly advise us by e-mail of the mistake
in delivery. NOTE: Regardless of content, this e-mail shall not operate to
bind CSC to any order or other contract unless pursuant to explicit written
agreement or government initiative expressly permitting the use of e-mail
for such purpose • CSC Scandihealth A/S • Registered Office: P.O. Pedersens
Vej 2, 8200 Århus N, Denmark • Registered in Denmark No: 25469364




From: "EWoodruff" <[email removed]>
To: Verner K Lundsteen/DNK/CSC@CSC
Date: 18-06-2012 18:05
Subject: Re: ms-help://Hx/HxRuntime/HxLink.css and https://
[SHFB:359992]



From: EWoodruff


A workaround for now would be to comment out the parts of the XSL
transformations that put them in. As long as you aren't generating
anything other than Help 1 or website output, it won't harm anything.
Longer term, I can look at adding code to the HTML extract tool to remove
those elements as they aren't needed for the Help 1 and website formats.


Eric





Read the full discussion online.


To add a post to this discussion, reply to this email (
[email removed])


To start a new discussion for this project, email
[email removed]


You are receiving this email because you subscribed to this discussion on
CodePlex. You can unsubscribe on CodePlex.com.


Please note: Images and attachments will be removed from emails. Any posts
to this discussion will also be available online at CodePlex.com
Coordinator
Jun 18, 2012 at 8:43 PM

You need to modify the Sandcastle XSL transformations, not the SHFB ones.  You'll find the Sandcastle XSL transformations for the VS2005 style in C:\Program Files (x86)\Sandcastle\Presentation\VS2005.

Eric

 

Jun 19, 2012 at 1:26 PM

Thank you for the hint - it works perfectly.

A question of pure curiosity: If only the Sandcastle transformations are used - what are the SHFB transformations used for?

Regards, Verner

Coordinator
Jun 19, 2012 at 7:31 PM

The SHFB templates are for supporting XSL transformations on ".topic" files to get them to look like the API topics.  It's a deprecated feature that's only supported for backward compatibility and was replaced by support for MAML long ago.  The presentation style transformations are always found in the Sandcastle folder.

Eric