Working directly with the config.ini file

Overview

The config.ini file is where all settings of theWord are stored. To locate the current config.ini being used do the following:

Go to the menu Help -> About. In the About dialog, click on the File locations tab. Locate the Personal files folder line and click on the ... button on the right: a windows shell dialog will open. Locate the config.ini file in that dialog: this is the one used by the program.

You can edit directly this file if you want to set some advanced options. Before trying to edit it make sure that theWord is not running or else your edits will be overwritten when you shut down theWord.

The file is divided in sections. Each sections starts with the name of the section enclosed in square brackets and extends until the beginning of the next section (or the end of the file). Most options that you can set manually usually should go to the [general] section. The [general] section is usually the first one in the config.ini file (although this is not necessary).

You can edit the config.ini file using any text editor like notepad that comes with Windows.

TIP: Editing directly the config.ini file is an advanced operation that requires some basic knowledge of files and usage of a text editor. It is suggested that you make a backup copy of the config.ini file before changing it manually.

What settings can be set there?

A partial list of available options is given below. Notice that this is not complete and it is only suggested for advanced users. You should probably check the forums for more information on these options. All entries listed here should go to the [general] section.

Entry

Used for

extra.paths=[list of paths separated by ;]

Add one or more extra paths in which theWord should look for modules. Example:
extra.paths=c:\my modules; h:\personal\files

vref.languages=[list of <language>, *, current]

This setting determines what language the verse detection algorithm uses for book names. By default it uses English and current language. You can use * for all languages installed, or a comma list with the ones you want (current stands for the current language). Examples:
vref.languages=*
vref.languages=english,current
vref.languages=spanish,german
vref.language=english

dbv.tlb.backcolor.luma

Default is 210. Luminosity of the color applied to the Bible tab bar

jump.to.verse.list.on.add

Default is 1 (true). Set to 0 if you don't want the Bible view to change to List when you add a verse to the current list (using CTRL+L, the menu, etc)

dbv.add.header.when.copying.single.verse

Default is 1 (true). Set to 0 if you don't want a header when copying single verses from the Bible view.

dbv.add.footer.when.copying.single.verse

Default is 0 (false). Set to 1 if you want a footer when copying single verses from the Bible view.

active.verse.highlight.light

Default is -35. How much the current verse gets lighter from the background (when using standard color) - applies for light background colors (negative means it gets darker).

active.verse.highlight.dark

Default is 40. How much the current verse gets lighter from the background (when using standard color) - applies for dark background colors.

booksearchview.showpopup.on.tree

Default is 1 (true). Whether to show the content of the topics in a popup when hovering over the book search results list. Use 0 to turn it off, 2 to show only when CTRL is pressed.

bkv.highlight.alpha.normal

Default is 140; alpha value (transparency level) of highlighting of matched book modules tabs in book view (for normal matching)

bkv.highlight.alpha.fuzzy

Default is 60; alpha value (transparency level) of highlighting of matched book modules tabs in book view (for fuzzy matching)

bkv.highlight.color.light.normal

Default is yellow. Color for highlighting the book tabs (for normal matching) - used for light colored themes (colors are in RGB decimal; e.g. 2686948 is dark yellow, 2552040 is clear yellow; to use a color in hex use windows calculator to convert to decimal, also reverse the order of hex digits)

bkv.highlight.color.light.fuzzy

Default is yellow. Color for highlighting the book tabs (for fuzzy matching) - used for light colored themes

bkv.highlight.color.dark.normal

Default is black. Color for highlighting the book tabs (for normal matching) - used for dark colored themes

bkv.highlight.color.dark.fuzzy

Default is dark gray. Color for highlighting the book tabs (for fuzzy matching) - used for dark colored themes

bookview.showpopup.on.links

Default is 1 (true). Whether to show popups for links in the Book view. Use 0 to turn it off, 2 to show only when CTRL is pressed

auto.bookmark.pattern

Default is bkm%d. Pattern for suggesting bookmarks in Book view. Be careful to properly use the number placeholder %d.

lang.hot.key

Default is 76 (L). Key for reloading the current language file (CTRL+SHIFT+L is the combination)

cm.paste.hot.key

Default is 86 (V). Key for pasting back to clipboard recognized verse from within the Clipboard monitor (CTRL+SHIFT+V is the combination)

bible.module.reload.hot.key

Default is 82 (R). Key for reloading current Bible module (CTRL+SHIFT+R is the combination)

restrict.popup.inapp

Default is 0 (false). Set to 1 (true) to restrict all popup windows (not tips) within the area of the main window.

bkv.center.link.target

Default is 0 (false). Set to 1 to force the display of a link with a specific bookmark to center the target topic in the reader (by default, when you click on a link for which a bookmark is defined, then the reader scrolls so that the bookmark appears at the top of the reader; this option will scroll the reader so the bookmark appears at the vertical middle of the reader).

clipboard.format.bible.unicode

clipboard.format.bible.rtf

clipboard.format.bible.text

These three options control in which formats text is copied to the clipboard. All three entries have a default value of 1 (true). Set to 0 to disallow the particular format to be copied to the clipboard. For example, if you want to not copy rtf formatted text to the clipboard, add to the config.ini the option clipboard.format.bible.rtf=0

clipboard.format.apply.to.reader

Default is 0 (false). By default, the above three config options do not apply for selected text that is copied from the Bible viewer. Set this to 1 to have these options apply for text copied directly from the Bible view reader with mouse selection.

strong.format

This option allows you to customize the look of embedded strong numbers in the Bible view text. Defatul value is "\super  %s" (without the quotes). The format is actually an rtf fragment. For example, the setting "{\fs16 <%s>}" will render the Strong numbers within the < and > symbols and with a font size of 8. The %s represents that actual text (e.g. G1, H123, etc).

Be very careful because incorrect rtf syntax may cause the whole rendering of the Bible text to get corrupted.

morph.format

Same as strong.format but allows you to customize the rendering of morphological codes.

suppress.search.results.highlight

Default is 0 (false). Set to 1 if you don't want the search results to be highlighted in yellow.

suppress.search.results.underline

Default is 0 (false). Set to 1 if you don't want the search results to have the curly red underline.

popup.strong

Default is 1 (true). Set to 0 if you don't want the Strong numbers to appear in popups, no matter if the current/active Bible view displays them.

popup.morph

Default is 1 (true). Set to 0 if you don't want the morphological codes numbers to appear in popups, no matter if the current/active Bible view displays them.

 
 
  theWord®
  ©2003-2012 Costas Stergiou
manual version: 4.0.1327