13 The Browse Window

 

  

The Browse Window is located in the center of the BibleWorks Main Window. It displays the actual text of verses resulting from searches.  When you click on a verse in the Search Window Verse List or look up a verse from the Command Line, the text of the verse will be displayed in the Browse Window.

 

The Browse Window Header

The Outline List Box

The Browse Window Options Button

The Browse Window Text Area

Looking Up Words in the Biblical Text

Setting the Browse Mode

Browse Window Scrolling Shortcuts

Context Menus

Looking Up Strong's Numbers

Opening Additional Browse Windows

Synchronizing Browse Windows

The Greek Alias List

The External Links Manager

 


The Browse Window Header


The Browse Window Header is the upper portion of the Browse Window. You can customize it to display a dropdown outline of the Bible or a series of navigation List Boxes that allow you to select the Bible version, book, chapter, and verse, plus a few other items.  To change the items displayed right click on a blank area of the header and select the options that you want from the context menu. The options are:


The Outline List Box


The top of the Browse Window Header contains a dropdown list box which contains an outline of the entire Bible. This dropdown List Box displays a general description of the Bible passage currently displayed. It is taken from Metzger's Bible Outline. If you click the button on the right of the List Box, you will be shown the entire outline centered at the current verse. You can then select any verse in the outline to display in the Browse Window. To the right of the Heading is another button that can be used to edit the contents of the Outline or create a new outline. BibleWorks ships with a sample outline called "parashot" donated by a user. It differs from the default outline only in the Old Testament, but gives an example of what can be done. Other outlines from various Bible versions' section headings are supplied, as well. When you change the Bible outline file in the Browse Window Header, this also changes the Bible outline file that displays in the Bible Outline tool that is opened from Resources | Miscellaneous | Bible Outline.

 

To edit the current outline click on the drop arrow button to the right of the Outline List Box. Then select "configure". In the window that opens select "Edit". Make your changes and save the file. Then click on the "compile" button. To create a new outline follow the pattern in the default outline file and create and compile a new outline file.  You must use the BibleWorks default three letter names for books.

 

The functonality of the Outline List Box is currently limited to versions of the Biblical text..

      


The Browse Window Options Button

This button displays a list of options and utilities related to Browse Window functions.  The options are:  


The Browse Window Text Area

 

The area below the Browse Window Header is used to display the actual text of verses that you look up. Many functions in different parts of BibleWorks use this Window to display Bible Text. Text can be displayed in two modes, Single Version Browse Mode or Multiple Version Mode. See below for how to change modes. The Browse Window text area is closely linked with both the Search Window and the Analysis Window. If you double click on a word, the word will be looked up in Search Window. If you double click on a version label, that version will become the default search version. If you move the mouse cursor over a version identifier, information about that version will be displayed in the Analysis Window in the Word Analysis tab. This information can be customized by editing the file called "XXX.bww" where XXX is the BibleWorks version identifier (which may be more than three letters).

 


Looking Up Words in the Biblical Text

 

As you are reading text in the Browse Window, you may notice a word that you want to investigate. You can easily look up all verses where a given word appears by double-clicking on it with the LEFT mouse button. When you double-click on a word in the Browse Window, BibleWorks will look it up and display in the Search Window all of the verses where it appears.

 

You can also lookup a phrase in the Browse Window without doing any typing. Simply highlight the phrase in the Browse Window that you want to look up. This is done by clicking and dragging with the LEFT mouse button. After highlighting the phrase you want to look up, RIGHT click on the highlighted words and select Search for phrase. The list of verses where the phrase occurs will appear in the Command Center.

 


Setting the Browse Mode

 

This button toggles the Browse Mode of the Browse Window.  The text of Bible versions can be displayed in the Browse Window in two different modes:


Browse Window Scrolling Shortcuts

 

The Browse Window has several shortcuts to facilitate browsing through text. There are three different scroll modes. To change the scroll mode place the mouse over the Browse Window and click with the Left Mouse Button. Then press: Ctrl + Shift + á (the up arrow key). As you press this key combination three times you will see the current scroll mode shown the in Information Window in lower left hand corner of the BibleWorks Screen. The three scroll modes are:

 

