LDS Library Reference

approved

by Paco Kwon, Stein Ingebretsen

Forked from LDS Scriptures Reference

Easily insert references to scriptures and conference talks from the Church of Jesus Christ of Latterday Saints.

★ 6 stars↓ 352 downloadsUpdated 1y agoMIT
View on GitHub

LDS Library Reference Plugin for Obsidian

Easily insert your favorite scripture verses and selections from General Conference talks into Obsidian!

demo

Table of Contents

Quickstart

Requirements

You only need Obsidian installed!

Installation

Community Plugin

This plugin can be found from the list of community plugins for Obsidian. Open Obsidian's Settings -> Community Plugins, and click Browse to search this plugin's name and install.

Manual Installation

The plugin can also be manually installed by:

  1. Creating a directory called lds-library-plugin under .obsidian/plugins/ within your vault.
  2. From this plugin's Releases Page, download and put main.js, manifest.json, styles.css into .obsidian/plugins/lds-library-reference/.
  3. Reload Obsidian and navigate to the Community Plugins tab to see that installation is successful.
  4. Ensure the plugin is then enabled.

Features

Multiple Scripture Support

The standard works, or the volumes of scripture officially accepted by the Church of Jesus Christ of Latter-day Saints are available.

  • Holy Bible (King James Version)
  • Book of Mormon
  • Doctrine and Covenants
  • Pearl of Great Price

How To Reference Verses

Insert a callout to a verse using either :<Book Name> <Chapter Number>:<Verse Numbers>: or :<Book Name> <Chapter Number> <Verse Numbers>:.

You can referece any range, selection, or series of verses from a given chapter using the above syntax.

Obsidian won’t recognize your desired reference until you add a : at the end. Each reference must be on its own line.

Only English book titles are recognized. For example :1 Nephi 1 1: is recognized, but :1 Нефи 1:1: isn't.

Refer to BOOKS.md for the complete list of book names used and recognized in this plugin.

Example:

Verse Completion

Inserted Callout Example:

Verse Callout

General Conference Support

How To Quote General Conference

Get started with inserting a General Conference quote using :<Month Name> <Year Number>:, which will open a Conference Picker prompt.

Conference Talk Picker Prompt

After accepting the suggestion, one can search for and choose a talk from that conference.

Conference Talk Picker

Choose the paragraphs you would like to quote by clicking on them individually, and press Create Link to insert the quote in a callout.

Paragraph PickerCreate LinkConference Talk Callout

Multiple Language Support

Default Language

The default language used for scriptures and conference talks can be set in the Settings tab of the plugin.

Settings

One-time Language Syntax

For both verses and conference quotes, optionally specify the language for the reference by appending [<lang>] at the front. If the language isn't specified, the default language will be used.

Language VerseLanguage Verse Callout
Language ConferenceLanguage Conference Callout

<lang> is 3 letter shortcode for each individual languages used by the Church website. You can refer to these shortcodes in the Settings tab of the plugin.

Development

Build

Install dependencies:

yarn

Run build script:

yarn build

3 files will be created in the root directory: main.js, manifest.json, styles.css

Versioning

This plugin follows semver.

To publish a new release, tag it with git tag -a <major.minor.patch> -m <message>

For plugin developers

Search results and similarity scores are powered by semantic analysis of your plugin's README. If your plugin isn't appearing for searches you'd expect, try updating your README to clearly describe your plugin's purpose, features, and use cases.