Skip to content

GUI

Jump to bottom
Zoltán Kovács edited this page Dec 10, 2025 · 21 revisions

Since March 2024 bibref comes with a graphical user interface that is based on Qt. It is currently available in English, German and Hungarian.

There are multiple platforms provided, available on the project's Releases page:

These versions work almost identically, except that the offline web application restricts file operations inside the browser's local storage, and it does not provide some decorations in the menus.

The main application window

The main application window

The main window consists of four parts (from top to bottom):

  • The main menu
  • The clipboards
  • The output window
  • The status row

An explanation of the options of the main menu can be found below.

The two clipboards play an important role in the program. They can contain shorter or longer Greek texts, without punctuation, spaces and diacritics. For simplicity (for non-researchers), the clipboards are displayed also with Latin characters. An automated comparison based on the Jaccard distance is immediately computed.

The output window shows the output of the commands that can be called from the menu system.

The status row gives some immediate feedback by the program on certain user interactions.

The main menu

The main menu consists of several menus.

File menu

  • Add books: In most cases, this is the first action to be taken in the program, to make it possible to work with most of the commands. See also addbooks.
  • Quit: Exit the application. See also quit. (This option is not present in the offline web application. Instead, the application can be stopped by closing the window or tab in the browser.)

Edit menu

  • Text 1...: Put a Greek text in clipboard 1. See also textN.
  • Text 2...: Put a Greek text in clipboard 2. See also textN.
  • Latin text 1...: Put a Latin text in clipboard 1. See also latintextN.
  • Latin text 2...: Put a Latin text in clipboard 2. See also latintextN.
  • Nearest 12: Search for a subtext of clipboard 1 that is the closest possible text to the one in clipboard 2. See also nearest12.
  • Find 1...: Search for the text given in clipboard 1 in a Bible edition. See also findN.
  • Find 2...: Search for the text given in clipboard 2 in a Bible edition. See also findN.
  • Search...: Search for a set of tokens on a maximal length in a Bible edition. See also search.
  • Preferences...: Set application preferences like the language, the font size used in the application, debug mode in statement analysis, show diagrams as HTML/SVG, using a Koine Greek font when possible, show Greek tooltips in the visual diagrams, or limit the shown amount of characters in the clipboards. Preferences are saved in a dedicated folder as described in the Qt documentation.

Passage menu

  • Lookup...: Search for a verse in a book in the given Bible edition. See also lookup.
  • Lookup 1...: Search for a verse in a book in the given Bible edition and put it in clipboard 1. See also lookupN.
  • Lookup 2...: Search for a verse in a book in the given Bible edition and put it in clipboard 2. See also lookupN.
  • Tokens...: Search for a tokenized verse in a book in the given Bible edition. See also tokens.

Quotation menu

  • Min. unique 1...: Search for minimal unique passages in clipboard 1 in a Bible edition. See also minunique1.
  • Extend...: Extend the passage to the longest possible quotation from another Bible edition. See also extend.
  • Get refs...: Search for references on a passage in another Bible edition. See also getrefs.
  • Statement...: Start the Statement Editor in another window.

Raw menu

  • Raw...: Show the a-z transcription of a positioned text in a given book. See also raw.
  • Raw 1...: Put the a-z transcription of a positioned text in a given book in clipboard 1. See also rawN.
  • Raw 2...: Put the a-z transcription of a positioned text in a given book in clipboard 2. See also rawN.

Help menu

  • About bibref...: Show a short description of the program. On Linux and Windows, the version number of the GUI is also shown.
  • Quick tutorial...: Show the Quick tutorial.
  • Show available Bibles...: Give a list of the Bible modules that are currently available via the SWORD library. All of these modules can be queried via the lookup command, but only a few (namely: LXX, SBLGNT and StatResGNT) can be searched via the rest of the commands.
  • Start bibref in a web terminal...: Open the default web browser and navigate to an online version of bibref. Note that this may take a couple of seconds, depending on your browser and your operating system.
  • About SWORD...: Show the version of the SWORD library being used by bibref.
  • About Qt...: Show the version of the Qt framework being used by bibref.
  • **Technical information...*: Show additional information on the underlying libraries being used in bibref.

The Statement Editor

image

The Statement Editor window consists of three parts (from top to bottom):

  • The statement menu
  • The editor area
  • The status row

An explanation of the options of the statement menu can be found below.

The editor area shows the currently edited statement with syntax highlighting. Basic text editing features are supported with simple text search (by pressing Ctrl-F, F3 or Shift-F3 on most operating systems, or their counterparts, accordingly).

The status row shows the current row and column position of the cursor (Row and Col).

The statement menu

File menu

  • New: The editor area is cleared. Note that the text in the area cannot be recovered.
  • Open...: Open a statement from file. Currently, two folders are provided: the SBLGNT and StatResGNT folders. They contain statements in correspondence with the given Bible edition and the LXX module.
  • Save As...: Save the edited statement to a file.

Prove menu

  • Parse: Parse the statement in the editor area, open a popup dialog window, and give a short summary of the number successful checks of the line-by-line analysis, and also give the number of warnings and errors.
image

If there are no errors, the following options are shown:

  • Visualize: Show a visual diagram of the statement in a separate window:
image

  • Export graph: Open a new page in the default web browser and use an online GraphViz service to show the exported GraphViz code and its graphical output. Note that this export gives more details about the sentence (unless HTML/SVG diagrams are enabled), because the diagram in the Visualize window cannot show the contents of the displayed fragments (only their lengths are shown).

  • Show Details...: Extend the dialog window and show a quick overview of the line-by-line analysis by providing its full output. image

    The analysis can be hidden by choosing Hide Details....

  • Back to Editor: Close the popup dialog window.

  • Analyse: Open a window that shows a detailed view of the line-by-line analysis of the statement:

    image

    The view shows the information in columns. When a message is hovered with the mouse, a detailed description will be shown. When clicking on the > button, the cursor will be moved to the corresponding character in the Statement Editor and the full row before it will be selected.

Help menu

  • Blog entry: Show some help on a new page in the default web browser.

Clone this wiki locally