Automatic Verse Recognition


theWord supports automatic verse recognition to facilitate hyper linking while editing a book module.  If, while you are typing, you wish to type a Bible verse reference, simply type the reference, even in an abbreviated form, press enter or space and the reference will be automatically hyperlinked to display the text of the verse upon mouse-over.  By default, theWord leaves the Bible module undefined in these links.  This means:

1.The default Bible module will display the verse, OR
2.If ctrl is pressed, the active Bible module will display the verse.

The color of the text will change (depending on the Link colors options in the Hyperlink Dialog) to show it has been hyperlinked.  If theWord recognizes a text that is not a reference, but parses it as one, you can remove the hyperlink quickly by pressing ctrl+z.

Although the automatic recognition of typed verses tries to guess the actual verse, it is useful if you use some standard notation to enter verse references:

1.Use the : (colon) to separate chapter from verses (e.g. Gen 1:2)
2.Use the , (comma) to separate multiple verses (e.g. Gen 1:2, 3)
3.Use the - (hyphen) to define a verse range (e.g. Gen 1:2-3)
4.Use the ; (semi-colon) to separate multiple ranges (e.g. Gen 1:2; 6:2)

Even if you don't use the exact notation above, theWord will try to parse and understand the verse reference you are typing. For example, typing Gen 1,2 (German notation) will correctly identify it as Genesis 1:2.

If you right-click on a verse link that has been parsed/detected automatically by theWord, you can select the Undo automatic verse recognition from the menu to undo the operation. You may also do this if you save the topic and come back to it later.

Detecting All Verse References in an Existing Topic

To detect all verse references in an existing topic, right-click in the viewer area and select Detect all verse references... (or ctrl+d)

TIP When you paste content in a topic in a user module, you can hold down the CTRL key to make the program detect the verse references that may exist in the pasted fragment.

Detecting All Verse References in a module (all topics)

From the Module Properties Dialog, Settings/Actions tab, Actions section at the bottom.  Select Detect all verse references...

Advanced mode for commentaries

Normally, theWord will detect only verse references that have a proper book name (e.g. John 3:16). Unfortunately this excludes the cases where a verse is referred in a text with regards to the current context using words such as "verse 3, vv 3-4, vs. 5", etc. You can enable an enhanced mode for detecting these by holding down the CTRL+SHIFT buttons while doing verse detection in a whole topic or module. This advanced mode is activated in the following cases:

1.When right-clicking on the Book view reader and selecting Detect verse references in selection... or Detect all verse references in Viewer...
2.From within the Module properties dialog, when executing the Action Detect all verse references...

Notice that this is still an experimental mode and only works with English abbreviations.

TIP: Normally, theWord will not try to detect verse references in links, except if the link is a verse reference link that was detected automatically by theWord in a previous action/iteration.

To alter this behavior and enable the detection of verse references even within links, hold down the ALT key while the detection occurs. Notice that unlike the CTRL+SHIFT advanced mode above where you only need to hold these two keys at the beginning of the detection process, in that case you need to hold down the ALT key for as long as the whole detection process takes place!

Language used for detecting verse references

By default, theWord will detect verse references in English and in the current interface language (which you can change from File->Languages). It is not possible to detect verse references for an unsupported language since there is no way to know the book names of the Bibles in that language. You can also change this behavior by directly editing the config.ini file and setting there the language(s) you want to use.


  ©2003-2012 Costas Stergiou
manual version: 4.0.1327