Here are typical problems WebHelp authors may run into.
⚛ We deploy our WebHelp on the local PC. It won't work in Microsoft IE10/11/Edge browser (but works on the web).
Try using the Mark of the Web (MOTW) in all html files installed locally.
Before <!-- saved from url=(0014)about:internet -->
After <!-- saved from url=(0016)http://localhost -->
Also please try the latest version of FAR HTML 5.
⚛ "sync toc" link displays a popup "Operation Failed! Cross frame communication is blocked..."
Thus when "sync toc" is clicked the TOC frame can't get the URL of the right frame.This typically happens running Google Chrome on the local PC or USB drive.To get around this situation each topic file can include our NavScript.js file (available with FAR 5.7 later).
⚛ Foreign Language text does not display correctly in the Navigation files
Nav files (hh_toc.htm, hh_index.htm, hh_search.htm and hh_start.htm) require a header statement same as your HTML topic files to display foreign language correctly on any language PC...
Add this to the header of UTF-8 Unicode files:
<meta http-equiv="content-type" content="text/html; charset=utf-8">
Add this to the header of Japanese ANSI files (or Unicode files that won't display):
<meta http-equiv="Content-Type" content="text/html; charset=shift_jis" >
Before adding check for any existing charset statements. Future FAR releases will add this to the Nav files for you.
⚛ I uploaded new nav files but can't see the changes
Either a local cache or server cache is hanging onto an old file image.
Hit F5 a few times to refresh. For most browsers Shift+F5 or Ctrl+F5 will refresh files skipping cached files.
Alternatively there are special header meta statements you can try adding to the nav files that tell the browser to bypass the cache.
Tell browser not to cache this file. Useful during development stage when files change a lot.
<meta http-equiv="cache-control" content="no-cache">
Tells search engines not to index this file but OK to follow links
<meta name="robots" content="noindex,follow">
⚛ Content won't display in the iFrames (blank pages)
For MS Internet Explorer (not Edge) there are Internet Settings that control both iFrames and Cross-Frame communications.
From Internet Explorer go to Tools > Internet Options
Click Security Tab > Internet Zone > Custom Level button.
Enable IFrames & Cross Domain operations.
Read more - Screen shots
FAR user Winfried P reports...
In IE11 iframes are not supported in the Internet zone by default.
I added the following to hh_start.htm to allow help to run
<meta http-equiv="X-UA-Compatible" content="IE=EmulateIE11"/>
Rob: Not sure why this worked for Winfried and others having problems with content not showing in IFrames.
It may have been an early version of IE11 browser causing the problem. At any rate it fix the problem.
The statement basically tells IE11 to run in IE11 mode. So why does it work?
In FAR 5.8 (813) and later the "Uncompressed help > Frame tab" allows you to tweak this header text
⚛ Changing the Web Page Icon
Add an icon to the frame host HTML page. The icon is often used in the browser tab and bookmark. See w3Schools for more info.
<link rel="icon" href="favicon.ico?v=2" type="image/x-icon" />
This extra header code is added by default when generating FAR uncompressed help.
In FAR 5.8 (813) and later the "Uncompressed help > Frame tab" allows you to tweak this header text.