View synchronization

Overview

View synchronization is a feature that attempts to bring you related material as you study the Bible or read a book. The main idea behind it is to use the current Bible view as a starting point and try to update all available Book views to display topics that are related to the current verse and word you are reading (Type 1). A secondary function is to update the current Book view tabs with indicators (colored dots) that show you whether other modules on the same view have relevant information (Type 2).

TIP: Do not be confused with the 2 different types of synchronization:

Type 1 synchronization occurs when you work on the Bible view and affects all Book views, depending on options (see below)
Type 2 synchronization occurs when you work in a single Book view and only affects the module tabs of this same view: it only occurs whenever you change the current topic on your Book view.

Whenever the Type 1 synchronization occurs, the Type 2 occurs also, but not the other way round.

TIP: The information in this topic also explains how theWord reacts when you click on a link (e.g. a Strong number, a link to a topic in a dictionary, etc). A link is like a special type of synchronization: a view needs to react to display the topic you clicked on.

TIP: All the Lookup... menus (they can be found when right-clicking on a word in a Book view, in a Bible view or in a topic in the Topic List of a Book view), work with this same logic. Please, read the How word lookups are performed for more information.

Remember that these menus are treated like links, e.g. theWord tries to find a book view to display the content.

Type 1 synchronization

There are two pieces of data that are used to provide relevant information as you read through your Bible:

1.The current verse you are reading (the current verse has a gray shadow by default; you change the current verse by clicking on another verse, or scrolling your mouse wheel depending on relevant options).
2.A word you click on in the Bible view (called from now on current word) - notice that in that case a click on a single word may cause a synchronization on more than one piece of information; see below Example 2.

These two pieces of information are used to update your book views in the following way:

1.The current verse is examined within all available commentaries you have installed to see if there is relevant information.
2.The current word(s) is searched through the topics of all available non-commentary modules (including general books, dictionaries, maps, etc).

Now, depending on the options set on each book view, the following might happen:

The current topic of your current module changes in order for the relevant information/topic to be displayed
The module tabs of your book view are updated with some colored dots (e.g. dot_match_bluedot_fuzzy_blue, dot_match_greendot_fuzzy_green, dot_matchdot_fuzzy) on the top-right that give feedback on whether the module has related information or not (a yellow light also appears, depending on options).

The whole behavior is controlled from the Synchronize icon that you can find on the book view toolbar (the red paper clip icon clip0025). In order for any book view to be synchronized this icon should be checked/pressed. If you click on the small black arrow on the right you will get three options:

1.Link commentaries allows you to set whether this book view will be synchronized on the current verse
2.Link dictionaries/books/maps allows you to set whether this book view will be synchronized on the current word(s)
3.Link this view even if inactive allows you to set whether this book view will be synchronized only when it is the active one, or even if it is inactive.

Type 2 synchronization

This only occurs within a single Book view whenever you change the current topic. What happens here is that all other module tabs of the same book view are updated with the colored dots described above to show whether they have relevant information to what you read. The only difference is that in that case:

1.The current verses changes when you display a topic of a commentary (so the current verse becomes the commentary entry)
2.The current word changes when you display a topic of a non-commentary (so the current word becomes the subject of the book entry).

The Synchronize icon settings are irrelevant in that case since only the red-dots are affected with this type of synchronization.

Status Bar indication

At any moment, the status bar at the bottom of the main window will display the current verse and current word:

The Dct entry is updated from both Type 1 and Type 2 types. The Cmt entry is updated only from Type 1 actions.

What do the colored dots dot_match_bluedot_fuzzy_blue, dot_match_greendot_fuzzy_green, dot_matchdot_fuzzy mean?

These dots appear on the book view buttons/tab on the tab bar, and indicate whether the associated module has relevant information to the current verse or current word. Notice that there are total six dots, 3 pairs: The different colors (blue, red, green) are just used to match the color coding used for the tab button text (that changes according to the module type). Yet, for each color there are two different shades, a dark one and a light one. The dark one is used when there is a direct match on the current verse or current word being examined, the light one when there is an indirect one.

In the case of non-commentary modules, the faded dots will appear only if the Fuzzy matching for topics option is turned on. You may also read the topic How word lookups are performed to get an idea of how the Fuzzy option affects word matching.

The following table summarizes the cases:

Dot

Color

Used for

Meaning

dot_match_blue

Blue

Commentaries

The commentary contains a comment for the current verse precisely

dot_fuzzy_blue

Light blue

