Versedrop

by Paul Hong
5
4
3
2
1
Score: 50/100

Description

Reviews

No reviews yet.

Stats

1
stars
272
downloads
0
forks
28
days
0
days
0
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
24
commits

Latest Version

a day ago

Changelog

  • New Interface language option (Settings → General): Same as Obsidian, 한국어, English, 简体中文 or 繁體中文. The settings page switches right away; command names in the command palette follow after Obsidian restarts.

README file from

Github

Versedrop

Search a Bible reference and drop the passage into your note — from free translations in English, Korean, German, French, Spanish, Portuguese, Chinese, Japanese, Greek, Hebrew and 1,000+ other languages.

성경 구절을 검색해서 노트에 바로 넣어 주는 Obsidian 플러그인입니다. 영어·한국어는 물론 독일어·프랑스어·스페인어·중국어·헬라어·히브리어 등 1,000개가 넘는 언어의 무료 역본을 골라서, 또는 여러 역본을 함께 넣을 수 있어요.

English · 한국어 · 中文

> [!quote] 요한복음 3:16 (개역한글)
> ¹⁶하나님이 세상을 이처럼 사랑하사 독생자를 주셨으니 이는 저를 믿는 자마다 멸망치 않고 영생을 얻게 하려 하심이니라

> [!quote] John 3:16 (KJV) · [Logos](https://ref.ly/John3.16) · [Accordance](accord://read/John_3:16)
> ¹⁶For God so loved the world, that he gave his only begotten Son, that whosoever believeth in him should not perish, but have everlasting life.

English

Contents

  1. Features
  2. Installation
  3. Quick start
  4. Writing references
  5. The search window
  6. Inserting from a reference in your note
  7. Hotkeys and presets
  8. Translations
  9. NET, NIV and ESV
  10. Using your Accordance modules (Mac)
  11. 개역개정 and other Korean Bible Society translations
  12. Logos and Accordance links
  13. Adding other translations
  14. Copyright notices and quotation limits
  15. Output settings
  16. Troubleshooting
  17. Network and system access

Features

  • Type a reference in English, Korean, Chinese, Japanese — or with the book names of any translation you add (Johannes 3:16, Juan 3:16, Jean 3:16)
  • Single verses, ranges, whole chapters and passages that cross chapters — 1 Cor 13:4-7, Ps 23, John 3:16-4:3, Gen 1-2
  • Translations in 1,000+ languages: English, Korean, German, French, Spanish, Portuguese, Chinese, Japanese, Greek, Hebrew and many more — pick languages with one click and compare translations side by side
  • Tick the translations you want and insert them in one go; your picks are remembered
  • Hotkeys and presets: set hotkeys right from the plugin settings, insert without opening a window, and save translation sets (e.g. Original languages) as their own commands
  • NET from its official API and ESV with no key, alongside public-domain KJV, WEB, BSB and more; NIV and other licensed translations through your Accordance modules
  • Accordance (Mac): pull text from Bible modules you own in Accordance — 개역개정, NIV, NASB and more
  • Copyright notices added automatically for copyrighted translations, plus a warning for long quotations
  • Logos & Accordance links: each passage can link straight to the same passage in your Bible software
  • Add any language from HelloAO: browse free translations by language (German, French, Spanish, Portuguese, Russian, Italian, Dutch, Latin …) and add them with one click — their own book names and copyright notices come along, and you can type references with those book names (Johannes 3:16, Juan 3:16)
  • Backup source: if bolls.life is unreachable, built-in public-domain texts (KJV, WEB, BSB …) are fetched from HelloAO instead
  • Add any translation from bolls.life by code, or from a JSON file in your vault
  • Callout, blockquote or plain text output, with options for verse numbers, line breaks and bilingual grouping
  • Interface and built-in help in English, Korean and Chinese (simplified and traditional) — follows Obsidian's language, or pick one under Settings → General → Interface language

Installation

Requires Obsidian 1.13 or later.

From Community plugins (once listed): Settings → Community plugins → Browse → search Versedrop → Install → Enable.

Manually:

  1. Download main.js, manifest.json and styles.css from the latest release.
  2. Create the folder <your vault>/.obsidian/plugins/versedrop/ and put the three files in it. On macOS, .obsidian is hidden — press Cmd+Shift+. in Finder to show it.
  3. Restart Obsidian (or reload plugins in Settings → Community plugins).
  4. Enable Versedrop in Settings → Community plugins. If this is your first community plugin, turn off Restricted mode first.

Recommended: assign a hotkey — Settings → Versedrop → More → Hotkeys and presets → Set hotkey (see Hotkeys and presets).

Quick start

  1. Put your cursor where the passage should go.
  2. Press your hotkey (or run Search and insert Bible passage from the command palette, Cmd/Ctrl+P).
  3. Type John 3:16 and press Enter.
  4. Tick the translations you want.
  5. Press Cmd/Ctrl+Enter or click Insert.

Writing references

English, Korean, Chinese (simplified or traditional) and Japanese book names, full or abbreviated, are all understood — plus the book names of every translation you add from HelloAO (German, French, Spanish …). Spaces are optional.

What you want Examples
One verse John 3:16 · Jn 3.16 · 요 3:16 · 요3:16
A range 1 Cor 13:4-7 · 고전 13:4-7 · 요 3장 16~18절
Several parts of a chapter Rom 8:28, 31-39 · 롬 8:28, 31-39
A whole chapter Ps 23 · 시 23 · 시편 23편
Across chapters John 3:16-4:3 · 1 Cor 12:31-13:13 · 요 3:16-4:3 · 요한복음 3장 16절-4장 3절
Several whole chapters Gen 1-2 · 창 1-2 · 창 1-2장
Other languages (HelloAO) Johannes 3:16 (German) · Jean 3:16 (French) · Juan 3:16 (Spanish)
Deuterocanon Tob 3:1 · Sir 1:1 · 1 Macc 2:3 · 토비트 3:1 · 집회 1:1 · 마카상 2:3
Korean long form 요한복음 3장 16절
Chinese 约翰福音 3:16 · 約翰福音3章16節 · 约3:16 · 林前13:4-7
Japanese ヨハネによる福音書 3:16 · ヨハ3章16節 · 1コリ13:4-7

Book abbreviations follow common usage: English SBL-style (Gen, Exod, 1 Sam, Phil, Phlm, Rev) and the Korean Bible Society style (창, 출, 삼상, 빌, 몬, 계). Full names like Philippians or 빌립보서 also work.

A reference can cover up to 10 chapters (each chapter is a separate download). When a passage crosses chapters, the new chapter is marked in the text — 4:1 with plain verse numbers, or a bold 4 before the verse number otherwise. A range past the end of a book stops at its last chapter (Phil 3-9 → Philippians 3–4).

The search window

  • Search box — type a reference and press Enter.
  • Translation cards — one card for each translation in Insert these (Settings), ticked and in that order. Untick a card to leave it out this time.
  • Other translations — the rest of My translations stay folded here and load only when you open it, with language chips (English, Korean, German, Greek …) to narrow the list. Ticking one adds it to this insertion only; your defaults change only in settings.
  • Greek texts contain only the New Testament and Hebrew WLC only the Old Testament. If none of your translations to insert has the book, the other translations open automatically.
  • Insert — inserts every ticked card that loaded successfully. Shortcut: Cmd/Ctrl+Enter.
  • Insert right away — set Search window → After finding a passage to Insert right away to skip the preview: Enter inserts your translations to insert immediately.

Cards load independently, so a slow or failing translation never blocks the others. If a card shows an error, the message explains what to do.

Inserting from a reference in your note

Already wrote Titus 2:11-14 in your sermon notes? Put the cursor on that line (or select the reference) and press your hotkey. The search runs automatically, and the passage is inserted below that line, leaving your reference in place. This makes it easy to write an outline with references first and fill in the text later. A line counts as a reference when it contains only the reference (a leading -, * or > is fine).

Hotkeys and presets

Settings → Versedrop → More → Hotkeys and presets lists every Versedrop command with its current hotkey. Set hotkey opens Obsidian's Hotkeys screen filtered to Versedrop: click + next to the command and press the keys you want.

Command What it does
Search and insert Bible passage Opens the search window (pre-filled when the cursor is on a reference)
Insert in default translations (no window) Inserts the reference at the cursor in your translations to insert straight away — the fastest way to fill an outline. Opens the search window if there is no reference.
Preset: … One command per preset (see below)

Presets are named sets of translations you use together — for example Korean–English (개역한글 + KJV) or Original languages (SBLGNT + WLC). Click Add preset, name it, and click the translation chips to include. Each preset becomes its own command, so it can have its own hotkey:

  • on a reference → inserts it in the preset's translations right away;
  • anywhere else → opens the search window with the preset's translations selected (your normal defaults are left unchanged).

Suggested setup: Cmd+Shift+B for the search window, Cmd+Shift+V for "no window", and Cmd+Shift+G for an Original languages preset. (Check that the keys aren't already used — the Hotkeys screen warns you about conflicts.)

Translations

Language Translation Source Status On by default
Korean 개역한글 (KRV, 1961) bolls.life Copyright term expired ✓
Korean 새번역 (RNKSV) bolls.life © Korean Bible Society — personal study only —
English King James Version (KJV) bolls.life Public domain ✓
English World English Bible (WEB) bolls.life Public domain —
English Berean Standard Bible (BSB) bolls.life Public domain ✓
English English Standard Version (ESV) bolls.life © Crossway — no key needed, personal study —
English New English Translation (NET) NET Bible API © Biblical Studies Press — free quotation with notice ✓
English American Standard Version (ASV) bolls.life Public domain —
English Young's Literal Translation (YLT) bolls.life Public domain —
English Literal Standard Version (LSV) bolls.life CC BY-SA 4.0 —
English Geneva Bible 1599 (GNV) bolls.life Public domain —
English Douay-Rheims (DRB) bolls.life Public domain —
Chinese 和合本(简体) (CUV, 1919, simplified) bolls.life, converted on your device Public domain —
Chinese 和合本 (CUV, 1919, traditional) bolls.life Public domain —
Japanese 口語訳 (1954/55) bolls.life Out of copyright in Japan —
Greek SBL Greek New Testament (SBLGNT) bolls.life © 2010 SBL & Logos — free with attribution · NT —
Greek Textus Receptus (Elzevir 1624) bolls.life Public domain · NT —
Greek Tischendorf 8th ed. bolls.life Public domain · NT —
Hebrew Westminster Leningrad Codex (WLC) bolls.life Public domain · OT —
Hebrew WLC with accents bolls.life Public domain · OT —
Hebrew Delitzsch Hebrew NT (1877) bolls.life Public domain · NT —

Chinese, Japanese, Greek and Hebrew

Add them from the Add a translation (+) menu (each language has its own group), and a chip for that language appears in the search window.

  • 和合本(简体) is the public-domain 1919 和合本 with its characters converted from traditional to simplified on your device (OpenCC); the wording is unchanged.
  • Book names in headers follow the language: 约翰福音 3:16 (和合本(简体)), 約翰福音 3:16 (traditional, 和合本), ヨハネによる福音書 3:16 (口語訳). Greek and Hebrew texts use English book names, as in academic writing.
  • Hebrew cards are shown right-to-left. Hebrew versification sometimes differs from English Bibles (e.g. psalm titles counted as verse 1, Malachi 4 = Malachi 3:19–24), so check the verse number if a Hebrew card looks off by one.
  • SBLGNT always gets its required notice.
  • Copyrighted editions — 新标点和合本, 和合本修订版, 新译本, 当代译本, 中文标准译本, 现代中文译本, 吕振中译本, 新共同訳, 新改訳, NA28, UBS5, Rahlfs LXX, BHS — are not built in. If you own them in Accordance, add them as Accordance modules; Versedrop recognises them and adds the right copyright notice. (They can also be added by bolls.life code at your own discretion, e.g. CUNPS, JPNICT.)

Deuterocanonical books

Tobit, Judith, Wisdom, Sirach, Baruch, 1–2 Maccabees and the Greek additions to Esther and Daniel can be searched in translations that contain them: JSON files (e.g. 공동번역), HelloAO translations and Accordance modules (e.g. NRSV with Apocrypha).

Book Korean (공동번역 · 가톨릭 성경) English
Tobit 토비트 · 토빗 (토비) Tobit (Tob)
Judith 유딧 (유딧) Judith (Jdt)
Additions to Esther 에스델 부록 (에스부) Add Esth
Wisdom 지혜서 (지혜) Wisdom of Solomon (Wis)
Sirach 집회서 (집회) Sirach (Sir), Ecclesiasticus
Baruch 바룩 (바룩) Baruch (Bar)
Additions to Daniel 다니엘 부록 (단부) Add Dan
1–2 Maccabees 마카베오상·하 (마카상, 마카하, 1마카) 1–2 Maccabees (1 Macc)
  • JSON files are checked when you load them; Accordance modules when you click Test (it tries Tobit 1:1). For HelloAO translations added before 0.7.5, or anything detected wrongly, use the Includes the deuterocanon switch in the translation's editor.
  • Built-in bolls.life translations don't include these books.
  • In Bibles that keep the Greek additions as separate books (공동번역 1977), 단 13 (Susanna) and 단 14 fall back to Additions to Daniel, and Esther chapters 11–16 to Additions to Esther.

Choosing your translations

The settings page is short on purpose: what you insert and how the search window behaves are on the first screen, and everything else is one click away under More — My translations, How passages look (with a live preview), Hotkeys and presets, Logos · Accordance links and Help.

The first screen:

  • Insert these — the translations inserted when you find a passage, in this order. Drag to reorder, delete to take one out, + to add one from My translations.

  • My translations (under More) — every translation you use, each with one short line (language · where it comes from). Translations not in Insert these still appear under Other translations in the search window. A new install starts with 개역한글, KJV, BSB and NET.

  • Add a translation — click + in the list header and pick one. The menu is grouped by language, with Add your own (Accordance module, bolls.life code, JSON file) at the end.

  • drag — change the order in this list

  • ✎ — edit a translation you added yourself (name, code/module/path, language, copyright notice)

  • delete — remove it from the list (built-ins can be added back from the + menu any time)

Translations such as 개역개정, 공동번역, NIV or NASB have no free source. You can still use them through your Accordance modules or a JSON file you are licensed to use.

NET, NIV and ESV

NET comes from the official NET Bible API and needs no key. As its terms ask, "NET" in the header links to netbible.org and the copyright notice is always added.

ESV is in the + menu (English) and works without a key: the text comes from bolls.life, like 새번역. It is © Crossway, so it is off by default, the copyright notice is added under every quotation, and it is meant for personal study and sermon preparation.

NIV is licensed by Biblica and is not built in. The ways to use it:

  • Accordance — if you own the NIV module, add it as an Accordance module (e.g. NIV11). The text stays on your Mac and the right copyright notice is added automatically.
  • Logos links — set Logos version to NIV so the link beside each passage opens it in the NIV.

Using your Accordance modules (Mac)

If you own Bible modules in Accordance, Versedrop can fetch text from them directly — nothing else to install. Text travels only between Accordance and Obsidian on your Mac and is never sent over the internet, so you stay within your own license.

Requirements: macOS, the Obsidian desktop app, and Accordance with the modules installed. (Not available on Windows, Linux, iOS or Android.)

Setup:

  1. Settings → Versedrop → More → My translations → + → Add an Accordance module… (Mac).
  2. Enter:
    • Name — what you want to see, e.g. ESV or 개역개정.
    • Accordance module — exactly as Accordance shows it in the Library or a text tab (case and hyphens matter), e.g. ESVS.
    • Language — which language chip it appears under.
  3. Click Test connection. Versedrop asks Accordance for an OT and an NT verse (Genesis 1 and John) and sets Contains to OT + NT, OT only or NT only — so Hebrew OT modules (BHS, WLC) and Greek NT or LXX modules are recognised correctly, and their cards only appear for books they contain.
  4. The first time, macOS asks "Obsidian wants access to control Accordance" — click Allow.
  5. A notice shows the verse when it works. Repeat for each module.

If you clicked "Don't Allow": System Settings → Privacy & Security → Automation → Obsidian → turn on Accordance.

Good to know:

  • If Accordance isn't running, the first request launches it and takes a few seconds. Whole chapters (e.g. Ps 119) are fetched verse by verse and take a little longer.
  • Books are sent to Accordance by their English names, so Korean searches like 요 3:16 work with Korean modules too.
  • Well-known translations (개역개정, 공동번역, ESV, NIV, NASB, NLT, CSB, NKJV, NRSV, NA28, BHS …) get their copyright notice automatically; you can type your own in the translation's editor.

개역개정 and other Korean Bible Society translations

개역개정, 공동번역, 새번역 and 새한글성경 are copyrighted by the Korean Bible Society, which licenses Bible text in software, apps and on the web separately (permission conditions). Versedrop therefore does not download these texts from the Society's website.

  • Recommended: connect your own 개역개정 module in Accordance (see above). Name it 개역개정 and the notice 성경전서 개역개정판 © 대한성서공회 is added automatically.
  • Or connect a JSON file you are licensed to use.
  • 새번역 is available from bolls.life but off by default; turn it on only for personal study.

Logos offers no official way for other apps to read Bible text, and its resources are encrypted, so Versedrop can't fetch text from Logos. Instead it can add a link next to every passage that opens it in your Logos — and the same for Accordance.

  1. Settings → Versedrop → More → Logos · Accordance links → Add links: choose Logos, Accordance or Both.
  2. Logos version — the version to open, e.g. ESV or NASB95. Leave it empty to use your preferred Bible in Logos.
  3. Accordance link module — the module to open, e.g. ESVS. Leave it empty for your default text. Passages fetched from an Accordance module always link to that module.
> [!quote] Romans 8:28, 31-39 (WEB) · [Logos](https://ref.ly/Rom8.28-39;ESV) · [Accordance](accord://read/ESVS?Romans_8:28-39)
  • Logos links use ref.ly and open in Logos desktop, mobile or the web app.
  • Accordance links use accord:// and open the Accordance app on that computer.
  • A link covers one continuous span, so Rom 8:28, 31-39 links to 8:28–39.

Adding other translations

From HelloAO (1,000+ languages)

Add a translation (+) → Find a translation on HelloAO… opens a browser for the Free Use Bible API by AO Lab — freely licensed translations in more than 1,000 languages, no key needed.

  1. Pick a language chip (German, Spanish, French …) or search by name, language or abbreviation (e.g. Luther, Reina, Deutsch).
  2. Click Add. Versedrop stores the translation's own book names (used in headers and accepted when you type references), its writing direction, and its licence notice, which is added under quotations.
  3. A chip for the new language appears in the search window.

Old- or New-Testament-only translations are detected automatically. You can rename a translation or edit its citation with the ✏️ button.

Your own sources

The Add your own group at the bottom of the Add a translation (+) menu also offers:

bolls.life translation — enter a display name and the bolls.life code. Useful for further languages:

Code Translation
LUT Luther 1912 (German)
RV1960 Reina-Valera 1960 (Spanish)

The full list is at https://bolls.life/static/bolls/app/views/languages.json. Please respect each translation's license.

JSON file — for a Bible JSON file you are licensed to use. No need to type a path:

  • Import from computer → choose the file. It is copied into your import folder (Versedrop Bibles by default) and connected automatically.
  • Save to folder — choose where imported files go, in the same dialog or under Settings → Versedrop → More → My translations → JSON files. Type a path (folders are suggested as you type), pick one with the 📁 button, or create a new folder with + — in the 📁 picker you can also type a new name and press Enter to create it. Nested paths such as Library/Bibles work; missing folders are created on import. Leave it empty to use the vault root.
  • Pick from vault (🔍) → search the JSON files already in your vault by name, or just start typing in the field to autocomplete.

Versedrop then checks the file and shows how many chapters and verses it found and whether it covers the OT, the NT or both. Four layouts are recognised:

// A. array (bolls.life dump format)
[{ "book": 43, "chapter": 3, "verse": 16, "text": "..." }]

// B. nested — book number or name → chapter → verse
{ "43": { "3": { "16": "..." } } }

// C. flat keys — Korean or English abbreviations
{ "요3:16": "...", "John 3:16": "..." }

// D. named wrapper — the file's own name is filled in for you
{ "version": "개역개정", "data": [{ "bookCode": "jhn", "chapter": "3", "verse": 16, "text": "..." }] }

Books can be numbers (1 Genesis – 66 Revelation), book codes (gen, jhn, 1co …) or names. In layout D a book code takes priority over a book number, so files that number books differently (e.g. with deuterocanonical books in between) still line up; deuterocanonical books (Tobit, Sirach, 1–2 Maccabees …) are read too — see Deuterocanonical books. Repeated or empty verses are tidied up, and the translation name and copyright notice are filled in from the file (개역개정, 새번역, 공동번역 … get the Korean Bible Society notice automatically). HTML tags and <heading>-style section titles are removed automatically. After replacing a file, click Clear cache.

Accordance module — see above.

Translations you add yourself open in an editor (name, code/module/path, language, Copyright notice). Click Done to fold it, and ✎ to open it again.

Quoting a few verses with attribution in sermon notes or personal study is ordinary quotation: your own writing is the main content, the source is credited, and you don't copy excessively. Versedrop helps you stay there:

  • Copyright notices (Settings → Versedrop → More → How passages look): Copyrighted translations (default) adds the notice under every copyrighted translation; All translations also labels public-domain ones; Off removes them — except for NET, whose terms require a notice every time.
  • Long quotation warning: when you insert more than 50 verses (adjustable; 0 turns it off) of a copyrighted translation at once, Versedrop reminds you of the limits.
  • The search window shows each copyrighted translation's notice under its card.

You may need the publisher's permission if you keep collecting passages into what is effectively a text database, publish your notes (e.g. on a website), or put large portions into teaching materials or publications.

> [!quote] 요한복음 3:16 (개역개정)
> ¹⁶하나님이 세상을 이처럼 사랑하사 …
>
> *성경전서 개역개정판 © 대한성서공회*

Output settings

Setting What it does
Block style Callout (default), Blockquote (reference at the bottom), or Plain text
Callout type The callout name, e.g. quote, bible, note. Custom names work with your own CSS.
Group translations into one block Off: one block per translation. On: one block titled by the reference with each translation labelled — handy for side-by-side Korean/English
Header format Template for the block title. Variables: {ref} {book} {chapter} {verses} {version} {abbr}. Default {ref} ({abbr}) → John 3:16 (KJV)
Book names Full (요한복음 / John) or short (요 / John, 창 / Gen)
Verse numbers Hidden, plain (16 For God…) or superscript (¹⁶For God…)
One verse per line Each verse on its own line — good for psalms and poetry

Non-contiguous verses are joined with …. For example, Rom 8:28, 31-39 produces verse 28, …, then verses 31–39.

Grouped example:

> [!quote] 요한복음 3:16 · John 3:16
> **개역한글**
> ¹⁶하나님이 세상을 이처럼 사랑하사 …
>
> **King James Version**
> ¹⁶For God so loved the world …

Troubleshooting

Problem What to do
"No book matches …" Try another spelling: John, Jn, 요, 요한복음.
A card shows a network error Check your internet connection, then search again.
Text looks wrong or outdated Settings → Versedrop → More → Help → Clear cache.
"Obsidian isn't allowed to control Accordance" System Settings → Privacy & Security → Automation → Obsidian → turn on Accordance.
"Accordance found no text in module …" The abbreviation must match Accordance exactly, including case and hyphens.
"Accordance found no text in module …" The abbreviation must match Accordance exactly, including case and hyphens.
Accordance is slow the first time It is launching; later requests are faster. You can open Accordance beforehand.
Accordance button is greyed out Accordance integration only works in the desktop app on macOS.
A translation doesn't appear Check that it is in My translations and that you're on the right language tab. Your own translations need both a name and a code/path/module.
A notice is missing for my Accordance module Type it into the row's Copyright notice field.

The plugin's settings tab also has a Help section at the bottom covering the same topics.

Network and system access

  • Network: text is fetched from bolls.life, the NET Bible API, HelloAO (for translations you add from it, and as a backup for built-in public-domain texts when bolls.life is unreachable) Only the translation, book and chapter (or passage) are sent. Opening the HelloAO browser downloads its list of translations.
  • Local only: JSON files and Accordance modules are read on your device; nothing is sent over the network.
  • Accordance (macOS): runs osascript through Node's execFile (no shell) with a fixed AppleScript that asks Accordance for verse text; the module and reference are passed as arguments. It is loaded only when you use an Accordance translation on a Mac, and macOS asks for your permission the first time.
  • Vault access: the JSON file picker lists .json files in your vault, and the folder picker lists your folders, only while those pickers are open. Versedrop reads only the JSON files you connect, and writes only the passages you insert and the JSON files you import (into your import folder).
  • Fetched passages are cached in memory until Obsidian restarts.
  • Releases are built from this repository by GitHub Actions, with artifact attestations for main.js and styles.css. Check one with gh attestation verify main.js --repo b2winus/versedrop.

한국어

목차

  1. 주요 기능
  2. 설치하기
  3. 빠르게 시작하기
  4. 구절 입력 방법
  5. 검색 창 사용법
  6. 노트에 적어 둔 구절로 바로 가져오기
  7. 단축키와 프리셋
  8. 기본 제공 역본
  9. NET, NIV, ESV
  10. Accordance 역본 연결하기 (Mac)
  11. 개역개정 등 대한성서공회 역본
  12. Logos·Accordance 링크
  13. 다른 역본 추가하기
  14. 출처 표기와 인용 범위
  15. 삽입 형식 설정
  16. 문제 해결
  17. 네트워크와 시스템 접근

주요 기능

  • 한글·영어·중국어·일본어로 구절 입력 — 추가한 역본의 책 이름으로도 검색돼요(Johannes 3:16, Juan 3:16, Jean 3:16)
  • 한 절, 범위, 장 전체, 장을 넘는 범위까지 — 고전 13:4-7, 시 23, 요 3:16-4:3, 창 1-2
  • 1,000개가 넘는 언어의 역본: 한국어·영어·독일어·프랑스어·스페인어·포르투갈어·중국어·일본어·헬라어·히브리어 등 — 언어를 클릭 한 번으로 골라 역본을 나란히 비교
  • 원하는 역본만 체크해서 한 번에 삽입 (선택은 다음에도 기억됨)
  • 단축키와 프리셋: 플러그인 설정에서 바로 단축키 지정, 창 없이 바로 삽입, 자주 쓰는 역본 조합(예: 원어 대조)을 명령으로 저장
  • 공개 역본(KJV, WEB, BSB 등)에 NET(공식 API)과 ESV(키 필요 없음) 지원, NIV 같은 저작권 역본은 Accordance 모듈로 연결
  • Accordance (Mac): Accordance에서 구입한 역본(개역개정, NIV, NASB 등)의 본문을 바로 가져오기
  • 저작권 역본에 출처 문구 자동 표기, 많은 분량을 인용하면 경고
  • Logos·Accordance 링크: 구절마다 내 성경 프로그램에서 바로 열리는 링크 추가
  • HelloAO에서 어떤 언어든 추가: 독일어·프랑스어·스페인어·포르투갈어·러시아어·이탈리아어·네덜란드어·라틴어 등 무료 역본을 언어별로 찾아 클릭 한 번에 추가. 그 역본의 책 이름과 저작권 안내가 함께 들어오고, 그 책 이름으로도 검색돼요(Johannes 3:16, Juan 3:16)
  • 예비 소스: bolls.life에 접속이 안 되면 기본 공개 역본(KJV, WEB, BSB 등)을 HelloAO에서 대신 가져와요
  • bolls.life 역본 코드나 볼트 안 JSON 파일로 역본 추가
  • 콜아웃·인용문·일반 텍스트 형식, 절 번호, 줄바꿈, 한영 병기 묶기 옵션
  • 한국어·영어·중국어(간체·번체) 화면과 도움말 — Obsidian 언어를 따르거나, 설정 → 기본 설정 → 화면 언어에서 직접 골라요

설치하기

Obsidian 1.13 이상이 필요해요.

커뮤니티 플러그인에서 (등록 후): 설정 → 커뮤니티 플러그인 → 탐색 → Versedrop 검색 → 설치 → 활성화.

직접 설치:

  1. 최신 릴리스에서 main.js, manifest.json, styles.css를 내려받습니다.
  2. <내 볼트>/.obsidian/plugins/versedrop/ 폴더를 만들고 세 파일을 넣습니다. Mac에서는 .obsidian이 숨김 폴더예요. Finder에서 Cmd+Shift+.을 누르면 보입니다.
  3. Obsidian을 다시 시작하거나, 설정 → 커뮤니티 플러그인에서 새로고침합니다.
  4. 설정 → 커뮤니티 플러그인에서 Versedrop을 켭니다. 커뮤니티 플러그인을 처음 쓰신다면 제한 모드를 먼저 꺼 주세요.

추천: 단축키를 지정해 두세요. 설정 → Versedrop → 더 보기 → 단축키와 프리셋 → 단축키 지정 (단축키와 프리셋 참고).

빠르게 시작하기

  1. 구절을 넣을 자리에 커서를 둡니다.
  2. 단축키를 누릅니다. 단축키가 없다면 명령 팔레트(Cmd/Ctrl+P)에서 성경 구절 검색해서 삽입을 실행하세요.
  3. 요 3:16을 입력하고 Enter를 누릅니다.
  4. 넣고 싶은 역본을 체크합니다.
  5. Cmd/Ctrl+Enter를 누르거나 삽입을 클릭하면 끝!

구절 입력 방법

한글·영어·중국어(간체/번체)·일본어 책 이름, 전체 이름·약어 모두 알아들어요. HelloAO에서 추가한 역본(독일어·프랑스어·스페인어 등)의 책 이름도 알아들어요. 띄어쓰기는 있어도 없어도 됩니다.

원하는 것 입력 예
한 절 요 3:16 · 요3:16 · John 3:16 · Jn 3.16
연속된 절 고전 13:4-7 · 요 3장 16~18절 · 1 Cor 13:4-7
떨어진 절 여러 개 롬 8:28, 31-39 · Rom 8:28, 31-39
장 전체 시 23 · 시편 23편 · Ps 23
장을 넘는 범위 요 3:16-4:3 · 요한복음 3장 16절-4장 3절 · 고전 12:31-13:13 · John 3:16-4:3
여러 장 전체 창 1-2 · 창 1-2장 · Gen 1-2
다른 언어 (HelloAO) Johannes 3:16 (독일어) · Jean 3:16 (프랑스어) · Juan 3:16 (스페인어)
외경(제2경전) 토비트 3:1 · 토빗 3:1 · 집회 1:1 · 지혜서 3장 1절 · 마카상 2:3 · Sir 1:1
한글 풀어 쓰기 요한복음 3장 16절
중국어 约翰福音 3:16 · 約翰福音3章16節 · 约3:16 · 林前13:4-7
일본어 ヨハネによる福音書 3:16 · ヨハ3章16節 · 1コリ13:4-7

약어는 대한성서공회 방식(창, 출, 삼상, 빌, 몬, 계 등)과 영어 SBL 방식(Gen, Exod, 1 Sam, Phil, Phlm, Rev 등)을 모두 지원해요. 빌립보서, Philippians 같은 전체 이름도 됩니다.

한 번에 10장까지 가져올 수 있어요(장마다 따로 내려받기 때문이에요). 장이 바뀌는 곳은 본문에 표시돼요. 절 번호를 일반 숫자로 쓰면 4:1, 그 밖에는 절 번호 앞에 굵은 4가 붙어요. 책의 마지막 장을 넘는 범위는 마지막 장까지만 가져와요(빌 3-9 → 빌립보서 3–4장).

검색 창 사용법

  • 검색창 — 구절을 입력하고 Enter.
  • 역본 카드 — 설정의 넣을 역본마다 카드가 하나씩, 그 순서대로 체크된 채 나와요. 이번에만 빼고 싶으면 체크를 풀면 돼요.
  • 다른 역본 보기 — 나머지 내 역본은 여기 접혀 있다가 열 때만 불러와요. 언어 버튼(한국어, 영어, 독일어, 헬라어 …)으로 좁혀 볼 수 있어요. 여기서 체크한 역본은 이번 삽입에만 들어가고, 기본 설정은 바뀌지 않아요.
  • 헬라어 역본은 신약만, 히브리어 WLC는 구약만 들어 있어요. 넣을 역본 중에 그 책이 있는 역본이 없으면 다른 역본이 자동으로 펼쳐져요.
  • 삽입 — 체크했고 정상적으로 불러온 카드를 모두 넣어요. 단축키는 Cmd/Ctrl+Enter.
  • 바로 넣기 — 설정 → 검색 창 → 구절을 찾은 뒤를 바로 넣기로 바꾸면 미리 보기 없이 Enter 한 번에 넣을 역본으로 바로 들어가요.

카드는 각각 따로 불러오기 때문에, 한 역본이 느리거나 오류가 나도 다른 역본에는 영향이 없어요. 오류가 나면 카드에 해결 방법이 함께 표시됩니다.

노트에 적어 둔 구절로 바로 가져오기

설교 원고에 딛 2:11-14라고 적어 두셨나요? 그 줄에 커서를 두거나 구절을 드래그로 선택하고 단축키를 누르세요. 검색이 자동으로 실행되고, 본문은 그 줄 아래에 들어가요. 적어 둔 구절 표기는 그대로 남습니다. 개요와 본문 구절을 먼저 쭉 적어 두고 나중에 본문을 하나씩 채울 때 편해요. 줄에 구절 표기만 있을 때 구절로 인식해요(앞의 -, *, >는 괜찮아요).

단축키와 프리셋

설정 → Versedrop → 더 보기 → 단축키와 프리셋에 Versedrop 명령과 지금 지정된 단축키가 모두 보여요. 단축키 지정을 누르면 Obsidian 단축키 화면이 Versedrop 명령만 걸러서 열려요. 명령 옆의 + 를 누르고 원하는 키를 누르면 끝이에요.

명령 하는 일
성경 구절 검색해서 삽입 검색 창을 열어요 (커서가 구절 위에 있으면 자동 검색)
기본 역본으로 바로 삽입 (창 없이) 커서가 있는 구절을 넣을 역본으로 창 없이 바로 넣어요. 설교 개요를 채울 때 가장 빨라요. 구절이 없으면 검색 창이 열려요.
프리셋: … 프리셋마다 하나씩 생기는 명령 (아래 참고)

프리셋은 함께 쓰는 역본 조합에 이름을 붙인 거예요. 예: 한영 대조(개역한글 + KJV), 원어 대조(SBLGNT + WLC). 프리셋 추가를 누르고 이름을 적은 뒤, 넣을 역본 버튼을 눌러 고르세요. 프리셋마다 명령이 따로 생겨서 단축키도 따로 지정할 수 있어요.

  • 구절 위에서 실행하면 → 프리셋 역본으로 바로 넣고,
  • 그 밖의 곳에서 실행하면 → 프리셋 역본이 선택된 검색 창이 열려요 (평소 넣을 역본은 바뀌지 않아요).

추천 설정: 검색 창은 Cmd+Shift+B, 창 없이 바로 삽입은 Cmd+Shift+V, 원어 대조 프리셋은 Cmd+Shift+G. (이미 쓰는 키인지 확인하세요. 겹치면 단축키 화면에서 알려 줘요.)

기본 제공 역본

언어 역본 가져오는 곳 저작권 기본 켜짐
한국어 개역한글 (1961) bolls.life 저작권 보호기간 만료 ✓
한국어 새번역 bolls.life © 대한성서공회 — 개인 묵상·연구용 —
영어 King James Version (KJV) bolls.life 퍼블릭 도메인 ✓
영어 World English Bible (WEB) bolls.life 퍼블릭 도메인 —
영어 Berean Standard Bible (BSB) bolls.life 퍼블릭 도메인 ✓
영어 English Standard Version (ESV) bolls.life © Crossway — 키 필요 없음, 개인 연구용 —
영어 New English Translation (NET) NET Bible 공식 API © Biblical Studies Press — 출처 표기 시 무료 인용 ✓
영어 American Standard Version (ASV) bolls.life 퍼블릭 도메인 —
영어 Young's Literal Translation (YLT) bolls.life 퍼블릭 도메인 —
영어 Literal Standard Version (LSV) bolls.life CC BY-SA 4.0 —
영어 Geneva Bible 1599 (GNV) bolls.life 퍼블릭 도메인 —
영어 Douay-Rheims (DRB) bolls.life 퍼블릭 도메인 —
중국어 和合本(简体) (CUV, 1919, 간체) bolls.life, 기기에서 변환 퍼블릭 도메인 —
중국어 和合本 (CUV, 1919, 번체) bolls.life 퍼블릭 도메인 —
일본어 口語訳 (1954/55) bolls.life 일본에서 저작권 보호기간 만료 —
헬라어 SBL Greek New Testament (SBLGNT) bolls.life © 2010 SBL & Logos — 출처 표기 시 무료 · 신약 —
헬라어 Textus Receptus (Elzevir 1624) bolls.life 퍼블릭 도메인 · 신약 —
헬라어 Tischendorf 8판 bolls.life 퍼블릭 도메인 · 신약 —
히브리어 Westminster Leningrad Codex (WLC) bolls.life 퍼블릭 도메인 · 구약 —
히브리어 WLC (악센트 포함) bolls.life 퍼블릭 도메인 · 구약 —
히브리어 Delitzsch 히브리어 신약 (1877) bolls.life 퍼블릭 도메인 · 신약 —

중국어·일본어·헬라어·히브리어

역본 추가(+) 메뉴에서 언어별 묶음으로 고르면 추가되고, 검색 창에 그 언어 버튼이 생겨요.

  • **和合本(简体)**은 퍼블릭 도메인인 1919년 和合本의 번체 글자를 기기에서 간체로 바꾼 것이에요(OpenCC). 본문 내용은 그대로예요.
  • 제목의 책 이름은 역본 언어를 따라가요: 约翰福音 3:16 (和合本(简体)), 約翰福音 3:16 (和合本, 번체), ヨハネによる福音書 3:16 (口語訳). 헬라어·히브리어 원문은 학술 관례대로 영어 책 이름을 써요.
  • 히브리어 카드는 오른쪽에서 왼쪽으로 표시돼요. 히브리어 성경은 절 구분이 한국어·영어 성경과 다른 곳이 있어요(예: 시편 표제가 1절로 셈, 말라기 4장 = 말라기 3:19–24). 히브리어 카드가 한 절씩 어긋나 보이면 절 번호를 확인해 보세요.
  • SBLGNT는 이용 조건에 따라 출처 문구가 항상 붙어요.
  • 저작권 판본 — 新标点和合本, 和合本修订版, 新译本, 当代译本, 中文标准译本, 现代中文译本, 吕振中译本, 新共同訳, 新改訳, NA28, UBS5, Rahlfs LXX, BHS — 은 기본으로 넣지 않았어요. Accordance에 가지고 계시면 Accordance 모듈로 추가하세요. Versedrop이 알아보고 맞는 출처 문구를 자동으로 붙여요. (bolls.life 코드 CUNPS, JPNICT 등으로 직접 추가할 수도 있지만 저작권은 직접 확인해 주세요.)

외경(제2경전)

토비트, 유딧, 지혜서, 집회서, 바룩, 마카베오상·하, 에스델·다니엘 부록은 이 책들이 들어 있는 역본에서 검색돼요. JSON 파일(예: 공동번역), HelloAO 역본, Accordance 모듈(예: NRSV with Apocrypha)이 해당돼요.

책 한글 (공동번역 · 가톨릭 성경) 영어
토비트 토비트 · 토빗 (토비) Tobit (Tob)
유딧 유딧 (유딧) Judith (Jdt)
에스델 부록 에스델 부록 (에스부) Add Esth
지혜서 지혜서 (지혜) Wisdom of Solomon (Wis)
집회서 집회서 (집회) Sirach (Sir)
바룩 바룩 (바룩) Baruch (Bar)
다니엘 부록 다니엘 부록 (단부) Add Dan
마카베오상·하 마카베오상·하 (마카상, 마카하, 1마카) 1–2 Maccabees (1 Macc)
  • JSON 파일은 불러올 때, Accordance 모듈은 연결 테스트 때(토비트 1:1을 시험) 자동으로 확인해요. 0.7.5 전에 추가한 HelloAO 역본이나 잘못 인식된 경우에는 역본 편집 창의 외경(제2경전) 포함 스위치를 켜 주세요.
  • 기본 제공(bolls.life) 역본에는 외경이 없어요.
  • 외경을 따로 된 책으로 둔 성경(공동번역 1977)에서는 단 13(수산나)·단 14는 다니엘 부록에서, 에스델 11–16장은 에스델 부록에서 찾아 줘요.

내 역본 고르기

설정 화면은 일부러 짧게 만들었어요. 첫 화면에는 넣을 역본과 검색 창 동작만 있고, 나머지는 더 보기에서 한 번 눌러 들어가요 — 내 역본, 노트에 들어가는 모양(미리 보기 포함), 단축키와 프리셋, Logos · Accordance 링크, 도움말.

첫 화면과 역본 관리는 이렇게 돼요.

  • 넣을 역본 — 구절을 찾으면 넣을 역본이에요. 이 순서대로 들어가요. 끌어서 순서를 바꾸고, 삭제로 빼고, + 로 내 역본에서 골라 더해요.

  • 내 역본 (더 보기 안) — 내가 쓰는 역본 전체예요. 역본마다 한 줄(언어 · 가져오는 곳)만 보여요. 넣을 역본에 없는 역본도 검색 창의 다른 역본 보기에서 쓸 수 있어요. 처음 설치하면 개역한글, KJV, BSB, NET이 들어 있어요.

  • 역본 추가 — 목록 머리의 + 를 눌러 고르면 바로 추가돼요. 한국어, English, 직접 추가(Accordance 모듈, bolls.life 코드, JSON 파일)로 묶여 있어요.

  • 끌어서 순서 바꾸기 — 이 목록의 순서를 바꿔요.

  • ✎ — 직접 추가한 역본 편집 (이름, 코드/모듈/경로, 언어, 출처 문구)

  • 삭제 — 목록에서 빼기 (기본 역본은 언제든 + 메뉴에서 다시 추가할 수 있어요)

개역개정, 공동번역, NIV, NASB 같은 역본은 무료로 가져올 수 있는 공개 소스가 없어요. 대신 Accordance 모듈이나 사용 권한이 있는 JSON 파일로 연결할 수 있습니다.

NET, NIV, ESV

NET은 공식 NET Bible API에서 가져오며 키가 필요 없어요. NET 조건에 따라 제목의 "NET"이 netbible.org로 연결되고 출처 문구가 항상 붙어요.

ESV는 + 메뉴(English)에 있고 키 없이 바로 써요. 새번역처럼 bolls.life에서 본문을 가져와요. © Crossway 저작권 역본이라 기본으로는 꺼 두었고, 인용할 때마다 출처 문구가 붙어요. 개인 연구와 설교 준비용으로 쓰세요.

NIV는 Biblica가 사용 허락을 관리하는 역본이라 기본으로 넣지 않았어요. 이렇게 쓸 수 있어요.

  • Accordance — NIV 모듈을 가지고 계시면 Accordance 모듈로 추가하세요(예: NIV11). 본문은 내 Mac 안에서만 오가고, 맞는 출처 문구가 자동으로 붙어요.
  • Logos 링크 — Logos 역본을 NIV로 정하면 구절 옆 링크가 NIV로 열려요.

Accordance 역본 연결하기 (Mac)

Accordance에서 구입한 성경 모듈이 있다면 Versedrop이 그 본문을 바로 가져와요. 따로 설치할 것은 없어요. 본문은 내 Mac 안에서 Accordance와 Obsidian 사이에서만 오가고 인터넷으로 전송되지 않으니, 내가 가진 라이선스 범위 안에서 쓰는 셈입니다.

필요한 것: macOS, Obsidian 데스크톱 앱, 모듈이 설치된 Accordance. (Windows, Linux, iPhone, Android에서는 쓸 수 없어요.)

연결 방법:

  1. 설정 → Versedrop → 더 보기 → 내 역본 → + → Accordance 모듈로 추가… (Mac)
  2. 입력하세요.
    • 이름 — 검색 창에 보일 이름. 예: 개역개정, ESV
    • Accordance 모듈 — Accordance 라이브러리나 텍스트 탭에 보이는 약어와 똑같이 (대소문자, 하이픈 포함). 예: ESVS
    • 언어 — 검색 창의 어느 언어 버튼에 나올지 정해요.
  3. 연결 확인을 누르면 Accordance에 구약과 신약 구절(창세기 1장, 요한복음)을 모두 요청해서 들어 있는 범위를 구약 + 신약, 구약만, 신약만 중 하나로 자동으로 정해요. 그래서 히브리어 구약(BHS, WLC)이나 헬라어 신약·LXX 모듈도 제대로 인식되고, 그 모듈에 있는 책을 검색할 때만 카드가 나와요.
  4. 처음에는 macOS가 "Obsidian이(가) Accordance을(를) 제어하려고 합니다" 라고 물어요. 허용을 눌러 주세요.
  5. 성공하면 본문이 알림으로 떠요. 쓰고 싶은 모듈마다 반복하세요.

"허용 안 함"을 눌렀다면: 시스템 설정 → 개인정보 보호 및 보안 → 자동화 → Obsidian 아래의 Accordance를 켜 주세요.

알아두면 좋은 점:

  • Accordance가 꺼져 있으면 첫 요청 때 실행되느라 몇 초 걸려요. 시 119 같은 장 전체는 절마다 요청해서 조금 오래 걸려요.
  • 책 이름은 영어로 바꿔서 Accordance에 보내므로, 요 3:16처럼 한글로 검색해도 한국어 모듈에서 잘 가져와요.
  • 개역개정, 공동번역, ESV, NIV, NASB, NLT, CSB, NKJV, NRSV, NA28, BHS처럼 알려진 역본은 출처 문구가 자동으로 붙어요. 역본 편집 창에서 직접 바꿀 수도 있어요.

개역개정 등 대한성서공회 역본

개역개정, 공동번역, 새번역, 새한글성경은 대한성서공회 저작권 역본이에요. 대한성서공회는 소프트웨어·앱·웹에서 성경 본문을 제공하는 것을 별도 허가 대상으로 두고 있어요(허가조건 및 사용료). 그래서 Versedrop은 대한성서공회 사이트에서 본문을 내려받지 않아요.

  • 추천: Accordance에 있는 내 개역개정 모듈을 연결하세요(위 설명 참고). 이름을 개역개정으로 하면 성경전서 개역개정판 © 대한성서공회 문구가 자동으로 붙어요.
  • 또는 사용 권한이 있는 JSON 파일을 연결할 수 있어요.
  • 새번역은 bolls.life에서 가져올 수 있지만 기본으로 꺼져 있어요. 개인 묵상·연구용으로만 켜서 쓰세요.

Logos·Accordance 링크

Logos는 외부 프로그램이 성경 본문을 읽을 수 있는 공식 방법을 제공하지 않고, 리소스도 암호화되어 있어서 Logos 본문은 가져올 수 없어요. 대신 구절 제목 옆에 내 Logos에서 바로 열리는 링크를 붙일 수 있습니다. Accordance 링크도 같은 방식으로 붙일 수 있어요.

  1. 설정 → Versedrop → 더 보기 → Logos · Accordance 링크 → 링크 붙이기에서 Logos, Accordance, 둘 다 중 하나를 고릅니다.
  2. Logos 역본 — Logos에서 열 역본 약어. 예: ESV, NASB95. 비워 두면 Logos의 기본 성경으로 열려요.
  3. Accordance 링크 모듈 — 링크로 열 모듈 약어. 예: ESVS. 비워 두면 Accordance 기본 텍스트로 열려요. Accordance 모듈에서 가져온 구절은 자동으로 그 모듈로 연결됩니다.
> [!quote] 로마서 8:28, 31-39 (개역한글) · [Logos](https://ref.ly/Rom8.28-39;ESV) · [Accordance](accord://read/ESVS?Romans_8:28-39)
  • Logos 링크는 ref.ly 형식이라 Logos 데스크톱, 모바일, 웹 어디서든 열려요.
  • Accordance 링크는 accord:// 형식이라 그 컴퓨터의 Accordance 앱에서 열려요.
  • 링크는 하나의 연속 범위로 만들어져요. 그래서 롬 8:28, 31-39는 8:28–39로 연결됩니다.

다른 역본 추가하기

HelloAO에서 찾기 (1,000개 이상 언어)

역본 추가(+) → **HelloAO에서 역본 찾기…**를 누르면 AO Lab의 무료 성경 API 역본 목록이 열려요. 1,000개가 넘는 언어의 자유 이용 역본이 있고, 키가 필요 없어요.

  1. 독일어·스페인어·프랑스어 같은 언어 버튼을 누르거나, 이름·언어·약어로 검색하세요(예: Luther, Reina, Deutsch).
  2. 추가를 누르면 끝이에요. 그 역본의 책 이름(제목에 쓰이고, 구절을 입력할 때도 알아들어요), 글쓰기 방향, 저작권 안내가 함께 저장되고, 저작권 안내는 인용 아래에 붙어요.
  3. 검색 창에 새 언어 버튼이 생겨요.

구약만·신약만 있는 역본은 자동으로 알아봐요. ✏️ 버튼으로 이름이나 출처 문구를 바꿀 수 있어요.

직접 추가

역본 추가(+) 메뉴 맨 아래 직접 추가 묶음에서는 이런 방법도 쓸 수 있어요.

bolls.life 역본 — 표시할 이름과 bolls.life 코드를 입력합니다. 다른 언어 성경을 쓸 때 유용해요.

코드 역본
LUT Luther 1912 (독일어)
RV1960 Reina-Valera 1960 (스페인어)

전체 목록은 https://bolls.life/static/bolls/app/views/languages.json 에서 볼 수 있어요. 각 역본의 저작권을 지켜 주세요.

JSON 파일 — 사용 권한이 있는 성경 JSON 파일을 연결해요. 경로를 직접 칠 필요가 없어요.

  • 컴퓨터에서 불러오기 → 파일을 고르면 저장 폴더(기본값 Versedrop Bibles)로 복사되고 자동으로 연결돼요.
  • 저장 폴더 — 불러온 파일을 둘 곳을 같은 창이나 설정 → Versedrop → 더 보기 → 내 역본 → JSON 파일에서 정해요. 경로를 직접 입력하거나(입력하면 폴더 목록이 떠요), 📁 버튼으로 고르거나, + 버튼으로 새 폴더를 만들 수 있어요. 📁 고르기 창에서 없는 이름을 입력하고 Enter를 눌러도 바로 만들어져요. 자료/성경처럼 하위 폴더도 되고, 없는 폴더는 불러올 때 자동으로 만들어져요. 비워 두면 볼트 맨 위에 저장돼요.
  • 볼트에서 고르기(🔍) → 이미 볼트에 있는 JSON 파일을 이름으로 찾아 골라요. 입력 칸에 글자를 치기 시작해도 자동완성돼요.

연결하면 Versedrop이 파일을 확인해서 몇 장·몇 절을 읽었는지, 구약·신약 중 어디가 들어 있는지 알려 줘요. 네 가지 형식을 인식해요.

// A. 배열 (bolls.life 덤프 형식)
[{ "book": 43, "chapter": 3, "verse": 16, "text": "..." }]

// B. 중첩 — 책 번호 또는 이름 → 장 → 절
{ "43": { "3": { "16": "..." } } }

// C. 키 형식 — 한글·영어 약어
{ "요3:16": "...", "John 3:16": "..." }

// D. 이름이 붙은 묶음 — 파일에 적힌 역본 이름이 자동으로 들어가요
{ "version": "개역개정", "data": [{ "bookCode": "jhn", "chapter": "3", "verse": 16, "text": "..." }] }

책은 번호(창세기 1 ~ 요한계시록 66), 책 코드(gen, jhn, 1co …), 이름 모두 돼요. D 형식에서는 책 코드를 먼저 보기 때문에, 외경(제2경전)이 중간에 끼어 책 번호가 다른 파일도 제대로 맞춰져요. 외경(토비트, 집회서, 마카베오 등)도 함께 읽어요. 외경(제2경전) 참고. 중복되거나 빈 절은 정리되고, 역본 이름과 출처 문구도 파일에서 채워져요(개역개정, 새번역, 공동번역 등은 대한성서공회 출처 문구가 자동으로 붙어요). HTML 태그나 <천지 창조> 같은 소제목은 자동으로 지워집니다. 파일을 바꾼 뒤에는 캐시 비우기를 눌러 주세요.

Accordance 모듈 — 위의 설명을 참고하세요.

직접 추가한 역본은 편집 칸(이름, 코드/모듈/경로, 언어, 출처 문구)이 열려요. 완료를 누르면 접히고, ✎를 누르면 다시 열려요.

출처 표기와 인용 범위

설교 원고나 묵상 노트에 몇 구절을 출처와 함께 넣는 정도는 일반적인 인용 범위에 해당해요. 기준은 내 글이 중심일 것, 출처를 밝힐 것, 지나치게 많이 옮기지 않을 것이에요. Versedrop은 이 범위 안에서 쓰도록 돕습니다.

  • 출처 표기 (설정 → Versedrop → 더 보기 → 노트에 들어가는 모양): 저작권 역본만(기본)은 저작권 역본 아래에 출처 문구를 붙이고, 모든 역본은 공개 역본에도 표시를 붙이고, 붙이지 않음은 끕니다. 다만 NET은 이용 조건상 항상 붙어요.
  • 인용 분량 경고: 저작권 역본을 한 번에 50절(조정 가능, 0이면 끄기)보다 많이 넣으면 알려 줘요.
  • 검색 창에서도 저작권 역본 카드 아래에 출처 문구가 보여요.

다음 경우에는 저작권자 허가가 필요할 수 있어요: 가져온 구절을 계속 모아 사실상 본문 데이터베이스를 만드는 경우, 노트를 웹사이트 등에 공개·배포하는 경우, 교재나 출판물에 많이 싣는 경우.

> [!quote] 요한복음 3:16 (개역개정)
> ¹⁶하나님이 세상을 이처럼 사랑하사 …
>
> *성경전서 개역개정판 © 대한성서공회*

삽입 형식 설정

설정 하는 일
블록 형태 콜아웃(기본), 인용문(구절 표기가 아래에 붙음), 일반 텍스트
콜아웃 종류 콜아웃 이름. 예: quote, bible, note. 직접 만든 이름도 CSS와 함께 쓸 수 있어요.
여러 역본을 한 블록으로 묶기 끄면 역본마다 블록이 따로 생기고, 켜면 구절 제목 하나 아래 역본별로 나뉘어 들어가요. 한영 대조에 좋아요.
제목 형식 블록 제목 템플릿. 변수: {ref} {book} {chapter} {verses} {version} {abbr}. 기본값 {ref} ({abbr}) → 요한복음 3:16 (개역한글)
책 이름 표기 전체 (요한복음 / John) 또는 약어 (요 / John, 창 / Gen)
절 번호 표시 안 함, 숫자 (16 하나님이…), 윗첨자 (¹⁶하나님이…)
절마다 줄바꿈 절마다 한 줄씩. 시편이나 긴 본문에 좋아요.

떨어진 절 사이에는 …가 들어가요. 예를 들어 롬 8:28, 31-39는 28절, …, 31–39절 순서로 들어갑니다.

상황별 추천 설정

상황 추천
묵상·설교 준비 노트 콜아웃 + 윗첨자 절 번호 (기본값)
한영 대조 성경공부 자료 언어 함께 + 한 블록으로 묶기 켜기
주보·설교 원고에 깔끔하게 일반 텍스트 + 절 번호 표시 안 함
시편·지혜서 절마다 줄바꿈 켜기

묶기를 켰을 때 예시:

> [!quote] 요한복음 3:16 · John 3:16
> **개역한글**
> ¹⁶하나님이 세상을 이처럼 사랑하사 …
>
> **King James Version**
> ¹⁶For God so loved the world …

문제 해결

증상 해결 방법
"…에 해당하는 책을 찾지 못했어요" 다른 표기로 입력해 보세요: 요, 요한복음, John, Jn
카드에 네트워크 오류 인터넷 연결을 확인하고 다시 검색하세요.
본문이 이상하거나 예전 내용 설정 → Versedrop → 더 보기 → 도움말 → 캐시 비우기
"Obsidian이 Accordance를 제어할 권한이 없어요" 시스템 설정 → 개인정보 보호 및 보안 → 자동화 → Obsidian → Accordance 켜기
"Accordance가 … 모듈에서 본문을 찾지 못했어요" 모듈 약어를 Accordance에 보이는 그대로(대소문자·하이픈 포함) 입력했는지 확인하세요.
"Accordance가 … 모듈에서 본문을 찾지 못했어요" 모듈 약어를 Accordance에 보이는 그대로(대소문자·하이픈 포함) 입력했는지 확인하세요.
Accordance가 처음에 느림 Accordance가 실행되는 중이에요. 다음부터는 빨라지고, 미리 열어 두면 더 빨라요.
Accordance 버튼이 회색 Mac의 Obsidian 데스크톱 앱에서만 쓸 수 있어요.
역본이 검색 창에 안 보임 내 역본 목록에 있는지, 맞는 언어 탭인지 확인하세요. 직접 추가한 역본은 이름과 코드/경로/모듈을 모두 채워야 나타나요.
Accordance 역본에 출처 문구가 안 붙음 그 줄의 출처 문구 칸에 직접 입력하세요.

플러그인 설정 화면 맨 아래 도움말에도 같은 내용이 정리되어 있어요.

네트워크와 시스템 접근

  • 네트워크: 본문은 bolls.life, NET Bible API, HelloAO(HelloAO에서 추가한 역본, 그리고 bolls.life에 접속이 안 될 때 기본 공개 역본의 예비 소스)에서 가져와요. 보내는 정보는 역본과 책·장(또는 구절)뿐이에요. HelloAO 역본 찾기 창을 열면 역본 목록을 내려받아요.
  • 내 기기 안에서만: JSON 파일과 Accordance 모듈은 내 기기에서 읽고, 인터넷으로 보내지 않아요.
  • Accordance (macOS): Node의 execFile로 osascript를 실행해(셸 없이) 고정된 AppleScript로 Accordance에 본문을 요청해요. 모듈과 구절은 인자로만 넘겨요. Mac에서 Accordance 역본을 쓸 때만 불러오고, 처음 한 번 macOS가 권한을 물어봅니다.
  • 볼트 접근: JSON 파일 고르기 창은 볼트의 .json 파일 목록을, 폴더 고르기 창은 폴더 목록을 그 창이 열려 있을 때만 봐요. 읽는 건 연결한 JSON 파일뿐이고, 쓰는 건 넣은 구절과 저장 폴더로 불러온 JSON 파일뿐이에요.
  • 가져온 본문은 Obsidian을 다시 시작할 때까지 메모리에 임시 저장돼요.
  • 릴리스 파일은 GitHub Actions가 이 저장소의 코드로 직접 빌드하고, main.js·styles.css에 빌드 증명(artifact attestation)을 붙여요. gh attestation verify main.js --repo b2winus/versedrop로 확인할 수 있어요.

中文

Versedrop 是一个 Obsidian 插件:输入经文出处,就能把经文插入笔记。界面默认跟随 Obsidian 的语言;也可以在 设置 → Versedrop → 常规 → 界面语言 中直接选择简体中文或繁體中文。

快速开始

  1. 设置 → 第三方插件 → 浏览,搜索 Versedrop 并安装、启用(或手动把 main.js、manifest.json、styles.css 放进 <仓库>/.obsidian/plugins/versedrop/)。
  2. 在命令面板(Cmd/Ctrl+P)运行 搜索并插入经文,或在 设置 → Versedrop → 快捷键与预设 中设置快捷键。
  3. 输入 约3:16,按 Enter,勾选译本后按 Cmd/Ctrl+Enter 插入。

经文出处的写法

想要的 例子
一节 约3:16 · 约翰福音 3:16 · 約翰福音3章16節 · John 3:16
连续几节 林前13:4-7 · 1 Cor 13:4-7
不连续的几节 罗8:28, 31-39
整章 诗23 · 诗篇 23篇
跨章 约3:16-4:3 · 创1-2
次经 多俾 3:1 · 德训篇 1:1 · 加上 2:3

中文译本

  • 内置:和合本(简体) 和 和合本(繁体)——都是 1919 年出版的公版和合本。简体版是在你的设备上把繁体字转换成简体(OpenCC),经文本身没有改动。在 设置 → Versedrop → 我的译本 → + 的“中文”分组中添加。
  • 新标点和合本、和合本修订版、新译本、当代译本、中文标准译本、现代中文译本、吕振中译本、思高译本 等受版权保护,不能内置。如果你在 Accordance(Mac)中拥有这些模块,可以作为 Accordance 模块添加,Versedrop 会自动加上正确的版权声明。
  • 在 HelloAO 查找译本(+ 菜单)中点“中文”,可以浏览可以免费使用的中文译本,一键添加。
  • 也可以导入你有权使用的圣经 JSON 文件(+ → 从 JSON 文件添加…)。

更详细的说明(输出格式、链接、预设、JSON 格式等)请看插件设置底部的“帮助”,或上面的 English 部分。

Support / 후원

If Versedrop helps your study or sermon preparation, you can support its development: Versedrop이 묵상과 설교 준비에 도움이 되셨다면 후원으로 응원해 주세요.

☕ Buy Me a Coffee

Development

npm install
npm run dev     # watch
npm run build   # type-check + production build

Credits

Bible text API by Bolls Bible. Translations remain the property of their respective copyright holders. Traditional → simplified Chinese conversion by opencc-js (MIT), using OpenCC dictionaries (Apache-2.0).

License

MIT