Make Uncompressed Help Dialog

Introduction | Browser Compatibility
Main Menu
Top Panel
Page - Navigation Pane
Page - Navigation Tabs
Page - Frame
Page - Toc & Index
Page - Search
Page - Generate
Trouble Shooting
Template Files

This window is available from the Authoring menu (main window).

FAR 5.7 Changes - 10/12/2015

Much has changed in the world of JavaScript & CSS since FAR was first release in 1995.
Starting with FAR 5.7:


With Uncompressed help (AKA Web-Help) we simply add Navigation files (Toc/Index/Search) to your existing web site.  Uncompressed means files are not compressed to a single .CHM or .HxS help file. The strength of uncompressed help is that it can be used anywhere HTML can be used -- a web server; USB thumb drive; CD or DVD; etc.

A page with IFrames is created. The left frame displays the TOC, Index or Search. The right frame displays your normal web content. And in FAR v5 we also allow a top banner frame for company log etc.

This dialog will add several files to the root of your local web. It will _not_ change your existing web files.

Copyright & Licensing

The Index JS code and Search JS code were written by the FAR team. We have not tried to hide or obfuscate the code in anyway. This means you can easily debug and modify it. Remember that the code is copyright and owned by us, so please respect it as you would any 3rd party executable (IE. you can't steal the code and build a similar product that competes with FAR).

You must own a copy of FAR HTML to publish a web containing FAR navigation code. If you have 2 teams publishing 2 different webs then both teams need to purchase a copy of FAR HTML. If a team member already owns a copy of FAR then you are covered. If a member of another team owns a copy of FAR you can use that, as long as that member stops using FAR (IE. transfers the license to you). No other cost or royalty is required.

Modifying Code

This dialog allows you to create web site navigation in several different styles and configurations. It is difficult to please everyone so we encourage you to get familiar with the HTML code generated and modify it as required. Otherwise contact us and we will try and add in your changes.


Our helpware site contains an example created using FAR Uncompressed Help:


Lets talk about browser compatibility.

JavaScript TOC/Index/Search

The JavaScript navigation produced by FAR is compatible with all modern Browsers. JavaScript is the in-built client side script language that comes standard with all major browsers. JS compatibility between different browsers has been poor in the past, but has improved much since the introduction of IE6, Firefox, Chrome, Safari and Opera browsers.

Browser we have tested under Windows:

IE 6/7/8 Excellent
Firefox 1/2/3 (Mozilla5/Gecko) Excellent
Google Chrome 2.0 Excellent
Opera 8/9 Excellent
Opera 7.54u2 Very Good. Some issues with layout if a small or large font chosen. No Toc Sync.
Safari 3.2 Excellent
Netscape 7.2/8 Excellent

Removed from FAR 5.7

Pure HTML TOC/Index

Recommended for very older browsers.

Not very stylish but old browsers should have no trouble with this HTML code. Search is up to you. If you are on the web use the Google free search engine.

HH JAVA TOC/Index Controls

Not Recommended.

Many years ago (1997) Microsoft released a JAVA version of the HH ActiveX control. At the time JAVA promised to be the future of web and cross-platform development. Unfortunately MS did not maintain this controls and it's no longer compatible with most browsers.

HH ActiveX TOC/Index Controls

Not Recommended.

Note: Dec 2004 MS Security update MS05-001 has now disabled hhctrl.ocx (HH ActiveX) controls from working on the web. Read more. Still ok for use on a local PC.

The MS HTML Help 1.x ActiveX controls will only work in Internet Explorer 4 or greater. Remember only IE supports ActiveX.

If you have users who don't mind being restricted to IE these are nice controls. Unlike the JS controls these controls can load .HHC and .HHK files natively. And the TOC can display all those pretty HH 1.x TOC icons.

Microsoft do not produce a portable Search engine so for search you must use FAR JS search, Google (if web based) or whatever.

Browser Stats

Browser usage figures can be found on the web. At this stage FAR JS Navigation works with all the popular browsers.


Main Menu

File > Open Base Folder

Select the base folder of the local web you want to work with.
EG. If the folder "c:\projects\MyProject1\" contains all your project help files and folders, then select that folder. All files - .HHK, .HHC, frame files etc. are added to this directory. None of your existing Web files are modified.

Dialog settings are saved and loaded from a file called "farinfo.ini" (also in the base folder). See File > Save.

File > Save

Stores the dialog settings to a section in the INI file "farinfo.ini" in the current base folder. You can safely delete this file at anytime (but you will return to the default settings). The section used to save settings under is specified in the Top Panel.

File > Load Defaults

Set all fields to their original default values. This reset affects only the current INI section, other sections containing data will remain the same. Note that some image settings will remain unchanged.

File > Windows Explorer

Open a Windows File Explorer window at the current base folder.

File > Exit

Close this window. Prompts you to save if there are unsaved changes.


Displays this on-line help.


Top Panel

The top panel is below the main menu and above the page tabs.

Base Folder:

Click this hyper-link to select a new Base Folder. This is simply a convenient repeat of the "File > Open Base Folder" command. The edit field displays the name of the current Base Folder.

Save in Section:

Click this hyper-link to Save all dialog data to disk. This is simply a convenient repeat of the "File > Save"  command.

All data is saved to/loaded from the specified section in farinfo.ini which lives in the current Base Folder. Use the Add & Remove buttons to add/remove sections to/from the Section Name dropdown list. Note that the "Default" Section Name cannot be removed.

Saving various dialog configurations into different sections means you can recall different configuration later. This is done by simply selecting a section name from the dropdown lost. You will be prompted to save before moving from one section to another (but only if there is unsaved data).

Test Browser

Select the type of browser you want to test the output HTML in.
FAR lists the following browsers if found: IE/FireFox/Google Chrome/Opera/Safari/Netscape.

Create navigation files

Click this hyperlink to generate your final output. This is simply a convenient repetition of the command on the "Generate page".

Test in browser

Click this hyperlink to open the generated help system in the selected test browser (see Test Browser above).


Navigation Panes Page

Like MS Help FAR can provides the 3 standard navigation panes: Contents, Index & Search.

Pane: [X] Contents, [X] Index, [X] Search

Select which of the 3 panes you want to generate using FAR.

Note that if you are using Gif Tabs the Contents pane should be included (checked). This is simply because when this feature was originally written we created Gif images that always used a TOC. In FAR Version 4 we have removed the limitation that forced you to include a Contents tab.

If you are artistic you could create your own set of Gif navigation tabs, or translate the existing GIF images.

Background: Contents, Index, Search Dropdowns

Select the background color or image for each pane you have checked.
At the top of the dropdown list are some special items:

Custom... Select this item to select a color from a color select dialog.
Use BG Image 1,
Use BG Image 2,
Use BG Image 3
Select either image 1, 2 or 3. These three images can be defined in the Background Image section.
No Color Select this item to use no color code.
_LightGray Simply the color #f1f1f1. Something we frequently use here in-house.
_buttonface (Removed from FAR v5.7) Also defined further down the list but redefined here at the top of the list for convenience. Don't use buttonface if your non-IE browser is being used.

Note (Removed from FAR v5.7): Although you specify a color by name (such as "Button Face") some color names only work in the MS Internet Explorer browser. These are typically the programming type names such as "Buttonface", "WindowText" etc. Best to avoid these names and use "Custom" or a standard colors.

Gradient Color

These fields are available when a Background color is specified (field above). To disable Gradient colors set the selected value to "*No Color".

This setting when enabled creates a gradient between two colors. Color#1 is the Background color. Color#2 is the Gradient color. Check the Vertical gradient checkbox to create a vertical gradient, uncheck for a horizontal gradient.

Since not all browsers support color gradients FAR actually creates a gradient image file (called hh_Gradient1.jpg, hh_Gradient2.jpg and hh_Gradient3.jpg) when the Generate button is clicked.

Background Image

Select up to 3 background image files (GIF or JPG). Once images have been selected, use the Background dropdown controls (above) to set a background image for a pane.

Click this button to select a GIF or JPG Image file from any location.
Click this button to clear the image selection.

Each time an image is selected, FAR copies the image as hh_bgImage1.jpg, hh_bgImage2.jpg, hh_bgImage3.jpg (or .GIF if a GIF was selected) into the base folder.

JavaScript TOC

Setup the TOC colors and icons.

Background: Choose the background color of the TOC panel. Only this dropdown contains the "transparent" option. Transparency allows you to have TOC items over an image or gradient background.

Node Select: Selection the background color of the selected item.

Node Rollover: Selection the background color of the mouse over item.

Node Border: Color of the selected and rollover border surrounds.

Text Color: General text color.

Selected Text: Selected text color.

Rollover Text: Mouse over text color.

Icon Set: FAR v5 allows you to choose a TOC icon set. Each set can have 3 icons (page, folder-closed, folder-opened). The default icons are stored in <FAR.EXE-dir>\extra\ and are copied to your web's root folder whenever you generate new navigation files. These default files are named treenodedot.gif, treenodeplus.gif, treenodeminus.gif. These is also the names used when they are copied to your web folder.

Additional icon sets are stored in <FAR.EXE-dir>\images\tocIcons\.
To add your own TOC icons, place 3 images (.GIF or .JPG with same dimensions) into the above folder. File name must be - treenodedot(myName).gif, treenodeplus(myName).gif and treenodeminus(myName).gif. The myName text will be displayed in the Icon Set dropdown.


Navigation Tabs Page

[X] Include Close Button

Check this box if you also want to add a Close button to each navigation pane.

Use Form Buttons

If you select this page tab then HTML <Form> Buttons will be used to move between navigation panes.

Button Text: Specify the text for each navigation pane button (and the close button if enabled).

Button Color: Check the box to specify the foreground and background color of the buttons.

Active Button Color: Check the box to specify the foreground and background color of the active button
EG. If Contents pane is selected at runtime then Contents button is the Active button.

Active Button Disabled: Check the box to always disabled the active button.
EG. See image below - When the Contents page is selected then the Contents button is disabled.

Clicking the Contents button while on the Contents page does nothing except reload the same navigation page. Thus we can safely disable it.

Notice that under Windows XP & Windows 2003 buttons are Themed buttons (as pictured above). If you check the "Button Color" checkbox you will lose the beautiful XP themed look.

Use GIF Tabs

Select this page tab and .GIF Images files will be used to select navigation panes.

Select to choose a set of tab images to use. Select any file in the set and FAR will copy the complete set of tab images into the base folder as hh_navtab11.gif, hh_navtab12.gif etc. The images are displayed as reference in this page. Hold the mouse pointer over each image to check its filename. Notice as you uncheck Index or search pane checkboxes (above) the images are hidden.

Note: All image sets assume you are using a contents navigation pane.

FAR provides some basic tabs sets to choose from. Note: Because of overlap, the Contents/Index/Search/Close tab sets may not function well when Index or search is unchecked. To fix this we sometimes provided modified tab sets EG. Std_Toc_Search_??.gif can be selected if you uncheck the Index pane. Create your own tabs sets if you don't find what you want.

xxx_11.gif, xxx_12.gif, xxx_13.gif Contents page tabs TOC/Idx/Search
xxx_21.gif, xxx_22.gif, xxx_23.gif Index page tabs TOC/Idx/Search
xxx_31.gif, xxx_32.gif, xxx_33.gif Search page tabs TOC/Idx/Search
xxx_00.gif Image used after each of the above.
Include Close Button = Unchecked.
xxx_0x.gif Image used after each of the above.
Include Close Button = Checked.

Tip: If your tab images are not displaying correctly, reselect the tab set. This forces the tab set GIF files to be copied to the base folder.


Frame Page

Frame Title

This is the text displayed in the title bar of your browser. It's the <title>text</title> for the frame file.

Top Frame

Check this if you want a title frame along the top of the browser window. Typically you would add to this topic showing off your product name & company branding.

Frame Topic: The HTML topic to display in this top non-scrolling frame.
Frame Height: Literally the height of the top frame.
Frame Divider Height: The thickness of the divider separating top and bottom framesets.
Frame Divider Color: Color of the divider.

Removed from FAR 5.7
Frame Border: Hide/shows the horizontal divider. Does not effect some browsers (EG. Google Chrome shows no effect).
Top Frame 3D Border: On most browsers this creates a 3D sunken border around the top frame.

Bottom Frames

Settings for the bottom left and right frames. Navigation goes in the left frame while your HTML content goes in the right.

Default Topic: Select the HTML file to be displayed in the right hand frame.
Left Frame Width: Specify the width of the left frame.
Frame Divider Width: The thickness of the divider separating left and right frames.
Frame Divider Color: Color of the divider.

Removed from FAR 5.7
Frame Border: Hide/shows the vertical divider. Does not effect some browsers (EG. Google Chrome shows no effect).
Left Frame 3D Border: On most browsers this creates a 3D sunken border around the left frame.
Right Frame 3D Border: On most browsers this creates a 3D sunken border around the right frame.

Topic Options

Click the button to select an HTML file.
EditToc.gif (185 bytes) Click this button to edit the TOC or Index file in the preferred text editor (see main window Options > Preferences).
IEbtn.gif (966 bytes) Click this button to open the file in the test browser.

Redirect to Frame if opening single TOC, Index or Search file

If you check this option then some extra code is placed inside TOC, Index and Search HTML files. If the user tries to open say the TOC file by itself (typically hh_toc.htm) then the TOC file immediately opens itself in its usual position in a Framed window.

Left Frame Footer

Check this box to display a custom HTML message at the bottom of each navigation pane.

Extra Header Code

New for FAR 5.8 (813)
Check this box to insert these HTML code lines into the <head> section of the main host html file (recommended) when generating help.
The default code includes the following 2 lines. For more info see FAR Help Wiki.

<link rel="icon" href="favicon.ico?v=2" type="image/x-icon" />
<meta http-equiv="X-UA-Compatible" content="IE=EmulateIE11"/>


More about FAR Uncompressed Help and Frames

Normally a FrameSet file opens in a fixed configuration. ie. TOC on left side and home page on the right. How could you open the Index on left and some other page on right?

In FAR you can pass the left and right file names as a bookmark (anchor). This works with either the FAR hh_goto.htm, redirect.htm or hh_start.htm files. Here are some examples:

The basics:

Open the default FrameSet file

Now we add some parameters:

Use a single bookmark to override the right frame.
Redirection file again. Redirection params are simply passed onto the redirect file (in this case hh_start.htm above).
Use two parameters to set both frames. The bookmark contains 2 parameters separated by a + char.
The first param sets the right pane. The second param sets the left pane.
In this case we override the left frame only.
The first param is empty so the right frame gets the default file name.

Tip: If a file does not seem to change try pressing F5 to refresh the page.

30-Nov-2006 - hh_goto.htm

We found that a single IE browser session wont update if you are serving up the same HTML page (hh_start.htm), even though you are changing the bookmark.

Example: Click these 2 links. The second link wont work since hh_start.htm is already loaded. The browser ignores the change in bookmark.

One way to overcome this problem is to use hh_goto.htm (created at the same time and in the same folder as hh_start.htm). It simply redirects you to hh_start.htm, passing on any parameters. So parameters for hh_start.htm are the same for hh_goto.htm.

If you are setting up contextual help then try using hh_goto.htm instead of hh_start.htm

Example: These links both work


TOC & Index Page

This page is only available if you have checked either the Content or Index pane checkbox on the first page.

Specify either a MS HTML Help (.hhc/.hhk) or MS Help 2.x (.hxt/.hxk) TOC and Index files.

If you are generating pure HTML or JavaScript output these files wont need to be shipped. They are simply required at generation time.

>> These options removed from FAR 5.7 -- FAR uncompressed help is now JavaScript by default.

Specify TOC & Index control type

Since MS disabled the HTML Help ActiveX control from working on internet and intranets (see web for details), JavaScript is now the preferred way to add navigation to a remote web side using client side code.

The TOC and Index generated are purely DHTML and Script. No ActiveX or Java is used. Your HHC and HHK files are used to generate the HTML code but are not required to be shipped.

The DHTM TOC is the same used by NDOC 3.x. The TOC tree.JS code file itself was originally written by Jean-Claude Manoli and as requested we have left the copyright notice in the header of the tree.js file. Please do the same. The code is used with permission. We have added several improvements and fixes to the code.

The JavaScript Index is our own creation and works like a basic MS Index navigation pane, except you don't get popup lists and shortcuts to other index items. Something that we may add in the future if we get requests.

See also Browser Compatibility
No script. No DHTML. This navigation is very plain but should work with even the oldest browser.
Use a redirection file to load pure HTML navigation if JS or IE4 support is not found. See Generate page.
HH ActiveX Controls
The MS HTML Help ActiveX visual controls are used to display the HHC and HHK files.  As stated above MS have blocked the HH ActiveX (hhctrl.ocx) from working on the web [web ref]. So only use this type of navigation if you are running on the local PC. These controls require IE4 or greater. Most other browsers do not support ActiveX.
HH Java Controls
The MS HTML Help Java Applet is used to display the HHC and HHK files. We advise you not to use this setting since the applet was never maintained by Microsoft and is quite out dated.


Common buttons

Click the button to select a TOC or Index file from the base folder.
EditToc.gif (185 bytes) Click this button to edit the TOC or Index file in the preferred text editor (see main window Options > Preferences).

Specify a table of contents file

Enter the name of a TOC file to use. HTML Help TOC files (.hhc) are ANSI only. While MS Help 2.x TOC files (.hxt) can be Unicode. Use the FAR TOC & Index editor to convert between file types using the Save As dialog.

The file should live in the base folder. Enter the filename with no directory part. If the folder does not have a TOC file then click the "Create TOC" button. FAR will then search for HTML files and create a .HHC file for you. If you already have a .HHC file then click the "Edit TOC" button to open it in the FAR TOC & Index Editor.

Normally you would create a TOC file once, then maintain it using FAR TOC & Index Editor.

Specify an Index file

Enter the name of an Index file to use. HTML Help Index files (.hhk) are ANSI only. While MS Help 2.x Index files (.hxt) can be Unicode. Use the FAR TOC & Index editor to convert between file types using the Save As dialog.

Same comments for the Table of Contents above apply here.

If these settings are disabled its because you uncheck the Index pane checkbox on the first page.


Search Page

Show TOC Filter

[FAR 5.8+] Check this box to display a filter edit box above the TOC ('Contents' must be checked on the first page). As you type into the filter box TOC labels are highlighted that contain the text entered.

Allow JavaScript Search from TOC Page

[FAR 5.7+] When checked a dropdown button shows next to the TOC Filter edit box. 'Show TOC Filter' (above) must be is checked. The dropdown button displays search options and a search button.

FAR provides two full-text search options:

Custom Search Code

Here you simply enter the code for the search navigation pane to use.

If you own your own domain name and want search to cover the entire domain then we recommend you use Google. There is no beating Google for speed and quality. Google provides free code that allows you to search only your domain.

Click the Setup Google Code with my domain link to generate Google code. When prompted enter your domain name. EG. Note that if you use non-Western coding or UTF then you need to also edit the two items coded as "iso-8859-1". See for more info.

FAR JavaScript Search

This is a very powerful feature of FAR. FAR can create a simple Search Engine using nothing but pure JavaScript. No ActiveX is used. No server side Indexing is required. No Java is required. The search code is very portable. It will work anywhere (web, intranet, CD, DVD etc) as long as you have a JavaScript enabled browser. See Browser Compatibility.

Before your navigation UI search code will work you must generate the search database file searchdata.js. To do this go back to the FAR main window and...

  1. Set the FAR drop filter to HTML files only.
  2. Drop the Root folder of the local web onto FAR.
  3. Remove any HTML files from the FAR list not wanted in the search data.
  4. Select Authoring > Build JavaScript Search (main menu) and build the searchdata.js file.

Select a Search Page Layout

Select one of the available search page layouts from the dropdown and generate the navigation code (Generate page).

There is not much more to say here except try each layout and see which you prefer. If you don't like the search text or layout then edit the final Search HTML. Note that half the layouts use offer "Partial word matching" and half offer "Match whole words only" -- These are simply opposites of each other. If you compare the code you will see that the Full Match checkbox has a NOT operator in the code.

For more reading on FAR JS Search code see Build JavaScript Search dialog help.


Generate Page

Common buttons

EditToc.gif (185 bytes) Click to edit the file in the text editor.
IEbtn.gif (966 bytes) Click to test the file in select web browser. The icon will change depending on what test browser is selected.

Create Navigation Files

Create Navigation Files button

This is the final step. This creates the required navigation files in the base folder, and copies all required auxiliary files (such as tree.css, tree.js, search.js etc) from the FAR \extra\ folder into the base folder.

As soon as the Frame/TOC/Index/Search files are created, the Frame is loaded into your test browser.

Create Nav Options

When you click the Create button, an Options dialog displays which files are allowed to be overwritten. Deselect any files you don't want overwritten.  Why would you you this?  You may have a file that you have customized and do not want FAR to change.

You can also set these options without performing a build by clicking the "Create Nav Options" link.

The Options are saved with all other control settings. So every project section has its own set of options.

Note that the Options dialog wont show if you Create using batch mode.

Shipping button

Click this button to view a list of files used or created by FAR that should be shipped with your web site.

File names

If you don't like our choice of HTML output file names you can enter your own names.

Create Redirection File

Redirection file was useful when browser compatibility was poor but now is not so important.
Since FAR 5.7 you can now ignore this section. The old help on redirection continues below...

Create Redirection File button

Creates a redirection file and opens it immediately in the test browser. The redirection file simply tests whether the current browsers is JavaScript enabled (or the browser is IE4 and greater).  The choice of test is controlled by the two radio buttons.

EG. Check the "JavaScript support" radio button to create a redirection file that tests if the browser is JavaScript enabled. If the test passes (a JavaScript enabled browser) then the redirection file opens the frameset "hh_start.htm". If test fails (not a JavaScript enabled browser) then the redirection file opens the frameset file "ht_start.htm".

Procedure: Creating a JavaScript Redirection

  1. In the "Create Navigation Files" group above set all file prefixes to "hh_".
    Select for JavaScript output and Generate the navigation files.
  2. Now set the file prefix to say "ht_".
    Select for pure HTML TOC and Index (and something safe for search)
    and again Generate the navigation files.
  3. In the redirection groupbox select the "JavaScript support" radio button
    then click Create Redirection File.

Now when you open redirect.htm you should see navigation that will work no matter what browser is used.


Trouble Shooting
1. After navigating to a HTML page in another domain the .HHC TOC and .HHK Index items don't fire anymore.

This problem has been observed in IE6 while testing on a local drive. Once the files are copied to the web there is no problem. Recommend you use JavaScript instead of ActiveX.

2. Browser Security Blocks

If the right pane is from a different domain there will be security restrictions and the JS TOC sync code will kick up an error (we call this on page load and when the Sync link is clicked). You can simply ignore this or you could edit the code and disable the call to TocSync on page OnLoad (and also the call at end of page).

3. Clicking links in Toc and Index opens documents in the wrong window pane.

Take a Look at the frame source. Notice that the 2 frames have been given names called "left" and "right".

<FRAMESET COLS="265,100%" framespacing=3 frameborder=1>
   <FRAME SRC="hh_toc.htm" name="left" scrolling="no">
   <FRAME SRC="index.htm" name="right" scrolling="auto">

Edit your TOC and Index files. On the Properties page of the FAR TOC/Index Editor is a field called Frame. Make sure this is set to right. So now all pages are opened in the correct Target called right.

For the search or footer HTML make sure that any anchor or form tags contain Target="right" to direct content to the right frame
Example: <a href="somefile.htm" target="right">Click me</a>

FAR 5.7 - Similar except we now use IFrame instead of Frameset <iframe src="hh_toc,htm" hight="100%" name="left" scrolling="no" ..>

4. The Index works great but I want a Double-Click to open a file, like in CHM help.

We changed from double-click to single click in FAR build 691.
To enabled the old double-click method edit the Settings.ini file (in the FAR.EXE folder) and at the bottom of the file ([MAIN] section) add the following text:


5. How do I open the navigation pane from a HTML page (ie. Nav pane is closed).

Please read notes on WebHelp and using NavScript.js here

By including the file NavScript.js (included with FAR 5.7 extras install folder) a link is displayed to reopen the navigation pane when the nav pane is closed.

Go to this page now and try clicking the link (top of page) to open the navigation frame:

You are welcome to use the code. Here's what you need to do:

1. Add the file NavScript.js to the root folder where "hh_goto.htm" lives.
    (hh_goto.htm is a file generated by FAR 4.3/5 Uncompressed Help)
    You can get NavScript.JS file from the FAR 5.7 \Extras\ install folder

2. Add the following script immediately after your <body> tag.

<script src="NavScript.js" language="JavaScript1.2" type="text/javascript"></script> <script language="JavaScript1.2" type="text/javascript">WriteNavLink(0);</script>

 Files one level down from the root folder would look like this...

<script src="../NavScript.js" language="JavaScript1.2" type="text/javascript"></script> <script language="JavaScript1.2" type="text/javascript">WriteNavLink(1);</script>

 Files two levels down from the root folder would look like this...

<script src="../../NavScript.js" language="JavaScript1.2" type="text/javascript"></script> <script language="JavaScript1.2" type="text/javascript">WriteNavLink(2);</script>

  ... and so on.

3. Tweak the script to suite your own situation.

Again please read the latest WebHelp KB notes here which describes using NavScript.js in detail.

2008-7-11: The script now detects if the page is inside a CHM. If it is then it doesn't display the Open Navigation link (since a CHM help file has its own navigation).

29/9/2008: Added a new command to the FAR 5 Find and Replace dialog to insert the above script in a single pass.

Open the Adv Find and Replace dialog and click the [v] insert menu button. Select "$R$[..] -- Insert NavScript.js web help script".

10-12-2015:  An updated NavScript.js now ships with FAR 5.7 and is compatible with FAR 5.7 web help output. It allows toc sync to work even when browser security is an obstical.


Template Files

A common question is how do I modify stuff beyond the basic settings in the FAR Uncompressed Help dialog. You will find all the CSS, JavaScript and HTML template files used by FAR in the following folder:


But if you modify these base templates it affects all projects created by FAR so we first check for files in this folder:

<My Project BaseDir>\extra\

When a file is found in this folder it is used in preference to <far.exe>\extra\ . A full list of templates and files used by Uncompressed help can be found in <far.exe>\extra\_readme.txt