Commentaries

The commentary contains a comment on a passage that includes the current verse (including book and chapter level comments)

dot_match_green

Green

General Books

The Book has a topic that matches exactly

dot_fuzzy_green

Light Green

General Books

The Book has a topic that matches using the Fuzzy logic

dot_match

Red

Dictionaries

Same as Books

dot_fuzzy

Light Red

Dictionaries

Same as Books

What about the yellow glows?

The yellow glow that appears on the button tabs is just an extra optional indication to help you identify more easily the modules that have a match on the current verse or word. It can be turned on/off from the Highlight buttons' background for matching modules. There are two different shades of the yellow glow, that represent the two different types of match that are available (according to the table above):

Remember, that the different colors of the dots have no meaning other than identifying the module type (e.g. commentary, dictionary, general book, etc). The only two different states that you need to differentiate are the dark glow/dots and the light glow/dots:

Dark is always used for exact matches (more relevant information)
Light is always used for fuzzy matches (less relevant information)

How commentaries are synchronized

Type 1: A commentary is a module that has content related to a verse, a range of verses (passage), a chapter or a book of the Bible. The View Synchronization feature works only for verse and passage comments. Let's suppose that you have a commentary that has comments for Gen 1:3-10; Gen 1:8-10; Gen 1:9; Gen 1:9-20. Now, as you change the current verse of the active Bible view, the commentary will display:

Verse in Bible view

Commentary synchronized on

Colored dot displayed

Gen 1:1

- (no comments  on this)

dot_fuzzy_blue

Gen 1:3

Gen 1:3-10

dot_fuzzy_blue

Gen 1:7

Gen 1:3-10

dot_fuzzy_blue

Gen 1:8

Gen 1:8-10

dot_fuzzy_blue

Gen 1:9

Gen 1:9

dot_match_blue

Gen 1:10

Gen 1:9-20

dot_fuzzy_blue

Gen 1:11

Gen 1:9-20

dot_fuzzy_blue

Notice that a verse level comment is preferred over a passage level comment (see Gen 1:9: there are matching topics: one for topic on Gen 1:9 and one for topic on Gen 1:9-20).

Type 2: The logic is identical with Type 1, the only difference is that the current verse changes when you change the topic of a commentary. The colored dots on the tab bar are updated to display if other commentaries have relevant information according to the table above.

TIP: Consider the following case (Cmt stands for commentary):

CmtA with an entry on Gen 1:3-5
CmtB with an entry on Gen 1:2-6
CmtC with an entry on Gen 1:2

Your book view displays the CmtA and you click on Gen 1:4 on your Bible view, so:

CmtA will display a light dot (passage match for Gen 1:3-5) and will jump to display that
Cmt B will display a light dot also (passage match for Gen 1:2-6)
CmtC will display no dot

 

Let's say that you now click on the CmtB tab, so you see the entry for Gen 1:2-6 of CmtB. Now, the question is what happens to CmtC when you click on the CmtB module tab? The two possibilities are:

1.CmtC should sync now on Gen 1:2, since in your Book view you now see CmtB on Gen 1:2-6, so the driving verse is Gen 1:2
2.CmtC continue to be synced to Gen 1:4, since this is the originating verse.

The answer is that theWord behaves according to the logic in case 2. The paradox here is that in front of you, you now see CmtB, it displays the entry on Gen 1:2-6, yet CmtC has NO colored dot to indicate that it also has a comment on Gen 1:2. The reason is of course that the Type 2 synchronization happens only when you change the current topic on the book view.

If the logic worked according to case 1, you would not be able to really go through all the commentaries on your Book view to see what each one has to say for Gen 1:4, which was the original verse that you clicked on your Bible view.

How books are synchronized? (books refers to all non-commentary modules)

The logic is identical to the one used for commentaries. Reading the example below will help you understand how this is helpful

The dark/light dots are displayed according to the Fuzzy matching for topics option (if this is off, only dark dots appear). You can read the How word lookups are performed topic on how the matching occurs.

A notice on clicking on word links in the Bible view and elsewhere

Apart from the Bible text, the Bible view may also display several links (like Strong numbers, Morphology codes, Commentary links) which, when clicked, will cause a Book view to display the target topic. In a very practical way, clicking on a link is very similar to syncing to the current word. The major difference is that when you click on an actual link, theWord may need to resort to change the current module of one of the book views in order to display the content (if no book view exists, a new one will be created; if none of the current book views can display the target of the link -due to settings-, a message will ask you whether you want to create a new view to do so)! Remember, that standard view synchronization will never cause the current module of any book view to change!