Scroll Mode

Function

Non Synch Mode

In this mode the up and down arrow keys will cause the Browse Window to go backwards and forwards one verse.

Synch Mode This is the same as the previous mode, but all open Browse Windows will be scrolled as well.
Scroll Mode Off This is the default mode. The up and down arrow function as navigation keys within the Browse Window.

 


Context Menus

 

If you RIGHT click with the mouse on a word in the Browse Window you will be presented with a Context Menu that gives you quick access to a number of lookup and configuration options related to the word. The options presented will depend on the word that you click on. The following is a list of the possible options:

 

Menu Option

Type of Text

Function

Search on Word

All Text

This option will perform a search on the clicked word and show the verses where it is found in the Search Window Verse List Box.

 Append to Command Line

This option will append the clicked word to the Command Line.

Apply Color to Selected Text

This option will change the color and character attributes of the clicked word or selected text. The color and attributes used are determined from the settings in the Color Selection Window (see next item).

Open Color Selection Window

This option opens the Color Selection Window. This window allows you to set default colors and text attributes for the coloring functions in BibleWorks. You can also turn search hits into permanent colors, among other things.

Clear Hit Highlighting Clears the hit highlighting from Browse Window Text until the next search.
Search word in KWIC This option opens the selected word in the KWIC module, ready for searching.

Lookup in Default Bible Dictionary

English

Word

This option will look up the selected word in the default Bible Dictionary.

Search for Phrase

Highlighted

Phrase

This option will perform a search on the selected phrase and display the found verses in the Search Window Verse List Box.

Copy Selected Text This option opens a submenu containing user-configurable copy options. The default copy options enable you to copy the text to the clipboard, to the editor, or to Word. The Unicode copy options are provided for copying Greek or Hebrew text in Unicode.

Copy Phrase to Command Line

This option appears on the Copy Selected Text submenu. This option will copy the selected text to the Command Line.

Search on Strong's Number

Strong's

Number

This option will perform a search on the selected Strong's Number. The found verses will be displayed in the Search Window Verse List Box.

Lookup Thayer/BDB Definition

This option will display the Thayer/BDB definition for the selected Strong's Number (i.e. from The Strong's Lexicon).

Hide Strong's Numbers

This option will Hide/Show Strong's Numbers.

Resource Summary Window

Greek or

Hebrew

This option will open up a floating Resource Summary Window displaying a summary of lexical entries for the word, as well as a summary of citation locations for the verse. This is the same as the Resource Summary tab in the Analysis Window but is in a floating window.

Search on form

This option will perform a search on the chosen form.

Search on Lemma

This option will perform a search on the lemma behind the selected form.

Search on Homonym This option will perform a search on the homonym of the lemma behind the selected form (Hebrew only).

Lookup Lemma in Lexicon Browser

This option will look up the selected form or form behind the selected lemma, in the default Greek or Hebrew Lexicon.

Send Verse to Lexicon Browser

This option will send the current verse to the Lexicon browser. The Browser word list will be replaced with a list of the words in the verse for easy lookup.

Open NT Diagram at this Word

This option opens the Diagramming Module and loads the Greek NT diagram for the NT passage displayed in the Browse Window. The word selected in the Browse Window is highlighted in the diagram.

Search on Lemma

This option will perform a search on the lemma behind the selected form.

Search on Form in KWIC This option will open the KWIC module with the selected word, ready for searching.
Lookup Lemma in KWIC This option will open the KWIC module with the lemma of the selected word, ready for searching.

Supplemental Hebrew Codes

For Hebrew morphological versions only, this provides display options for the morphological codes. The options are:

1. No Supplemental Codes

2. Full Supplemental Codes

3. Condensed Supplemental Codes

This is useful to condense the display of Hebrew morphological text, which can take up a lot of screen real estate.

Remove This Version from Display List

Version ID

Removes the selected version from the Browse Window display list

Make This the Current Search Version

Makes the selected version the current search version.

Add Another Display Version

Opens a window to change the search or display versions.

Edit version notes for this version

