lovecraftr

CRAN status R-CMD-check

The lovecraftr package offers a collection of H.P. Lovecraft’s most renowned stories, formatted for easy access and text analysis. This package is intended for literary study, text analysis, and exploration of Lovecraft’s unique themes and style within the horror genre.

Installation

To install the CRAN version:


install.packages("lovecraftr")

To install the development version of lovecraftr from GitHub, follow these steps:

### First install the "devtools" package

install.packages("devtools")

### Then install the lovecraftr package

devtools::install_github("SergejRuff/lovecraftr")

Usage

The unearth_lovecraftian_tales() function provides a dataframe containing all available Lovecraft story titles along with their corresponding abbreviations. By default, calling unearth_lovecraftian_tales() returns the complete list of titles and abbreviations within the package. To retrieve the text of a specific story, you can provide either the full title, e.g., unearth_lovecraftian_tales("At the Mountains of Madness"), or the abbreviation, e.g., unearth_lovecraftian_tales("MM").

The fetch_lovecraft() function downloads H.P. Lovecraft’s writings directly from the H.P. Lovecraft Archive (https://www.hplovecraft.com/), providing users with easy access to all of his works, including those not available through the unearth_lovecraftian_tales() function.

List of Stories Included in the lovecraftr Package:

Citation

When utilizing lovecraftr in your research or software development, kindly reference the R package using the citation obtained from the citation() function:


### Citation function (version "X.X.X" -> version varies depending on release)

citation("lovecraftr")


#> To cite package ‘lovecraftr’ in publications use:
#> 
#>   Ruff S (2024). _lovecraftr: A Collection of Lovecraftian Tales and Texts_. R package version X.X.X,
#>   <https://github.com/SergejRuff/lovecraftr>.

#> A BibTeX entry for LaTeX users is

#>   @Manual{,
#>     title = {lovecraftr: A Collection of Lovecraftian Tales and Texts},
#>     author = {Sergej Ruff},
#>     url = {https://github.com/SergejRuff/lovecraftr},
#>     year = {2024},
#>     note = {R package version X.X.X},
#>   }