View webhelp locally without Chrome's security warning

<oXygen/> general issues.
tomjohnson1492
Posts: 132
Joined: Thu Apr 17, 2014 1:55 am

View webhelp locally without Chrome's security warning

Post by tomjohnson1492 » Fri Jun 27, 2014 2:08 am

Is there any way to view the DITA OT webhelp loaded from local files (rather than from a webserver) through the Chrome browser without prompting the browser security warnings that Chrome shows? I think Chrome shows the security warning because of the Javascript in the webhelp files. Is there any JS perhaps to disable in the output that would get around the security errors?

One alternative is to create a .chm output instead, but I haven't been able to try this because I'm on a Mac, and Oxygen requires HTML Help Workshop to compile the .chm. Any way to run HTML Help Workshop on a Mac apart from a VM?

sorin_ristache
Posts: 4144
Joined: Fri Mar 28, 2003 2:12 pm

Re: View webhelp locally without Chrome's security warning

Post by sorin_ristache » Fri Jun 27, 2014 11:58 am

Hello,

Oxygen's DITA WebHelp transformation creates two WebHelp main pages that enclose the same actual WebHelp content: index.html which uses XHTML internal frames (idiv elements) and index_frames.html which uses XHTML framesets. The JavaScript warning is displayed in Chrome only for the index.html version, which is the default one opened automatically in the browser at the end of the Oxygen DITA WebHelp transformation. I recommend using the index_frames.html version in Chrome with local files (loaded in browser as file:///...) instead of the index.html one because the index_version.html does not have the JavaScript limitation for local XHTML files in Chrome.

Sorry, there is no JavaScript to disable in the index.html version that preserves the WebHelp behavior related to page navigation (the Previous and Next links, etc) and the left-side Table of Contents tree behavior (expand and collapse tree nodes, automatically select the title in the tree when navigation through a link takes the user to a different page, etc).

The .chm format is specific for Windows and I don't know other tool for creating the final .chm output file apart from the HTML Help Workshop tool from Microsoft. That means you need a kind of Windows app emulator running on Mac machines but with one additional difficulty: applying the HTML Help Workshop tool separately (after the DITA HTML Help transformation is finished in Oxygen) to the HTML Help project files created by Oxygen's DITA HTML Help transformation. You are better off on a Mac machine with Oxygen running in a Windows guest virtual machine running on a host Mac machine, for example in VMware Fusion.


Regards,
Sorin

tomjohnson1492
Posts: 132
Joined: Thu Apr 17, 2014 1:55 am

Re: View webhelp locally without Chrome's security warning

Post by tomjohnson1492 » Fri Jun 27, 2014 10:52 pm

Perfect! I didn't realize the index_frames.html file was there. That provides exactly the solution I needed. Thanks for the reply.

Post Reply