Edits the version notes for this display version. The version notes are the notes displayed in the Analysis Window when you move the mouse cursor over the version identifier.

 


Looking Up Strong's Numbers

 

You can turn on the display of Strong's Numbers (for versions that have them) by selecting "Toggle Strong's Numbers" from the Browse Window Options Button menu. When you pass the mouse cursor over the number, the Strong's BDB/Thayer Lexicon entry will be displayed in the Analysis Window. You can also right click on the number and choose "Lookup Thayer/BDB Definition". If you do that the Thayer/BDB Definitions Window will open. This window provides an interface that permits you to browse the Strong's Numbers.

 


Opening Additional Browse Windows

 

You can open up additional Browse Windows by clicking on the Browse Window Options Button  and choosing "New Browse Window". The new Browse Window will not have the full functionality of the Main Window Browse Window. In particular it does not have its own full Analysis Window. All it will have is the equivalent of the Analysis Tab.

 


Synchronizing Browse Windows

 

You can synchronize multiple Browse Windows so that they can be scrolled together. To do this you must first open the browse windows that you want to synchronize. Then for each one Right Click on the Browse Window Header and select "Show Current Verse." This will add a current verse display to the Browse Window and also a synchronization check box. Only Browse Windows with the synchronization check box checked will be synchronized. To synchronize the windows all at once click on the  button on the Main Window Button Bar. To scroll the Browse Windows in unison hold down the SHIFT key when you use the scroll bars to the right of the text display.

An easier way to display versions in parallel is to open several versions at once in one window with the Parallel Versions window button . You can also do this via the Main Window Menu by selecting Tools | Viewing the Text | Parallel Versions Window.


Secondary Browse Windows

 

When you look up a word in the Browse Window by double-clicking on it in the Browse Window, the Command Center Results Verse list will display the resulting matches. If you click on one of these verses the Browse Window will switch to the verse. If you prefer you can instead have the new verse open up in a new Browse Window.  This feature can be enabled by selecting View | Show/Hide | Secondary Browse Windows from the Main Menu. If Secondary Browse Windows are enabled, when you do a search in a Browse Window by double-clicking or by means of the context menus, a new Browse Window will open up automatically to display the results of the search. The next time you do a search from the original window, BibleWorks will remember that there is already a secondary window open to receive the results. If you do a search from an already existing secondary window, then a new third Browse Window will be opened to receive its results. BibleWorks will remember which window was used to open up each secondary window.

 


 

The Greek Alias List

 

The Greek Alias Window can be opened by selecting Tools | Interface/settings | Edit Greek Alias List from the Main Menu. When you do that a Window similar to the one shown here will open.

 

The Greek Alias List is a list of Greek word collections (mostly pairs) that help BibleWorks match Greek lemmas in the various databases in BibleWorks with the various lexicons supported. A list such as this is necessary because lexicons are not consistent in the way they spell entries and organize lexical information. If BibleWorks cannot find a Greek word in a particular lexicon it will look in this list to find alternative spellings. This list is also used in the Analysis Window. When you move the mouse cursor over a word, all the alias words (if there is an alias) will be looked up and displayed, to provide you with as much useful lexical information as possible.

 

The word collections (mostly pairs) are bi-directional so the order in which you enter them does not matter. BibleWorks will check both words in the collection unless the first word contains a plus ( + ) character (used in compound words). See the default list for examples of this.

 

1. To edit a word collection, double click on an entry and edit the word collection in the window that opens.

2. To add a new word collection click on the "add" button and an entry Window will open.

3. To delete an entry select it with the mouse and click the "Delete" key.

 

Changes in the alias list will not be finalized and saved to disk until you select the "Save" Button. The changes will not be made available for use by the program unless you do this. The Greek Alias Window is a "modeless" Window, which means that it can remain open while you work with other parts of the program.

 

You should be careful about deleting entries as the default entries are necessary for BibleWorks to work well with the variety of Lexicons supported. The entries are saved in a text file called "grkalias.gal". The compiled list is saved in "grkalias.dbx". Both are in the BibleWorks Databases directory.

 

