12 The Search Window

 

  

The BibleWorks Search Window, which occupies the left third of the Main Window, provides a user interface that is used for performing searches on the various Bible versions in BibleWorks.

 

The Parts of the Search Window

The Command Line

The Results Verse List Box

The Successful Search History Button

The Command Line Versions Button

The Choose Search Version Window

The Choose Display Versions(s) Window

The Choose Search Limits Window

Edit Search and Display Favorites

Synchronize Results List

The Common Search Utilities Button

Copy Button

Using Tabs

The History Back Button

The Search Window Verse List Context Menu

The Word and Verse History List Boxes

Choosing Hypertext Scripture Reference Popup Versions

 


The Parts of the Search Window


The search window is composed of several parts. The functions of the various parts are summarized as follows:

 

The Command Line

 

The Command Line is a text input box at the top of the Search Window. It is where you enter words, morphology searches, or verses to look up. For example, assuming that your search version is the King James Version, if you enter the phrase < 'in the beginning > (do not type the angle brackets) on the Command Line, the Verse List Box under the Command Line will display all verses that contain the phrase. There is much more that can be done with the Command Line and there is an entire chapter in this manual devoted to it. See the Command Line section.

 

The Results Verse List Box


The Search Window Verse List Box is a List Box under the Command Line where verses found by word searches or verse lookups are displayed. You can click on a verse with the left mouse button to look it up and display the text in the Browse Window. Use the scroll bar to view the entire list.

 

The Results Verse List Box takes up most of the space in the Search Window. It displays the text of the verses resulting from your search.

 

The Verse List has a scroll bar on the right. It can be used to scroll through all the entries in the list. Above the scroll bar is a "spin button" which can be used to step through the verses one by one with the Browse Window being updated as you scroll. The Verse List also contains check boxes for each verse reference that can be checked or unchecked as needed. The check boxes enable further processing on selected verse results. The use of the check boxes is discussed below under the Search Window Verse List Context Menu.

  


The Successful Search History Button

 

The narrow button to the right of the Command Line opened up a dropdown list showing the most recent successfully completed Command Line searches. This provides an easy way to repeat a search if you need to do so. Entries are not added to this list until they are executed without any error messages. To reexecute a search simply select it from the menu.

If you enter a search that results in an error you can fetch it to the Command Line so you can make corrections by pressing the UP arrow key. The UP and DOWN arrows cycle through previous Command Line entries regardless of whether or not they were successful.

 


 The Command Line Versions Button

 

The button below the Command Line displays the BibleWorks name for the current search version. Each Version in BibleWorks has a short name, three or more letters long, used to reference the version in BibleWorks. That is what will be displayed here. This button also opens up a menu that permits you to perform common search and display version options. The menu options are:

 

§         Choose Search Version

§         Choose Display Version(s)

§         Choose Search Limits

§         Edit Search and Display Favorites

§         Synchronize Results List

 

This button also provides a graphical indication of whether or not certain features have been set. If you execute a search and get an error message it may be that you have simply forgotten that an option has been set. For example, you may have forgotten that you have search limits set and are puzzled that a search did not find any verses. The visual indicators provide an easy way to tell whether or not certain options are set.  The visual indicator is five green boxes on the left hand side of the button. Each box represents a specific feature and it will turn yellow if the feature is turned on or is active. The boxes represent the following settings:

 

§         First box: This is yellow if you have any search limits set.

§         Second box: This is yellow if you have any cross version search options set.

§         Third box: This is yellow if accent-sensitive searching is on for the current search version or if "smart apostrophes" is turned on for English versions.

§         Fourth box: This is yellow if you are using a Hebrew version and Hebrew vowel-sensitive searching is on.

§         Fifth box: This is yellow if Command Line check box filter searching is on.

 

If a search is performed in one Bible version, and then the search version is changed to a different Bible version, the Command Line Versions Button will contain two Bible version names separated by a slash. When this appears, the left version name is the current search version, and the right version name is the version used to display the current search results in the Search Window.

 

