insert-esv is an Emacs package for inserting ESV Bible passages.

Installation

insert-esv is available on MELPA. To install it, run M-x package-install RET insert-esv RET.

Alternatively, clone this repo and run M-x package-install-file RET </path/to/insert-esv.el> RET.

Usage

1. Grab an API key from Crossway.
2. Add the API key to your init file: (setq insert-esv-crossway-api-key "<token>").
3. Set a keybind in your init file: (global-set-key (kbd "C-x C-e") #'insert-esv-passage).
4. Once invoked, enter a Bible reference and hit RET to insert it at point.

Example configuration

You can include this use-package config in place of Steps 2 and 3. In addition, it contains suggested preferences for attribution, headings, and line length.

(use-package
  insert-esv
  :init
  (setq insert-esv-crossway-api-key "<token>")
  (setq insert-esv-include-short-copyright 'true)
  (setq insert-esv-include-headings 'true)
  (setq insert-esv-include-passage-horizontal-lines 'false)
  (setq insert-esv-line-length '50)
  :bind ("C-x C-e" . insert-esv-passage))

Options

• This package contains support for the optional parameters in Crossway’s Passage Text API.
• You can customise these parameters in your init file.
• Make sure to prefix each parameter with the package name: (setq insert-esv-include-headings 'true).

Disclaimer

• insert-esv is licensed under GPLv3 and copyright sam030820 and contributors.
• Scripture quotations are from the ESV® Bible, copyright © 2001 by Crossway, a publishing ministry of Good News Publishers.