Bible Text Plugin

Table of Contents

• Overview
• What It Adds
• How It Works
• Loading Local XML Bibles
• ESV API Key Setup
• Configuration

Overview

The Bible Text plugin searches and inserts scripture passages as formatted markdown slides.

What It Adds

• Passage search dialog in the builder
• Translation selection (local and online)
• Passage formatting with verse text and references
• Attribution lines for inserted scripture

How It Works

The plugin can read local bible data (*.local translations) and can also query online APIs. After fetching verses, it formats markdown and appends it to the selected presentation file.

Loading Local XML Bibles

To add local bible XML files:

1. In the app, open the Plugins menu.
2. Click Open Plugins Folder...
3. Open the bibletext plugin folder.
4. Copy your local bible .xml files into that plugin's bible storage folder.
5. Restart the app so the new local translations are detected.

Once loaded, local translations appear in the translation list with a .local id.

ESV API Key Setup

To enable direct ESV online access:

1. Go to esv.org and create/sign in to your account.
2. Visit the ESV API area and generate an API key.
3. Open REVELation app Settings.
4. Go to the Bible Text plugin settings.
5. Paste the key into esvApiKey.
6. Save settings.

After this, ESV becomes available as an online translation option in the Bible Text dialog.

Configuration

Key settings:

• defaultTranslation: default translation id
• bibleAPI: online API base URL (none disables online calls)
• esvApiKey: optional key for ESV API access

Documentation Hub

Back to Documentation Hub