In this example, the WTM is the current search version. If you enter a search on the Command Line, the search will be run over the WTM, not the KJV.

 

 

The KJV is the version used in a previous search. The current list of search results displayed in the Search Window is displayed using the KJV. To display the list of search results using the current search version (in this example, the WTM), click the Command Line Versions Button and select Synchronize Results List.

 

The Choose Search Version Window

 

When you select "Choose Search Version" from the Command Line Versions Button the Choose Search Version Window will open. The Search Version is the version used when you execute searches from the Command Line. All you have to do is navigate the tree view and select the version you want. The Window also has a dropdown list box that permits you to determine how the search version setting affects searches. The options are:

§         Search Only Current Search Version
This is the default mode. When this mode is set searches will be performed only on the current search version.

 

§         Search All Display Versions
If this option is active the search will be conducted across all display versions of the same language as the search version. The Search Window verse list box will contain a list of all verses where a match was found. The results are mapped to the current search version. Stats apply only to the search as performed in the current search version. If you see a verse ref with a single asterisk by it and no number, this is a verse for which no hit was found in the current search version, but there was a hit in one of the other display versions. Hits will be highlighted in all display versions.
 

§         Search and Display All Same Language Versions
This works in a fashion similar to the previous option but the search will occur in all installed versions with the same language as the current search version. If a hit is found in one of these search versions it will be activated as a display version. This mode is useful in looking for a word or phrase that occurs in some version but you don't remember which one.
 

§         Search and Prune All Same Language Versions
This option works like the previous one but if a version does not have any hits it will be removed from the display version list. The search version however is never removed even if it has no hits.

By default the check box in the lower left hand corner is checked to Close on Selection. If you wish to keep the search version window open after making a selection, uncheck this box.

  

If the Show Only Active Display Versions check box in the lower left hand corner is checked the versions listed will be limited to only current Browse Window display versions.

  

The Choose Display Versions(s) Window

 

When you select "Choose Display Version(s)" from the Command Line Versions Button, the Choose Display Version(s) Window will open. This determines which versions are displayed in the Browse Window. All you have to do is navigate the tree view list and check the versions you want displayed.

 

If the check box in the lower left hand corner is checked the versions listed will be limited to the languages of the currently displayed display versions.

 

The Choose Search Limits Window

 

The Choose Search Limits menu option opens the Tools | Options | Searching | Search Limits window, enabling you to set search limits. For more information on the Search Limits window, see the chapter on Setup Options.

  

Edit Search and Display Favorites

 

The Edit Search and Display Favorites menu option opens the Tools | Options | Bible Versions | Versions window. Within this window you can choose your search version, choose your display versions, and create and edit search and display favorites and parallel versions favorites. By creating favorites you can quickly return to search and display versions that you most frequently use. For more information on the Versions window, see the chapter on Setup Options.

 

Synchronize Results List

  

If a search is performed in one Bible version, and then the search version is changed to a different Bible version, the Command Line Versions Button will contain two Bible version names separated by a slash. When this appears, the left version name is the current search version, and the right version name is the version used to display the current search results in the Search Window. The Synchronize Results List menu item is used to convert all the search results to the current search version text. The name of the previous search version will disappear from the Command Line Versions Button, and only the name of the current search version will display.

  


The Common Search Utilities Button


The Tools button below the Command Line opens up a menu that provides access to commonly used Search Window functions and utilities. The menu contains the following options:

 

§         Graphical Search Engine - This option opens the Graphical Search Engine window.

§         Word List Manager - This option opens the Word List Manager.

§         Verse List Manager - This option opens the Verse List Manager.

§         Open Popup Verse Copy Window - This option opens the Popup Copy Window.

§         Find Related Words (KWIC) - This option opens the Key Word in Context (KWIC) tool.

§         Find Related Verses (RVT) - This option opens the Related Verses Tool (RVT).

§         Find Related Phrases (PMT) - This option opens the Phrase Matching Tool (PMT).

§         Command Line Examples - This option displays a table of Command Line examples.

 


The Copy Button