If you want to make changes in the list, it is recommended that you save the alias list with a different name. That way future program updates will not overwrite your changes. To do this select "Save As" from the Greek Alias Window File menu and choose a new name. All Greek alias lists have the GAL extension.

 


The External Links Manager (ELM)

 

The External Link Manager provides a means of accessing Web sites or other PC applications from within BibleWorks, and passing information and/or search parameters to them. This in effect allows BibleWorks to control these applications. The External Links Manager permits you to define the nature of the link and attach it to a BibleWorks menu so that the link can be executed just by choosing a menu entry.

 

For those of you who are programmers, what BibleWorks does when you click on one of these menu entries, is gather the information that you have specified for the link and pass it to the operating system in the form of a ShellExecute command. BibleWorks handles all the details so you don't have to, but knowing what is going on may help some people understand better how to use the ELM.

 

The External Links Manager can be opened on the main menu by selecting Resources | Edit external links. Links that are designated to be opened from the main menu can be opened by selecting Resources | External Resources, then selecting the desired resource from the menu. The External Links Manager can also be opened from the Main Window Button Bar by clicking on the button. The dropdown will list only the items that are identified in the Links Manager as being external links (see below).

 

Example 1: The Perseus Web Site

 

An example will help you to understand how to construct a link. You must first know the syntax required by the target site or application. This can usually be found in the user manual or in a technical section on the web site you are trying to link to.

 

For example, www.perseus.tufts.edu has an online copy of the Liddell-Scott-Jones Lexicon and you can look up words in it online. Often you can follow online menus to lookup words and then look on the Internet Explorer Address Bar to see what command was executed. When you do that in the case of this web site you will learn that to look up, for example, the word poie,w entry in Liddell-Scott you would enter this:

 

          http://www.perseus.tufts.edu/cgi-bin/lexindex?entry=poie/w&display=Beta

 

The "display=Beta" tells Perseus that you are entering the word in CCAT Beta Code format (a way of representing Greek words with ASCII characters).  So let's see now how we would set up BibleWorks to be able to take a lemma in the Browse Window and pass it to Perseus, at the click of a mouse.

 

All your External Links Manager entries will be saved in a file called shellexec.txt in the BibleWorks INIT subdirectory. You can share them with other people by cutting and pasting in a text editor. The entry for the above example would look like this:

 

//

// External Link #1

//

[Lookup Lemma at Perseus Web Site]

Operation = Open

Directory = NULL

File = http://www.perseus.tufts.edu/cgi-bin/lexindex?entry=<dummy>&display=Beta

Parameters = NULL

MenuLocation = Browse Window Greek Morphology

TextType = Greek Morphology

MapToVersion = BGT

Lookup = Lemma

MenuText = Lookup Lemma at Perseus Web Sites

Enabled = 1

 

Example 2: Opening a BibleWorks (or other) CHM File

 

This example shows you how to add a menu option to BibleWorks that opens an HTML Help file. As an example we will use the BibleWorks Hebrew Paradigms file.

 

//
// External Link #23
//
[Hebrew Paradigms]
Operation = Open
Directory = NULL
File = databases/hebpar.chm
Parameters = NULL
MenuLocation = Browse Window Hebrew
TextType = NULL
MapToVersion = NULL
Lookup = NULL
MenuText = Hebrew Paradigms
Enabled = 1

 

Most of the parameters have a NULL setting which just indicates that the parameter is unused. Basically all you have to enter is the CHM file name in the "File =" option and the internal HTML file name and internal bookmark names in the "Parameters =" option. We use NULL for the "Parameters =" option to tell BibleWorks to open the CHM file to the index. If you don't know the internal files stored in the CHM file you must use NULL for the "Parameters =" option. If you know the internal filename and a bookmark you can specify them (it might look something like "hebrew.htm#vni". The file name can be a full path including drive and directory. If no drive is specified it is assumed to be a path relative to the BibleWorks main directory. The example above, for instance, looks in the BibleWorks databases directory for the hebpar.chm file.

 

Other Examples

 

