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.
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)
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 'Ö'. 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 & < > ").
Place .HHC and .HHK exclusions in the [HTMLHELP] section. Place .HxT and HxK exclusions in the [MSHELP2] section.
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.
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.
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=
; save FAR data to the 'Data' folder beneath the folder containing FAR.exe
; save FAR data to the '\Data\Settings' folder in the root of the drive containing FAR.exe
; save to the FAR.exe folder
; save to the folder above FAR.exe folder
While DataDir= is set the "Preferences > Settings" page settings will be disabled.
The "Preferences > Settings" page displays the expanded path specified by DataDir=.
To re-enable FAR settings simple set DataDir= back to an empty string.
See the file "Settings(default).ini" more info.