gadenbuie / lorem

Generate Lorem Ipsum Text

lorem::ipsum()

• Quickly generate lorem ipsum placeholder text with lorem::ipsum().

• Easy to integrate in RMarkdown documents.

• Includes an RStudio addin to insert lorem ipsum into the current document.

Installation

You can install the latest released version of lorem from CRAN

install.packages("lorem")

or the current development version of lorem from GitHub or r-universe

# GitHub
# install.packages("remotes")
rmeotes::install_github("gadenbuie/lorem")

# R Universe
install.packages('lorem', repos = c('https://gadenbuie.r-universe.dev', 'https://cloud.r-project.org'))

Usage

RStudio Addin

lorem includes a simple addin for RStudio that adds placeholder lorem ipsum text to the current source document. The addin allows you to specify the number of desired paragraphs and sentences.

R Markdown

Another way to generate lorem ipsum placeholder text is to call lorem::ipsum() in an inline R chunk in R Markdown.

`r lorem::ipsum(paragraphs = 2)`

Sit nunc at convallis fringilla semper. Penatibus vivamus eget malesuada cursus fames magnis potenti. Venenatis ligula enim conubia laoreet orci, class ligula. Massa sem sed enim risus ut mattis inceptos nisl elementum mattis. Nostra ultricies habitant donec vitae luctus proin gravida placerat ac libero imperdiet! Auctor habitasse faucibus ultricies purus eget sociis ultrices habitasse: nec ad aptent lectus rutrum proin potenti, montes, sodales, posuere convallis tempor erat, egestas magna lectus sociis mollis purus.

Dolor turpis euismod himenaeos interdum felis dictum tempus euismod tortor aliquam! Eget interdum vehicula laoreet quam mollis, justo cursus ad blandit feugiat pulvinar? Sem sodales bibendum leo leo magna pulvinar metus lacinia nam. Fringilla maecenas duis dis suscipit aenean natoque sem metus, quam risus sagittis convallis primis sociis id dictumst.

You can control the number of paragraphs and sentences per paragraph.

`r lorem::ipsum(paragraphs = 3, sentences = c(1, 2, 3))`

Amet cras primis at ac neque primis dui scelerisque massa inceptos massa.

Adipiscing netus cursus – vivamus est aliquam mauris pharetra: nostra ornare. Tristique ad consequat sagittis montes sociis, ut cursus tincidunt vitae sagittis netus!

Adipiscing aptent libero vitae etiam tristique commodo iaculis erat mattis tempor convallis. Porta aenean natoque, feugiat himenaeos – ac accumsan mollis torquent in ut maecenas congue vulputate nulla! Interdum fames.

You can also adjust the avg_words_per_sentence to create long or short paragraphs.

`r lorem::ipsum(2, avg_words_per_sentence = 3)`

Elit facilisis curae pharetra quisque per? Euismod risus phasellus euismod velit, orci platea? Na platea.

Amet posuere habitasse imperdiet. Porta tempor felis morbi. Est nam nisl litora viverra? Accumsan feugiat volutpat cubilia purus. Na purus.

`r lorem::ipsum(1, avg_words_per_sentence = 20)`

Elit venenatis tincidunt urna sagittis integer posuere dignissim. Dui tellus massa nam suspendisse venenatis dui nec imperdiet donec magna libero elementum euismod nibh ligula conubia vitae, ad egestas dis himenaeos ligula urna, dui parturient lacus montes semper ultricies euismod non condimentum porta sem luctus porttitor platea hac sagittis!

Everywhere Else

Generate lorem ipsum anywhere else using lorem::ipsum() or lorem::ipsum_words().

ipsum_items <- replicate(5, lorem::ipsum_words(5))
cat(paste("-", ipsum_items), sep = "\n")

• purus enim pellentesque blandit facilisis
• elementum interdum suscipit enim urna
• urna elementum nec vitae scelerisque
• scelerisque faucibus dignissim urna interdum
• curabitur porttitor dui in euismod

Ipsum gratiam

Thank you to Luke Haas for the node module getlorem and for providing the lorem ipsum word list used in this package.

lorem's Issues

Should ipsum() also have a collapse arg?

ipsum_words() already does

Add an `as.tags` generic

That puts each paragraph in a tags$p?

Add punctuation

Currently, sentences aren't punctuated. It'd be nice to add various punctuation marks, i.e. , ; : -- ....

Open question: what random process and parameters could be used to model and insert the punctuation marks?

Release lorem 1.0.0

Prepare for release:

• git pull
• Check current CRAN check results
• usethis::use_news_md()
• Polish NEWS
• urlchecker::url_check()
• devtools::build_readme()
• devtools::check(remote = TRUE, manual = TRUE)
• devtools::check_win_devel()
• revdepcheck::revdep_check(num_workers = 4)
• Update cran-comments.md
• git push
• Draft blog post

Submit to CRAN:

• usethis::use_version('major')
• devtools::submit_cran()
• Approve email

Wait for CRAN...

• Accepted 🎉
• usethis::use_github_release()
• usethis::use_dev_version(push = TRUE)
• usethis::use_news_md()
• Finish blog post
• Tweet
• Add link to blog post in pkgdown news menu

Add formatting

It might be useful to add an option to enable formatting via markdown characters, e.g. bold, italics, code.

Compare with/learn from stringi

I just learned that stringi has stri_rand_lipsum() that generates paragraphs of text.

stringi::stri_rand_lipsum(3, start_lipsum = FALSE)