Skip to content

Latest commit

 

History

History
33 lines (26 loc) · 2.62 KB

README.md

File metadata and controls

33 lines (26 loc) · 2.62 KB

Bible Linker for Google Docs

A Google Documents Apps Script and Add-on that searches for Bible verses and converts them to links. Choose from a selection of online Bible sources.

How to use

As an add-on

  1. Install the Bible Linker add-on from Google Marketplace.
    For those who installed Bible Linker via Google Marketplace before April 12, 2023, you will need to reinstall the add-on as v2 required an additional permission to make Bible Linker modular.
  2. In your Google Document, find the add-on under Extensions > Bible Linker. (For those using Google Workspace accounts, the add-on may be found under Add-ons > Bible Linker.)

As a stand-alone script

  1. In your Google Document, click Extensions > Apps Script.
  2. In the page that will open, copy and paste the contents of Code.gs.
  3. Save. You may now close the Apps Script window and refresh your document.
  4. Find Bible Linker in the top-level Menu. Enjoy!

Tip: If there is no selected text, Bible Linker will process the whole document. If you highlighted a selection, it will only create links in that selected portion of the document.

Improving the script

Coders are welcome to improve the script. It's open source. MIT license.

Things that could be worked on:

  • Find and fix bugs
  • Support for other languages Done in v2!
  • Support for more online Bibles Done in v2!
  • Check if Bible reference (chapter and verse) is valid Done in v2!
  • Apply books exclusions, where some books are not available for a specific Bible version Done in v2!
  • Add new languages by creating JSON files.
    For samples of valid JSON files, see the bible-data directory.
    Testing of new JSON files can be done via the menu Extensions > Bible Linker > Choose language (data source) > Set custom data source ...

Other copyrights

The Bibles and languages initially supported came from versions listed in jw.org and Watchtower Online Library. The Terms of Use of these websites do not allow the sharing of their contents. However, it allows linking to these websites, which is what this script does.