Settings.INI

Settings.INI is found in the same folder as FAR.EXE and contains several obscure FAR options. This file is loaded once at FAR start-up. So if you edit Settings.INI you will need to restart FAR to see your changes. These settings are often the result of special requests from users. The file is self documenting and can be safely deleted.

The current FAR Installer will not overwrite an existing settings file. Because of this we ship a copy of the latest settings.ini file as Settings(default).ini  so you can view the latest settings. Settings(default).ini has no other purpose.

Feel free to Contact us if you feel you need a custom setting placed into Settings.ini.

Help 2.x Viewer

You can change how words are spoken by the text-to-speech reader. To do this edit the Settings.INI file and add the following text.

; eg. C# is normally spoken by the reader as "C Hash"
; By adding "C#=C
-Sharp" (with or without hyphen) we get the correct text-to-speech
; Note 1: Text is case sensitive
; Note
2: Text will match whole words only
; Note
3: Shift-Click the Read button (or Shift+F9) to reload this file (normally read once at startup)
[READER]
C#=C
-
Sharp
.NET=Dot Net

 

TOC & Index Editor

If a special character is found in a TOC editor tree control label, it is normally encoded when stored to file - Example Ö is stored as '&Ouml;'. You can stop FAR from encoding certain characters by adding them to Settings.INI. Alternatively you can uncheck the TOC Editor menu item "TOC > Special > Encode All Special Chars" to disable encoding completely (although note that special HTML chars & < > " chars are always encoded as &amp; &lt; &gt; &quot;).

Place .HHC and .HHK exclusions in the [HTMLHELP] section. Place .HxT and HxK exclusions in the [MSHELP2] section.

[HTMLHelp]
TOCEscapeExcludeList="§©"

[MSHelp2]
TOCEscapeExcludeList="§©"

Other Settings

[MAIN]

FindReplaceAutoComplete = 1
FindReplaceAutoDropDown = 0

These control the AutoComplete, AutoDrop properties of the 2 Find and Replace
dropdown fields on the main form form (1=ON, 0=Off)

HtmlHelpFileTypes = .htm|.html|.asp|.hta|.mht

FAR recognizes .HTM, .HTML, .ASP, .HTA, .MHT file types by default as valid HTML Help files when auto generating a TOC and listing TOC/HTML compatible files. 
Special Note: The MS HH Compiler only includes files of type *.h* when building a .CHM Full-Text Search list. ie. Out of FAR's control
If you find your new file extension is not appearing when you generate Help then don't forget to also add the file extension to the "Global Search Filter" to allow the file to be compiled into the .CHM file.
  See "Options > Preferences > HTML Help [Global Search Filter]"
Note: If you add a file ext like .XML FAR will not be able to add a valid TOC item title since XML normally has no <title> tag. FAR does however allows you to add a .Meta file to supply the Title.
eg. test.xml - Add a file test.xml.meta and add to that the text "<title>Some Title</title>"

DecompileMSBins = Y

By default the Authoring command "Batch Decompile" extracts everything from a help file including the special MS Binary files created by the MS Help compiler. These special files usually have file names starting with "#" or "$".
Set DecompileMSBins = N to stop the "Batch Decompile" from extracting the MS binary files.

SetRealVidPath=N

The Command menu item  "Set Real Video Path" has been depecated and is no longer visible in the menu system. However, if you still need the command set SetRealVidPath=Y and the command item will become visible again.

DataDir=

You can copy the FAR runtime files (eg. FAR.exe) and folders to a USB drive so that FAR can be run on any computer you plug the USB drive into. However the data location setting (see the "Preferences > Settings" page) will need to be setup for all computers.  To get around this problem you can set the directory to save FAR settings to using the DataDir=

Examples:
   ; save FAR data to the 'Data' folder beneath the folder containing FAR.exe
   DataDir=Data
  
   ; save FAR data to the '\Data\Settings' folder in the root of the drive containing FAR.exe
   DataDir=\Data\Settings

   ; save to the FAR.exe folder
   DataDir=.

   ; save to the folder above FAR.exe folder
   DataDir=..

Note:

See the file "Settings(default).ini" more info.


http://www.HelpwareGroup.com/