# Menubar

At the top of the GnomeSword main window is the menubar. Almost all of the functions are available by activating the appropriate menu item. The functions have been grouped according to their type. For example, the file operations have been grouped into the File menu.

## Menubar

&appname; menubar

# Toolbars

The function of the Toolbar is to provide control over the Bible and Commentary Panes. Activation of the Toolbar option is done by moving the mouse cursor over the desired toolbar button and selecting it. A tooltip will appear if the mouse cursor is held stationary over a toolbar button, describing the function of the button.

## ToolBar

The Toolbar

The Toolbar consists of the following functions:

- History View Toggle and drop-down menu

- Bible Book Selector

- Bible Chapter Selector

- Bible Verse Selector

- Bible Passage Summary

## History Forward/Backward Selector

Switches between current and previous passage selections.

## Bible Book Selector

Selects the Biblical book to be displayed in the Bible Text Pane and Commentary Pane. Changes take immediate effect.

## Bible Chapter Selector

Selects the Biblical chapter of current book to be displayed in the Bible Text Pane and Commentary Pane. Changes take immediate effect.

## Bible Verse Selector

Selects the Biblical verse of current chapter to be displayed in the Bible Text Pane and Commentary Pane. Changes take immediate effect.

## Bible Passage Summary

Allows manual editing of passages which are displayed in the Bible Text Pane and Commentary Pane. Changes take effect once Enter is typed.

Ensure that edited book,chapter and verse naming is correct, otherwise the wrong or no information will be displayed.

# The Sidebar

## Sidebar

The Sidebar

On the left hand side of GnomeSword there is the Sidebar. Here the user can switch between the different Sword modules, view bookmarks, do simple searches and view verse lists. To switch between all Sidebar functions, shortcuts have been placed at the bottom of the Sidebar. Clicking on the shortcut activates the option.

## Sidebar Shortcuts

Sidebar shortcuts

# The Bible Text Pane

## The Bible Textpane

The Bible textpane

Positioned to the right of the Shortcut bar is the Bible text pane. All your different translations will be displayed for full viewing. When starting GnomeSword either your default Bible translation or the translation last used will be displayed.

## Opening A Specific Bible Translation

In order to change the current Bible translation to another of your choice:

- right-click in the Bible Text Pane. In the popup menu choose FileOpen Module and select your specific translation that you want to view.

- under the Modules option in the Sidebar, choose Biblical Textslanguage choice and select your specific translation.

## Using the Parallel View Mode

A nice function in GnomeSword is the ability to view your specified bible text in five parallel translations of your choice. The Parallel View mode can be accessed by selecting Parallel View just below the Bible Text Pane, next to the Standard View tab. Please note that you can only view one verse at a time. You can change the verse by selecting another verse, chapter, or book at the toolbar. Also note that modules that are Old Testament or New Testament only (eg Westminster Leningrad Codex and Byzantine Majority Text ) will not be able to display books, chapters, or verses that they don't have.

### Bible textpane - parallel view

Bible textpane - parallel view

Additionally, a separate Parallel View window can be selected from the right click menu with Detach/Attach. Your Bible pane will return to its normal single text view, and the new Parallel View window will show the complete chapter, in all 5 translations.

### Parallel View - separate window

Parallel View - separate window

## Opening A Separate Bible Translation

In order to view a Bible translation separate from the GnomeSword interface:

- Under the Modules option in the Sidebar,choose Biblical Textslanguage choice. Then right-click on a translation and choose the Open in dialog option.

## Finding Out About The Current Translation

To find out about the Bible translation currently being displayed:

- right-click in the Bible Text pane. In the popup menu choose About module name.

- Under the Modules option in the Sidebar,choose Biblical Textslanguage choice. Then right-click on a translation and choose the About option.

## Module Options

Most Bible translations have additional options which the user can select.

- Words Of Christ In Red

- Strong's Numbers

- Morphological Tags

- Footnotes

- Scripture Cross-Reference

- Headings

- Image Content

Translations in other languages such as Greek or Hebrew have specific options which deal only with the specific language.

In order to access these options:

- right-click in the Bible Text pane. In the popup menu (example shown), choose Module Options and select the specific option.

### Module Options

Module Options

## View Options

There are several additional modes that can be selected from the menubar's View pulldown.

### View Options

View Options

The first 4 checkboxes control whether each named subwindow is displayed. The viewable state of the subwindows is remembered on a per-tab basis. This makes it possible, for example, to have a tab dedicated to a maps module alone (in a dictionary module, having alphabetically-listed places), by turning off the display of Bible, Previewer, and Commentary for that tab.

The remaining checkboxes control these other display features:

- Verse Style - Toggles between Bible text display in separate verses, or in paragraphs instead. This is set on a per-module basis.

- Pin Tabs - When more than one tab is open, each one's verse is navigated separately in the disabled case. If tab pinning is enabled, then all tabs navigate together, keeping all translations on the same verse.

- Read Aloud - If you enable this, then GnomeSword will funnel all selected verses through the festival text-to-speech system. Festival is a widely-available TTS, often installed by default in Linux distributions.

  Also, mouse-selected text may be read aloud from Bibles, commentaries, and general books, using the right-click menu, regardless of whether Read Aloud is selected.

- Show Verse Numbers - Normally enabled, this toggle can be disabled to prevent display of verse numbers within the text.

