Read Biblical texts in Emacs

diatheke is a front-end to the SWORD library. dtk facilitates reading a Biblical text, or other diatheke-accessible material, in Emacs.

1. Ensure that diatheke is installed. In Debian, it is available as the diatheke package.

2. Ensure that at least one text accessible as a diatheke module is installed. One way to do this is by using the 'module manager' of Xiphos. A number of texts are also available in Debian as packages (e.g., sword-text-kjv).

Prerequisites: Define the variables dtk-module-category (default: "Biblical Texts") and dtk-module (default: the first module returned by diatheke). These may be set interactively by calling dtk-select-module-category and dtk-select-module, respectively.

M-x dtk will create a dedicated buffer *dtk* and prompt for completion of book, chapter and verse. Corresponding text(s) will be inserted to *dtk* upon completion.

The *dtk* buffer enables dtk-mode and provides the following keybindings:

To insert Biblical text directly in any buffer, use M-x dtk-bible. Call with prefix argument (C-u) to temporarily change module when inserting text.

An example use-package configuration:

(use-package dtk
  :bind (("C-c B" . dtk-bible))
  :custom
  (dtk-default-module "KJV")
  (dtk-default-module-category "Biblical Texts")
  (dtk-word-wrap t)
  )

Some texts have dictionary references embedded in the texts. For these texts, dictionary lookups may be available. By default, S will, by invoking dtk-show-dict-entry, display the related dictionary entry, if that entry is available.

Search the selected text with M-x dtk-search.

Modules fall into a number of categories. Select the category of module which is under consideration with M-x dtk-select-module-category. By default, this functionality is bound to M.

Select the module of interest (e.g., KJV, ESV, or RNKJV) with M-x dtk-select-module. By default, this functionality is bound to m.

diatheke.el is another interface to diatheke.

sword-converter converts SWORD module content to JSON and SQLite. Provides search functionality.

sword-to-org converts SWORD modules content to org outlines.