The Copy button below the Command Line opens a menu that provides options for copying Bible text and verse lists. Further description on copying text and verse lists is found in the chapter on Copying Results. The Copy Button menu contains the options listed below. Some of these copy menu items also contain submenus. The bottom submenu item, Configure Copy Favorites, opens the Tools | Options | Output Format Options setup window. This configuration option appears in a number of the Copy Button submenus. By default the copy options only copy the text of the verse using the current search version.

 

§         Repeat Last Copy Command
Selecting this option will perform a copy using the same settings as the last copy.

  

§         Copy Verse List + Text
Selecting this option opens a submenu that contains a list of copy options to copy the verse list + text.

  

§         Copy Selected Results List Verse
Selecting this option opens a submenu that contains a list of copy options to copy the selected results list verse. Before selecting one of these copy options, first select the Results List verse that you wish to copy.

  

§         Copy Browse Window Verses
Selecting this option opens a submenu that contains a list of copy options to copy the Browse Window verses.

  

Popup Copy Window
Selecting this option opens a window in which you can enter the book, chapter, and verse or verse range that you wish to copy. The Options button in the Popup Copy Window opens the Output Format Options setup window. Press the Copy button to copy the text of the verse or verse range.

  

§         Copy Verse List (No Text)
Selecting this option copies the list of verses but not the text of the verses. By default consecutive verses are joined using "f" and "ff".

  

§         Copy Format Options
The Copy Format Options submenu opens the Output Format Options setup window.

 


Using Tabs

 


The top part of the Search Window contains a row of tabs. When you do a search or change the display verse, the current display context is stored in the currently active tab. This provides a convenient way of working on several different concepts or projects at the same time. If you want to work on something different for a while or follow some links without losing your place, just click on a new tab and work for a while. To return to your previous context, click on the original tab. Tab contexts are saved between sessions. The context which is saved includes the following:

 

§         The display versions

§         The current search version

§         The Browse Mode (single or multiple versions)

§         The current verse

§         The positions of all list boxes in the search window

§         Current search statistics and hit highlighting information

§         The Command Line text

§         Accent, vowel point and apostrophe options

§         Search limits options

§         Cross version search option

 

The Tab Context Menu

 

