An explanation of the areas shown in the Xiphos window.

#

# Xiphos

Andy Piper
Pierre Benz
Dr Peter von Kaehne
Karl Kleinpaste
Matthew Talbert

# Xiphos Main Window

# خط فرمان

At the top of the Xiphos 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.

# ستون‏فرمان

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.کاربرد ستون ابزار اینست که کنترل‏های مربویط به چارچوب‏های کتاب‏مقدس و تفسیر را فراهم نماید. با حرکت دادن نشانگر ماوس بر روی دکمۀ ابزار مورد نظرتان و انتخاب آن، این گزینه فعال خواهد شد. اگر نشانگر ماوس را برای چند لحظه بر روی ابزار نگاه دارید، یک راهنمای کوچک باز خواهد شد که کاربرد آن کلید را توضیح خواهد داد.

The Toolbar consists of the following functions:

تاریخچه مرور انتخاب و لیست

انتخاب بخشی از کتاب‏مقدس

انتخاب فصلی از کتاب‏مقدس

انتخاب آیه‏ای از کتاب‏مقدس

خلاصۀ بخش بخصوصی از کتاب‏مقدس

## انتخاب کردن تاریخچۀ پیشین/پسین

حرکت بین قسمت برگزیده شدۀ فعلی و پیشین.

## انتخاب بخشی از کتاب‏مقدس

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

## انتخاب فصلی از کتاب‏مقدس

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

## انتخاب آیه‏ای از کتاب‏مقدس

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

## خلاصۀ بخش بخصوصی از کتاب‏مقدس

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

لطفا اطمینان حاصل کنید که کتاب، فصل، و یا آیه‏ای که آنرا ویرایش کرده‏اید به درستی نامگذاری شده است، در غیر اینصورت اطلاعات اشتباه نمایش داده خواهد شد.

# ابزار جانبی

On the left hand side of Xiphos there is the Sidebar. Here the user can switch between the different Sword modules, view bookmarks, do simple searches and view verse lists. In the Modules listing, a module may be chosen for viewing in the current tab of the main window by clicking it. Using the context (right-click) menu, other options are to open a new tab using the module, open a separate (i.e. detached) window, or to view the "About" information for the module.

To switch between all Sidebar functions, buttons have been placed at the top of the Sidebar.

# چارچوب متن کتاب‏مقدس

Positioned to the right of the Shortcut bar is the Bible text pane. All translations are displayed here. When starting Xiphos, the translation last used in the leftmost tab will be displayed.

## باز کردن ترجمۀ خاصی از کتاب‏مقدس

به منظور تعویض ترجمۀ فعلی کتاب‏مقدس به یکی دیگر از ترجمه‏ها:

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

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

## استفاده از کاربرد موازی

A nice function in Xiphos is the ability to view your specified bible text in several 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.

You must choose which modules to display in parallel with the Preferences dialog found under the Edit menu. In the dialog, choose Modules, then Parallel. You can add or subtract from the list of modules that will be shown in the parallel view. The toolbar gives you a selector tool to erase the list, delete a module from the list, and add modules to the list.

The Parallel View shows just 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 (e.g. Westminster Leningrad Codex, Byzantine Majority Text) will not be able to display books that they don't have.

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, showing the same translations.

Be aware that Bibles have different versification schemes. That is, most obviously some Bibles have only Old or New Testament. Beyond that, there are historically varying ways of dividing the Bible into chapters and verses. Within the parallel view, the first Bible controls what versification is in use for all Bibles displayed. This means that if the 1st Bible is limited to the Old Testament, none of the other Bibles in parallel views will be able to navigate outisde the OT. There are other subtler differences, such as KJV versification versus NRSV versification, where 3 John has a 15th verse and Revelation 12 has an 18th verse.

## ترجمۀ دیگری از کتاب‏مقدس را باز می‏کند

In order to view a Bible translation separate from the Xiphos main window interface, under the Modules option in the Sidebar, choose Biblical Texts language choice. Then right-click on a translation and choose Open in dialog. The module will open in a separate, detached window of its own.

Detached Bible and commentary windows have a synchronization button in the upper-left position beside the navigation bar. When this button is depressed, the main window Bible and commentary will synchronize with detached Bible and commentary windows. The synchronization goes both ways: Any detached window will synchronize navigation with all other detached Bibles and commentaries plus the main window, and the main window will drive all detached Bibles and commentaries whose synchronization button is depressed.

## 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 Texts language choice . Then right-click on a translation and choose the About option.

## گزینه‏های مدول

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

کلمات عیسی مسیح به رنگ قرمز

شماره‏های کشف‏الآیات استرانگ

علائم واژه‏شناسی

پانویس‏ها

ارجاعات به کتاب‏مقدس

سر تیترها

محتویات تصویر

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

به منظور دستیابی به این گزینه‏ها:

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

## گزینه‏های مرور

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

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:

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

Read Aloud - If you enable this, then Xiphos 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.

## Display Control with CSS

Users familiar with CSS (cascading style sheets) may wish to create the file "default-style.css" in the .xiphos directory to contain whatever CSS controls are desired. Beware, it is very easy to shoot oneself in the foot with CSS, and this will affect all modules' display. The facility exists to provide the capability that advanced users may wish.

## User Annotation

Many users wish to make personal annotations on individual verses, without the need to put a full "personal commentary" module to use. Xiphos provides this in the right-click context menu in the Bible pane. This brings up a dialog showing the current verse reference and offering a text box into which to enter a brief personal note. Once the user closes the dialog with "Annotate Verse," the verse will be displayed in reverse-highlight (default, blue on yellow) and a marker *u will be inserted at the verse's beginning. This is metaphorically similar for users who mark verses in paper Bibles with a yellow highlighter and write personal notes in the margins.

Selecting an already-annotated verse will (in the usual case) bring up the existing content for re-editing. An already-annotated verse can be unmarked; the verse will cease to show in reverse-highlight.

If the user deletes the module name from the reference at the top of the dialog, then the annotation will apply to any Bible module at the selected verse. However, in this case, re-selecting the annotated verse will not initialize with the existing content, because the dialog is created based on the specific module reference.

## Geography Support

A connection to browsing BibleMap.org is available by mouse-selecting a place name in any text. Use the right-click context menu to select Lookup Selection Browse in BibleMap.org . A web browser will be brought up to show the selected name's geography via BibleMap, which provides Biblical detail overlaid on a Google Maps interface.

## 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 dialog will appear, which provides text searches. Fill out dialog and click the Find and Find Next buttons.

# پیش‏نگر

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 displayed in the Previewer when you hover over the indicator *n in the Bible text; it remains visible until your mouse moves over another indicator, Strong's number, etc. Sometimes you may want the text to remain anchored until you can move the mouse to the previewer to click on a link or to read large footnotes. To anchor the text so that you can scroll it in the Previewer, middle-click the indicator (or hold down the Shift key) and move to the Previewer.

Cross-reference indicators *x work much the same way. 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. Alternately, a Preferences selector is available, so that cross-reference lists are sent to the verse list instead.

Any verses shown in reverse-highlight have personal annotation associated with them, and such verses will include *u at the beginning of the verse. Hovering on this marker will show the annotation in the previewer, just as for publisher's footnotes.

If a devotional has been set via the Preferences dialog, then the day's devotional reference will also appear in the previewer, either on program startup or when the user requests it via the View menu.

# The 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's content is driven by its up/down selectors, typing in its navbar text, or double-clicks in the Bible, Commentary, or Book Panes.