- Highlight Current Verse - Initially disabled, this toggle replaces mere alternate colorization of the current verse with a substitute high-contrast highlight. The colors used may be selected from the Preferences dialog.

## Specific Word Meanings

In order to check the meaning of a specific word, double-click on the word you wish to lookup. The word should then highlight itself and the explanation should be displayed, if available, in the Dictionary Pane.

## Finding A Specific Word

To find a specific word within a passage:

- right-click in the Bible Text Pane. In the popup menu, choose Edit-> Find. A separate dialog will appear, which provides text searches. Fill out dialog and click the Find and Find Next buttons.

# Previewer

## PreViewer

Previewer

The Previewer is where the user sees Strong's numbers, morphological tags, footnotes, and cross-references that the Bible Text Pane provides.

Footnote content is normally transient in the Previewer: It is displayed while your mouse hovers over the footnote indicator *n in the Bible text, and then disappears when your mouse moves off. But some translations' footnotes (e.g. NET Bible's) can be very large, so that not all the text is visible. To anchor the text so that you can scroll it in the Previewer, middle-click the indicator and move to the Previewer.

Cross-reference indicators *x also display transiently in the Previewer. Left-clicking the indicator will send the set of references to the Verse List in the Sidebar, where you can click them individually for reading in the Previewer.

# The Commentary Pane

## The Commentary Pane

Commentary Pane

The Commentary pane is where the commentary modules are displayed. This provides easy reading, reference, and access to different commentaries currently installed. The passage viewed by the Commentary pane is directly controlled by the current passage viewed in the Bible Text pane, so in order to change to a different passage commentary, select the desired passage on the Toolbar.

If there are images that are part of a commentary, general book, or dictionary/lexicon, they may be clicked to invoke a viewer on that single image, in order to get a better view. This is particularly useful if image resizing has been enabled with the result that images are made very small in the subwindow.

By changing to passage settings on the Toolbar, the contents in the Bible Text pane and the Commentary Pane will be changed.

## Finding Out About The Commentary Module

To find out about the commentary currently being displayed:

- right-click in the Commentary Pane. In the popup menu choose About module name.

## Commentary Headings.

Many commentaries have additional headings which enable introductory information about the book and chapter currently being displayed in the Bible Text pane. In order to view them:

- right-click in the Commentary Pane. In the popup menu choose Display Book Heading or Display Chapter Heading.

# Dictionary Pane

## The Dictionary Pane

The Dictionary Pane

The Dictionary Pane's content is driven by its up/down selectors, typing in its navbar text, or double-clicks in the Bible, Commentary, or Book Panes.

# Keyboard Shortcuts

Several keyboard shortcuts exist in GnomeSword:

- Ctrl-L focuses and selects the main verse navbar text. You can then immediately type in new verse selection text. Be aware that, as is the case with most Sword applications, GnomeSword understands many abbreviations: "G" is adequate to specify Genesis, for example, and any book name by itself implies 1:1.
- Ctrl-F opens the "Find" dialog for the Bible pane.
- Alt-C brings the Commentary View forward when previously obscured by the Book View.
- Alt-G is the opposite of Alt-C, focusing on the general book.
- Alt-B opens a bookmark dialog on the current verse.
- Alt-D focuses on the dictionary navbar text.
- Alt-P detaches/re-attaches the parallel view dialog.
- Alt-Z opens the personal commentary editor.
- Location bar navigation:
  - Ctrl-p/Ctrl-n: Verse previous/next.
  - p/n: Chapter previous/next.
  - P/N: Book previous/next.

# Version Differences in GnomeSword's Display

The GnomeSword interface has evolved over time, and there are two display libraries with which GnomeSword can be built. The older, less featureful version is called "gtkhtml3", and the newer, more capable version is called "MozEmbed". Both of these display libraries render text in a browser-like fashion, using HTML constructs to control display.

Several desirable capabilities are unsupportable in gtkhtml3, and although recent GnomeSword is written to take advantage of MozEmbed features, it is possible that the version running on your computer needed to be built with gtkhtml3 instead, either because the version of MozEmbed available for your system is not recent enough to support the needs of GnomeSword, or it simply doesn't exist for your system. (Notably, Cygwin has no MozEmbed at all.) The following differences will be apparent, depending on whether gtkhtml3 or MozEmbed is the underlying display engine:

- Morphology and Strong's references, enabled via the right-click menu in some modules, are displayed inline with gtkhtml3; with MozEmbed, a blocked display is used, where these references are aligned beneath the word to which they refer, for a much more readable, less cluttered display.
- Footnote and cross-reference markers (*n, *x) are displayed as proper superscripts in MozEmbed, but not in gtkhtml3.
- Links in gtkhtml3 are necessarily both colored and underlined; in MozEmbed, no underlines are needed.
- Under MozEmbed, double-space display is available using the View menu, but not under gtkhtml3.
- It is not possible for gtkhtml3 to interpret multiple font face directives in a single window, so the gtkhtml3 detached parallel view window cannot provide per-module font selections. Also, modules' internal font requests are ignored in any gtkhtml3 window.

Using the "About GnomeSword" selection under the Help menu, you will see the display library with which GnomeSword was built.

## Comparison, gtkhtml3 -vs- mozembed

Comparison, gtkhtml3 -vs- mozembed