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

https://img.shields.io/github/workflow/status/sam030820/insert-esv/check.svg https://melpa.org/packages/insert-esv-badge.svg https://img.shields.io/badge/license-GPL_v3-green.svg

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.

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.

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))

• 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).

• 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.