If you right click on a tab you will see a context menu with the following options (# represents the number of the tab):

 


The History Back Button


The same context information stored in the tabs is also stored in a separate history database. This permits you to return to a previous state just by clicking on a button that backs you up to a previous state. This function is implemented as a left-right spin button to the right of the tabs. Clicking on the left side moves you back and clicking on the right moves you forward. It functions somewhat like the Back and Forward buttons in Internet Explorer.

 


The Search Window Verse List Context Menu

 

The Search Window Verse List has a context menu that can be used to configure the Search Window and perform various related functions. The context menu has the following options:

 

The first options on the Search Window Verse List context menu enable copying Bible text and verse references. Further description on copying text and verse lists is found in the chapter on Copying Results. Some of these copy menu items listed below also contain submenus. The Configure Copy Favorites submenu item opens the Tools | Options | Output Format Options setup window. This configuration option appears in a number of the submenus. By default the copy options only copy the text of the verse using the current search version.

 

§         Repeat Last Copy Command
Selecting this option will perform a copy using the same settings as the last copy.

  

§         Copy Verse List + Text
Selecting this option opens a submenu that contains a list of copy options to copy the verse list + text.

  

§         Copy Selected Results List Verse
Selecting this option opens a submenu that contains a list of copy options to copy the selected results list verse. Before selecting one of these copy options, first select the Results List verse that you wish to copy.

  

§         Copy Browse Window Verses
Selecting this option opens a submenu that contains a list of copy options to copy the Browse Window verses.

  

§         Open Popup Copy Window
Selecting this option opens a window in which you can enter the book, chapter, and verse or verse range that you wish to copy. The Options button in the Popup Copy Window opens the Output Format Options setup window. Press the Copy button to copy the text of the verse or verse range.

  

§         Copy Verse List (No Text)
Selecting this option copies the list of verses but not the text of the verses. By default consecutive verses are joined using "f" and "ff".

  

§         Copy Format Options
The Copy Format Options submenu options open the Output Format Options setup window.

 

§         Invert Verse List
This option will invert the list. The list will be repopulated with all verses not currently in the list.

 

§         Check Box Options
This menu item contains the following submenu items:

  

§         Enable Verse List Check Boxes - This option displays the check boxes.

§         Clear All Verse List Check Boxes - This option clears checked check boxes.

§         Set All Verse List Check Boxes - This option checks all the check boxes.

§         Invert All Check Boxes - This option checks unchecked check boxes and unchecks all checked check boxes.

§         Delete All Checked - This option deletes all checked verses.

§         Delete All Unchecked - This option deletes all unchecked verses.

§         Delete Current (Shift Del) - This option deletes the currently-selected verse. Pressing shift + del on your keyboard deletes the current verse.

 

§         List Box Content Options
This menu item contains the following submenu items:

  

§         Show Reference Only - Checking this option shows the verse references only.

§         Show One Line Verse Text - Checking this option shows the reference plus one line of text.

§         Show Entire Verse Wrapped - Checking this option shows the entire verse, rather than only showing one line of the verse.

§         Show Form Instead of Lemma - If this option is selected and your search version is a morphological version, the Verse List will display the forms corresponding to the lemmas, rather than the lemmas. This allows you to search a morphological version and display the inflected forms instead of lemmas.

 

§         Make Search Results New Search Limits
This option temporarily sets the search limits to the verses currently in the Search Results list box. The change is made only for the next search.

 

§         Show Verse Popups
If this option is selected a popup window will display the full text of the current verse under the cursor if the cursor is over a Results Verse List item. You can choose the versions displayed by selecting View | Choose Popup Versions from the Main Menu.

 

Make Search Results New Search Limits

 

If you need to change the check box setting of a range of verses, click on the first verse in the range (but not in the check box area). Then locate the last verse in the range and with the SHIFT key depressed, click on the CHECKBOX area of the verse. This will reverse the check box setting for the verses in the specified range.

 

 


The Word and Verse History List Boxes

 

BibleWorks maintains a list of verses that you have visited via Search WIndow searches and another list of words and phrases that you have entered on the Command Line. These lists are maintained automatically and maintain a maximum of 1000 entries. When a list gets full, entries will be removed from the beginning of the list to make room at the end for new entries. Both list boxes have a check box that you can use to enable or disable automatic additions to the list. There is also a pair of buttons to add and remove items manually. The contents of these lists are saved between sessions. You can jump to a verse in the verse list to look up a word or phrase in the Word List Box simple by clicking on the item the list. The lists are opened via the two button bar buttons shown here.

 

The Word and Verse History List boxes can also be opened by selecting the appropriate option in the Main Menu View | Show/Hide menu.

 


 

Choosing Hypertext Scripture Reference Popup Versions

 

Many references in BibleWorks have Scripture references that are tagged with hypertext links so that when you pass the mouse over the link, the text of the Scripture reference will be displayed in a temporary popup window near the mouse cursor. You can specify which versions you want to be displayed by choosing View | Choose Popup Versions from the BibleWorks Main Menu.  When you do that a Window similar to the one on the right will open. To choose the versions that you want to be displayed, type the BibleWorks name for each version in one of the text boxes, separated by blanks. If you cannot remember the names you can click on the dropdown list box on the left of the text box to see an alphabetical list of all installed versions.

 

Clicking on an item in the version list box will add it to the text box to the right of the list box. Note that in some cases, where necessary for a specific database to work properly, these values may be overridden by the program.

 

There are two sets of version lists. The second list is used when you have the shift key depressed. When a popup is displayed, the verse will be displayed in each of the specified versions if the verse exists in that version. If you replace a version with a pair of versions separated by a slash, the display will revert to the second item if the verse is from an Apocryphal Book. For example if you enter:

 

NAS/RSV WTT BGT

 

The NAS version will be displayed for Biblical Books and the RSV will be used for the Apocryphal book.