TIP: Keep in mind, that when you click a word that is a link (e.g. a Strong number), theWord tries no matter what to display the target (think of it like commanding the program to try to respond to your request);

When clicking on a non-link word in the Bible view theWord will do nothing if the current settings do not allow any action to be taken.

Two exceptions/additions on matching

There are two important exception on the how theWord performs the matching:

1.In case you click on a word in the Bible view and the module has associated lemma information for this word (this can only exist for original languages modules), then the matching will be performed using the lemma, and not the actual word.
2.When matching words against dictionaries marked as containing strong definitions which also contain the word lemmas corresponding to the definitions (all official Strong dictionaries modules have this information), then the matching is performed on the actual topics (e.g. H1, H2, H3, ..., G1, G2, G3, ...) but also on the lemmas (original words). This is very useful since it allows to sync original word modules that have no strong indices with the strong dictionaries.

Putting it all together - examples

Keep in mind that Type 1 synchronization causes the current topic to be changed when clicking on a word/verse. Also, when clicking on a link the current  module may also change to display the target. These techniques can be proved very useful in order to use multiple book views and synchronize each one with a different module.

The following examples use standard modules and abbreviations that should come with a default installation of the program. It is a good idea to try out some of these examples since they will give you valuable ideas on how you can organize your views and use the potential behind this mechanism.

To follow the examples, remember that:

Sync on/off means that the Synchronize icon clip0025 is pressed/checked
Link Cmts on/off means that the Link commentaries option is checked (click on the black arrow above to see the popup menu)
Link Dcts on/off means that the Link dictionaries/books/maps options is checked (click on the black arrow above to see the popup menu)
Link EiI on/off means that the Link this view even if inactive option is checked (click on the black arrow above to see the popup menu)

Example 1: syncing on Strong and Morph codes, 2 commentaries following

Setup (omit some book views at a time to make it simpler):

One Bible view with TR, make sure Strong and Morph links are displayed (see Bible view options)
One Book view (1) with Mickelson/Strong, Sync on, Link Dcts on, Link EiI on
One Book view (2) with Thayer, Sync on, Link Dcts on, Link EiI on
One Book view (3) with RMAC, Sync on, Link Dcts on, Link EiI on
One Book view (4) with TSK, Sync on, Link Dcts on, Link EiI on
One Book view (5) with Gill, Sync on, Link Dcts on, Link EiI on

Try:

Click on a strong number: Book view 1 and 2 jump to display the definition
Click on a morph code: Book view 3 jumps to display the definition
Click on a verse (e.g. Matt. 1:1): Book views 4 and 5 will jump to that verse.
Click on Matt 1:2: Book views 3 and 4 follow.

Notice: Since Strong numbers are links, even if none of the Book view 1 and 2 where displaying a dictionary capable of displaying strong numbers, one of the two would be used to do so. Remember, clicking on a link is like 'commanding' theWord to display the content.

Now, click on Book view 4 and 5 and turn off the Link EiI. Now, click again on Matt 1:1, Matt 1:2, ... Notice that ONLY if one of the Book views 3 and 4 is active it will follow you.

Now, turn off the Sync from Book view 1 and change the module of both Book view 1 and 2 to something else. Click on the strong number again and you will notice that Book view 2 will switch to Mickelson to display the Strong definition. Book view 2 has still Sync on, so it will be used.

Now turn off Sync from Book view 2 also and change the modules to NOT display Mickelson: click again on the Strong link and you will notice that theWord asks you to use a Bible view to display the definition.

Example 2: syncing on Strong and actual word on a single click

An interesting feature of theWord is that it can hide Strong numbers, Morph codes and lemmas behind the words (see Bible view options and check the Show no link, just show in a popup the ... option in the Strong's number and Morphology codes pages). In this case, clicking on a word in the Bible view actually sets the current word according to the Bible view options -> Word click options settings.

Setup:

One Bible view with KJV: Strong numbers should be on, yet with the Show no link, just show in a popup the ... option checked, they should not be displayed
One Book view (1) with Mickelson/Strong, Sync on, Link Dcts on, Link EiI on
One Book view (2) with ISBE, Sync on, Link Dcts on, Link EiI on

Go to Matt. 1:1 and click on the 4th word generation. Notice that one Book view will show the Strong's number, while the other one will display the topic Generation from ISBE.

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