When you first open up the External Links Manager, the links list will contain a number of sample links. You can use these as examples to construct your own links.  These samples are dependent on Web Sites that are beyond our control, so some of the links may or may not work. They are also dependent on the existence of databases and other programs that you may not have on your system. Only a couple of the links are initially enabled so the others will not appear in menus until you activate them by checking the "enable this link" check box.

 

The following is a list of the included samples. A backup copy of this list is saved in shellexecsample.txt in the INIT directory:

 

Logos - NA27

Logos - KJV

BibleWorks Web Site

Lookup in Latin Morphology at Perseus

Lookup in Morphology Index at Perseus

Lookup in Morphology Index at Perseus

Lookup Lemma at Perseus Web Site

Lookup Lemma at Perseus Web Site

Lookup verse in Metzger

Lookup verse in SESB BHS

Lookup verse in SESB NA27

Narrate WTT Chapter

Open Smyth Greek Grammar at Perseus

Consult great Isaiah Scroll online

Consult Tischendorf critical apparatus online

Targumim English translation at Tulane U.

Search CAL Comprehensive Aramaic Lexicon

Lookup text in TLG demo site

Lookup text in TLG site

Look up in Italian dictionary

Lookup in hyperdictionary

 

The External Links Manager Window

 

Section

Purpose

Menu

Entries

This lists all the External Links that you have currently defined.

These buttons allow you to rearrange the links list by moving the selected item up or down in the list.

This button will cause the links list to be sorted (alphabetically)

This button will create a new links entry. As a convenience most items will not be cleared, but a new links list entry, menu name and description will be created.

This button will delete the currently selected link item.

BibleWorks

Provides

This option tells the Links Manager what BibleWorks will provide to the link. Then when you include the phrase "<dummy>" in the "Web page ..." section below, it will be replaced with this information when the link is executed. Options are:

  • Verse Reference - BibleWorks provides the current verse reference in the BibleWorks format (book chapter: verse". If the target expects verses to be mapped to a different version you can specify this in the "Map verses using ..." section.

  • Form - BibleWorks provides the Greek/Hebrew form associated with the selected text (if there is one)

  • Lemma - BibleWorks provides the Greek/Hebrew lemma associated with the selected text (if there is one)

  • NULL - Nothing is provided by BibleWorks.

... with this

text type

This specifies the type of text that needs to be under the cursor to provide the <dummy> information. If the text under the cursor does not match this criterion, nothing will be provided and there will be no action taken. The options are:

  • Bible Verse

  • Greek Morphology

  • Greek Text

  • Hebrew Morphology

  • Hebrew Text

  • Latin Text

  • External Resource

  • NULL

Menu
Location

This tells BibleWorks where to put the menu entry for this link. It also contains options to activate a link based on a BibleWorks event rather than a menu selection. The options are:

  •  Browse Window All

  •  Browse Window English

  •  Browse Window Greek

  •  Browse Window Greek Morphology

  •  Browse Window Hebrew

  •  Browse Window Hebrew Morphology

  •  Browse Window Latin

  •  Browse Window Other

  •  External Resources

  • On Browse Verse Change

  •  NULL

The Browse Window options all refer to placement on the Browse Window Context Menu. "External Resources" refers to the Main Menu Resources | External Links menu item.

 

Map verses

using ...

If BibleWorks is providing a verse to the target web site or program, it will be remapped to the version specified here before being added to the link. The options are:

  • WTT

  • BGT

  • KJV

  • RSV

  • NULL

Menu entry text

This specifies the text that will appear in the menu.

Web page, File to open, or executable to run.

This specifies the name of an executable to run or Internet Explorer address line to process or the name of an HTML Help file to open. If the executable has blanks you should enclose it in quotes.

Parameters (if previous item is an executable or CHM file)

If the target is an executable this information will be passed as a command line parameter. If the target is a CHM file this contains either NULL or an HTML file name embedded in the CHM file. If you specify NULL the CHM file will open to the index.  If the parameter is a file or path that has blanks you should enclose it in quotes.

Description (for documentation only)

This description will appear only in the Links Manager links list box on the left.

Enable this link

This check box activates and deactivates particular links. This permits you to keep link information in the links manager but not have the link show up in BibleWorks menus.