{"id":51120092,"url":"https://github.com/erykjj/traverture","last_synced_at":"2026-06-25T01:30:39.133Z","repository":{"id":366684710,"uuid":"1275617753","full_name":"erykjj/traverture","owner":"erykjj","description":"OBSIDIAN PLUGIN: parse, convert, preview, and insert Bible scripture references","archived":false,"fork":false,"pushed_at":"2026-06-22T23:10:50.000Z","size":10486,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-22T23:17:19.379Z","etag":null,"topics":["bible-reference-parser","bible-references","obsidian-plugin","parser","scripture-references","scriptures"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/erykjj.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-20T23:45:55.000Z","updated_at":"2026-06-22T23:10:44.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/erykjj/traverture","commit_stats":null,"previous_names":["erykjj/traverture"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/erykjj/traverture","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erykjj%2Ftraverture","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erykjj%2Ftraverture/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erykjj%2Ftraverture/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erykjj%2Ftraverture/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/erykjj","download_url":"https://codeload.github.com/erykjj/traverture/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erykjj%2Ftraverture/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34756205,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-24T02:00:07.484Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bible-reference-parser","bible-references","obsidian-plugin","parser","scripture-references","scriptures"],"created_at":"2026-06-25T01:30:39.015Z","updated_at":"2026-06-25T01:30:39.113Z","avatar_url":"https://github.com/erykjj.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# tra.VER:ture – Obsidian plugin\n\n\u003e **traverture** (n.): The act of traversing text to find, convert, and reformat scripture references – a turning across formats, translations, and styles. From Latin *trans-* (\"across\") + *vertere* (\"to turn\") + *-ura* (action/result).\n\nA scripture reference parser and formatter for Obsidian. Create interactive links with verse previews, or parse entire documents into a searchable, sortable sidebar table.\n\n## Security and Privacy\n\nIf you are concerned about the \"Scorecard\" review or the \"Caution\" warning on the [Obsidian Community plugins page](https://community.obsidian.md/plugins/traverture), see [SECURITY](https://github.com/erykjj/traverture?tab=security-ov-file).\n\n---\n\n## Features\n\n- **Inline reference parsing** – Wrap any text containing scripture references in `{{ }}` to create clickable links (in View mode). Surrounding text is preserved. Multiple references within a single block are all detected.\n\n  ```text\n  {{this is John 17:17 and Ps 1:1-3 end of test}}\n  ```\n  Produces two clickable links: `John 17:17` and `Ps 1:1-3`\n\n- **Verse preview modal** – Click any reference to open a modal with the full scripture text[^1] and buttons to copy the text, or open in *JW Library*[^2] or [*JW.ORG*](https://jw.org).\n\n- **Sidebar table** – Parse a selection or entire document into a searchable, sortable table with columns for Original, Full, Standard, and Official name formats, BCV codes, and chapter and verse numbers. Features include:\n  - Accent-insensitive search/filter\n  - Sort by any column (ascending/descending/original order)\n  - Column visibility toggles\n  - Translation language dropdown with live book name translation\n  - Option to render book names in all-caps\n  - Option to filter out duplicate entries\n  - Copy table (with current filter/sort, etc.) to clipboard (TSV format)\n\n- **Tag references** – Enclose all scripture references in a selection or document with `{{ }}` markers.\n\n- **Insert citation** – Replace a scripture reference with the full verse text[^1]. Two formats available:\n  - `Reference: \"verse\"` – preserves verse numbers\n  - `\"verse\" (Reference)` – plain text without verse numbers\n\n- **Reformat references** – Convert references between Full (1 Corinthians), Standard (1 Cor.), and Official (1Co) name formats. Works on selections or entire documents.\n\n- **Multi-language support** – Parse references in any supported language, and display or fetch verse text in a different language.\n  - Supported languages: Danish, Dutch, English, French, German, Italian, Japanese, Korean, Mandarin Chinese (simplified), Norwegian, Polish, Portuguese, Russian, Spanish, Swedish, Ukrainian\n\n![preview](traverture.gif)\n\n---\n\n## Usage\n\n### Desktop\nRight-click text selection or anywhere in the editor to access:\n- **Parse selection / Parse document** – Open the sidebar table\n- **Insert citation** – Choose `Reference: \"verse\"` or `\"verse\" (Reference)`\n- **Tag selection / Tag document** – Wrap references in `{{ }}`\n- **Reformat selection / Reformat document** – Convert between name formats\n\n### Mobile\nTap the three-line hamburger menu and look for **tra.VER:ture** (scroll icon) to access all commands.\n\n---\n\n## Settings\n\n- **Source language** – Language of the scripture references in your notes\n- **Output language** – Language for displaying book names in the sidebar and fetching verse text for previews\n\n---\n\n## Performance\n\nDepending on the length of the scripture passage and the device, initial verse lookup requires a network request and may take a moment. Parsing large documents on mobile may take a few seconds.\n\n---\n\n## Installation \u0026 Updating\n\n1. In your vault's `.obsidian/plugins/` directory, make a directory (folder) called `traverture`, if you don't already have one\n2. Download [main.js](https://github.com/erykjj/traverture/releases/latest/download/main.js), [styles.css](https://github.com/erykjj/traverture/releases/latest/download/styles.css) and [manifest.json](https://github.com/erykjj/traverture/releases/latest/download/manifest.json) and put them in that directory (over-writing to update)\n3. If not already enabled, enable the plugin in Obsidian Settings → Community plugins\n4. Configure source and output languages in the plugin settings (if installing for the first time)\n\n---\n\n[![Static Badge](https://img.shields.io/badge/releases-orange?style=plastic\u0026logo=rss\u0026logoColor=orange\u0026color=black)](https://github.com/erykjj/traverture/releases.atom)\n\nFeel free to get in touch and post any [issues and/or suggestions](https://github.com/erykjj/traverture/issues).\n\n______\n\n[^1]: Bible citation text is taken from [*New World Translation of the Holy Scriptures*](https://www.jw.org/en/library/bible/study-bible/books/) (*NWT*) (© Watch Tower Bible and Tract Society of Pennsylvania). In the future, other translations may be included.\n\n[^2]: [JW Library](https://www.jw.org/en/online-help/jw-library/) is a registered trademark of Watch Tower Bible and Tract Society of Pennsylvania.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ferykjj%2Ftraverture","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ferykjj%2Ftraverture","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ferykjj%2Ftraverture/lists"}