{"id":23341997,"url":"https://github.com/andrewheiss/scripturs","last_synced_at":"2025-04-10T01:02:18.031Z","repository":{"id":56937054,"uuid":"163114579","full_name":"andrewheiss/scriptuRs","owner":"andrewheiss","description":"📖 An R package for the complete LDS Scriptures","archived":false,"fork":false,"pushed_at":"2019-01-11T07:36:31.000Z","size":1631,"stargazers_count":14,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-10T01:02:14.831Z","etag":null,"topics":["lds","lds-scriptures","r","text-mining","tidytext"],"latest_commit_sha":null,"homepage":"","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/andrewheiss.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-12-25T22:18:40.000Z","updated_at":"2023-07-22T21:03:03.000Z","dependencies_parsed_at":"2022-08-21T06:50:08.628Z","dependency_job_id":null,"html_url":"https://github.com/andrewheiss/scriptuRs","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrewheiss%2FscriptuRs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrewheiss%2FscriptuRs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrewheiss%2FscriptuRs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrewheiss%2FscriptuRs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/andrewheiss","download_url":"https://codeload.github.com/andrewheiss/scriptuRs/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248137896,"owners_count":21053775,"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","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":["lds","lds-scriptures","r","text-mining","tidytext"],"created_at":"2024-12-21T05:12:51.839Z","updated_at":"2025-04-10T01:02:17.968Z","avatar_url":"https://github.com/andrewheiss.png","language":"R","funding_links":[],"categories":[],"sub_categories":[],"readme":"# scriptuRs \u003cimg src=\"tools/logo.png\" align=\"right\"/\u003e\n\n[![CRAN_Status_Badge](http://www.r-pkg.org/badges/version/scriptuRs)](https://cran.r-project.org/package=scriptuRs)\n[![DOI](https://zenodo.org/badge/163114579.svg)](https://zenodo.org/badge/latestdoi/163114579)\n\n![Downloads](https://cranlogs.r-pkg.org/badges/scriptuRs)\n![Downloads](https://cranlogs.r-pkg.org/badges/grand-total/scriptuRs)\n[![lifecycle](https://img.shields.io/badge/lifecycle-stable-brightgreen.svg)](https://www.tidyverse.org/lifecycle/#stable)\n\n## An R Package for the Complete LDS Scriptures\n\nThis package provides access to the full text of the Standard Works for The Church of Jesus Christ of Latter-day Saints: the Old and New Testaments, the Book of Mormon, the Doctrine and Covenants, and the Pearl of Great Price. The text for each book of scripture was sourced from [the Mormon Documentation Project](http://scriptures.nephi.org/). Each volume is in a data frame with a row for each verse, along with 19 columns of detailed metadata (including verse number, chapter number, book names, unique identifiers, and so on), ready for text analysis. The package contains:\n\n- `old_testament`: The King James Version of the Old Testament / Hebrew Bible\n- `new_testament`: The King James Version of the New Testament\n- `book_of_mormon`: The Book of Mormon\n- `doctrine_and_covenants`: The Doctrine and Covenants\n- `pearl_of_great_price`: The Pearl of Great Price\n\nThere is also a function `lds_scriptures()` that returns a tidy data frame of all 5 volumes of scripture, as well as a `kjv_bible()` function that returns a tidy data frame of just the Old and New Testaments.\n\nUnlike other packages like [**janeaustenr**](https://github.com/juliasilge/janeaustenr), this package does not provide ordered factors for book or volume names. It is up to the user to put books and/or volumes in the needed order when analyzing or plotting the data.\n\n\n## Installation\n\nTo install the current stable version of the package, type the following:\n\n```r\ninstall.packages(\"scriptuRs\")\nlibrary(scriptuRs)\n```\n\nAlternatively, you can install the development version from Github:\n\n```r\nlibrary(remotes)\ninstall_github(\"andrewheiss/scriptuRs\")\nlibrary(scriptuRs)\n```\n\n\n## Usage\n\nFor some ideas on getting started with analyzing these texts, see [*Text Mining with R* by Julia Silge and David Robinson](https://www.tidytextmining.com/), or Julia Silge's [blog post on sentiment analysis of Jane Austen's novels](https://juliasilge.com/blog/if-i-loved-nlp-less/). For help within R, try `?old_testament` or similar for getting started with the data sets.\n\nHere's how to use `lds_scriptures()`:\n\n```r \nlibrary(dplyr)\nlibrary(scriptuRs)\n\nscriptures \u003c- lds_scriptures()\n\nscriptures %\u003e% \n  group_by(volume_title, book_title) %\u003e%\n  summarize(total_verses = n())\n#\u003e # A tibble: 87 x 3\n#\u003e # Groups:   volume_title [?]\n#\u003e    volume_title   book_title total_verses\n#\u003e    \u003cchr\u003e          \u003cchr\u003e             \u003cint\u003e\n#\u003e  1 Book of Mormon 1 Nephi             618\n#\u003e  2 Book of Mormon 2 Nephi             779\n#\u003e  3 Book of Mormon 3 Nephi             785\n#\u003e  4 Book of Mormon 4 Nephi              49\n#\u003e  5 Book of Mormon Alma               1975\n#\u003e  6 Book of Mormon Enos                 27\n#\u003e  7 Book of Mormon Ether               433\n#\u003e  8 Book of Mormon Helaman             497\n#\u003e  9 Book of Mormon Jacob               203\n#\u003e 10 Book of Mormon Jarom                15\n#\u003e # ... with 77 more rows\n```\n\nAnd here's how to use `kvj_bible()`:\n\n```r\nbible \u003c- kjv_bible()\n\nbible %\u003e% \n  group_by(volume_title, book_title) %\u003e%\n  summarize(total_verses = n())\n#\u003e # A tibble: 66 x 3\n#\u003e # Groups:   volume_title [?]\n#\u003e    volume_title  book_title      total_verses\n#\u003e    \u003cchr\u003e         \u003cchr\u003e                  \u003cint\u003e\n#\u003e  1 New Testament 1 Corinthians            437\n#\u003e  2 New Testament 1 John                   105\n#\u003e  3 New Testament 1 Peter                  105\n#\u003e  4 New Testament 1 Thessalonians           89\n#\u003e  5 New Testament 1 Timothy                113\n#\u003e  6 New Testament 2 Corinthians            257\n#\u003e  7 New Testament 2 John                    13\n#\u003e  8 New Testament 2 Peter                   61\n#\u003e  9 New Testament 2 Thessalonians           47\n#\u003e 10 New Testament 2 Timothy                 83\n#\u003e # ... with 56 more rows\n```\n\n## Code of Conduct\n\nThis project is released with a [Contributor Code of Conduct](CONDUCT.md). By participating in this project you agree to abide by its terms.\n\n\n## Credits\n\nThe text of the scriptures comes from the Mormon Documentation Project\n(http://scriptures.nephi.org/) and is provided under a public domain license\nwith no rights reserved. The license has been converted to MIT here, due to CRAN's policy that the entire package use the same license throughout.\n\nBible image by [Sander Leefers from the Noun Project](https://thenounproject.com/search/?q=bible\u0026i=10058)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandrewheiss%2Fscripturs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fandrewheiss%2Fscripturs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandrewheiss%2Fscripturs/lists"}