This plugin loads the biblical text into memory from an SQLite database and then manages it through its graphical interface, allowing you to read a book of the Bible by chapter.
Go to the NVDA menu, Tools submenu and select BibleAddon, NVDA will say "loading the Bible". Once the plugin is loaded, you will be positioned in a read-only multi-line text box containing the chapter verses of the selected book. The first time you load this add-on, you will start at the book of Genesis chapter 1, then the next time it will start at the chapter of the book where you left off before exiting the add-on.
Note: Initially this plugin does not have a key combination assigned to call it, to assign one of these, go to the NVDA menu Preferences submenu and select Input Gestures.
Using the up or down arrow keys, NVDA will read the verses of the currently selected book chapter. If you press the Tab key once, you will move to the "Next" button. Pressing this button advances one chapter in the selected book and returns you to the Bible text. If you press Tab again, you will now be at the "Previous" button. Pressing this button goes back one chapter in the selected book and returns you to the Bible text. If you press Tab again, you will be at the "Exit" button, which, when pressed, will close the add-on.
While in the Bible text reading box, you can use the following keyboard shortcuts:
While in the verse reading text box, if you want to go to a particular chapter of the current book, press the "Shift" key plus "Tab" and then type a valid chapter number. And in general, you can move around the entire graphical interface with tab or shift plus tab.
It is rectangular in shape, wider than it is tall, it has 3 sections organized as header, main and footer, that is, one below the other, and within each section its components are organized horizontally. The first section contains the following objects:
These objects make up the search bar for the book to read.
The second section contains only a read-only multiline text box that takes up the entire available width, with all the verses that correspond to the selected book.
The third section contains the following objects:
For now, the plugin manages Protestant Christian Bibles that contain 66 books, unlike Catholic Christian Bibles that are made up of 72 books.
The biblical text is stored in a SQLite database file which contains 2 tables, one called Bible and another called Details, in the Bible table there are all the verses that a 66-book Bible contains, each verse is a record in the table, while in the Details table there is only one record with additional information about that version of the Bible.
With SQLite3 from cmd you can manage the file with the bbl extension with all the commands that this database manager offers you. Always take the precaution of backing up your bbl file before manipulating it from this manager.
It is worth mentioning that the text or verses are stored together with special characters that give it RTF format. For accessibility reasons, a wx widget that supported this format was not used, so before placing the text in the text box for reading, it is processed to eliminate all RTF format as much as possible.
This plugin can read a Bible as long as the SQLite database file name has a bbl extension and the database schema is correct. It comes by default with The Bible "New Living Translation" whose file name is NTV.bbl. To load a different version you must go to where the plugin is stored, this is in ..\AppData\Roaming\nvda\addons\BibleAddon\globalPlugins\BibleAddon Back up the NTV.bbl file and then copy to that path the bbl file that contains the version of the Bible you want to read, then restart NVDA, when you open the BibleAddon it should load the new Bible.
You can access the source code of this plugin by doing click here.