{"id":19050534,"url":"https://github.com/blakek/ebible-usfx-parser","last_synced_at":"2025-08-02T11:33:54.132Z","repository":{"id":77618426,"uuid":"235486367","full_name":"blakek/ebible-usfx-parser","owner":"blakek","description":"🎄 Parses USFX from ebible.org into a JSON-ified syntax tree","archived":false,"fork":false,"pushed_at":"2022-03-04T13:46:00.000Z","size":238,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-06-24T23:45:27.259Z","etag":null,"topics":["bible","syntax-tree","usfx"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/blakek.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2020-01-22T02:49:08.000Z","updated_at":"2024-10-25T09:55:06.000Z","dependencies_parsed_at":"2023-03-10T08:46:04.844Z","dependency_job_id":null,"html_url":"https://github.com/blakek/ebible-usfx-parser","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/blakek/ebible-usfx-parser","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blakek%2Febible-usfx-parser","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blakek%2Febible-usfx-parser/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blakek%2Febible-usfx-parser/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blakek%2Febible-usfx-parser/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/blakek","download_url":"https://codeload.github.com/blakek/ebible-usfx-parser/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blakek%2Febible-usfx-parser/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268378965,"owners_count":24240907,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-02T02:00:12.353Z","response_time":74,"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","syntax-tree","usfx"],"created_at":"2024-11-08T23:15:15.079Z","updated_at":"2025-08-02T11:33:54.116Z","avatar_url":"https://github.com/blakek.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# USFX Parser\n\n\u003e 🎄 Parses [USFX] from [ebible.org] into a JSON-ified syntax tree\n\n🚧 **NOTE:** This is a work-in-progress. I'm checking the output for errors and\niterating when something is found. The output format is very likely to change\nso it's simpler to use in real projects. Eventually, I'd like this format to be\neasy to segment so individual books could be downloaded as-needed. Any thoughts\nor help with development would be appreciated!\n\nThis project reads a USFX file and outputs a JavaScript object. The output\nfollows the [Universal Syntax Tree] format.\n\nThe output is a tree with a lot of information. It may take a bit more work to\nget information than most simpler Bible formats. However, the primary goal is\naccuracy of content.\n\n## Why\n\nI looked all over open-source land for a Bible format that differentiated\nbetween paragraphs, verses, stanza lines, etc.\n\nA majority of formats I found had raw verse text but no formatting information.\nSome had detailed formatting information, but were difficult to work with or\nwould require extra libraries to get basic text. The only project that really\nmet what I was looking for was [`TehShrike/world-english-bible`]. I wanted more\ntranslations, and that project pointed me to [ebible.org] and its [USFX] format.\n\n## Install\n\nThis package has not been published yet. When it is, instructions to install\nwill be added here.\n\n\u003c!--\nUsing [Yarn]:\n\n```bash\n$ yarn add ebible-usfx-parser\n```\n\n…or using [npm]:\n\n```bash\n$ npm i --save ebible-usfx-parser\n```\n--\u003e\n\n## Usage\n\n```js\nimport fs from 'fs/promises';\nimport { selectAll } from 'unist-util-select';\nimport * as usfxParser from 'usfx-parser';\n\n// USFX files available from https://ebible.org/download.php\nconst inputFile = './eng-kjv2006_usfx.xml';\n\n// Parse the USFX file into a JavaScript object\nconst bible = await usfxParser.parseFile(inputFile);\n\n// Example: get all books\nselectAll('book', bible);\n/**\n * [\n *   {\n *     type: 'book',\n *     attributes: { id: 'GEN' },\n *     children: [ ... chpater data ]\n *   },\n *   ... snippet\n * ]\n */\n```\n\n## Acknowledgments\n\n- [`tehshrike/world-english-bible`] - for pointing me in the right direction and\n  general inspiration for this project\n- [ebible.org] - for all the work put into providing the numerous translations\n  available\n- [@syntax-tree] - for a solid syntax tree standard and awesome tools to go\n  along with it\n\n## See Also\n\ncoming soon…\n\n## License\n\nMIT\n\n[ebible.org]: https://ebible.org/\n[npm]: https://www.npmjs.com/\n[`tehshrike/world-english-bible`]: https://github.com/TehShrike/world-english-bible\n[universal syntax tree]: https://github.com/syntax-tree/unist\n[@syntax-tree]: https://github.com/syntax-tree\n[usfx]: https://ebible.org/usfx/\n[yarn]: https://yarnpkg.com/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblakek%2Febible-usfx-parser","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblakek%2Febible-usfx-parser","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblakek%2Febible-usfx-parser/lists"}