rstudio / juicyjuice

CSS style inlining with Juice

---

---

---

With the juicyjuice package it’s fairly easy to transform HTML such that all CSS is inlined directly into HTML tags.

So this:

<style>div{color:blue;}</style><div/>

Will turn to this:

<div style="color: blue;"></div>

Why do this? An important use case is HTML email and this is mainly because of Outlook on Windows (it does not support multiple classes on elements). Furthermore CSS inlining can help preserve a decent layout in email clients that do not support embedded CSS (in <style> tags), or, when an email is forwarded. Here's another reason to use this: embedding HTML in 3rd-party websites.

This R package contains a single function, css_inline(), where the only input required is a string of HTML text. It uses the juice JavaScript library (https://github.com/Automattic/juice), which is (1) well-tested, (2) very performant, and (3) has lots of great features. The aformentioned function will return a string of CSS-inlined HTML.

INSTALLATION

The juicyjuice package can be installed from CRAN with:

install.packages("juicyjuice")

You can also choose to install the development version of juicyjuice from GitHub:

devtools::install_github("rstudio/juicyjuice")

If you encounter a bug, have usage questions, or want to share ideas to make this package better, please feel free to file an issue.

Code of Conduct

Please note that the juicyjuice project is released with a contributor code of conduct.
By participating in this project you agree to abide by its terms.

📄 License

juicyjuice is licensed under the MIT license. See the LICENSE.md file for more details.

© Posit Software, PBC.

🏛️ Governance

This project is primarily maintained by Rich Iannone. Should there also be other authors, they might occasionally assist with some of these duties.

juicyjuice's Issues

Switch from V8 to QuickJSR

Is it possible to switch from V8 to QuickJSR? https://cran.r-project.org/web/packages/QuickJSR/index.html
V8 is a very heavy dependency, also broken on some non-mainstream platforms.
Depending on it creates problems further down with juicyjuice dependents, ex.: rstudio/gt#1179

Make package juicier overall

The package has one function with no options. Maybe add some options? The juice library has them, this does not. That’s the underlying issue.

Release juicyjuice 0.1.0

First release:

• usethis::use_cran_comments()
• Update (aspirational) install instructions in README
• Proofread Title: and Description:
• Check that all exported functions have @return and @examples
• Check that Authors@R: includes a copyright holder (role 'cph')
• Check licensing of included files
• Review https://github.com/DavisVaughan/extrachecks

Prepare for release:

• git pull
• Check if any deprecation processes should be advanced, as described in Gradual deprecation
• urlchecker::url_check()
• devtools::check(remote = TRUE, manual = TRUE)
• devtools::check_win_devel()
• rhub::check_for_cran()
• git push
• Draft blog post

Submit to CRAN:

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

Wait for CRAN...

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