Introduction to r2symbols, An R Package for adding symbols to Rmarkdown and Shiny Apps
Obinna Obianom
2023-03-11
Source:vignettes/introduction_r_symbols.Rmd
introduction_r_symbols.RmdBrief background
r2symbols is a part of the R2 R package family - https://r2symbols.obi.obianom.com
In preparing Rmarkdown documents and Shiny applications, symbols or special characters or greek letters or currencies e.t.c may be sort after to make the final output look more appealing or professional. R2symbols is an R package that makes this possible. Prior to the development of this package, many authors have preferrably used LaTeX codes to accomplish this. The downside to doing this are as follows -
- You have to know how to write LaTeX codes and be able to mix them in with R codes
- Some symbols or currencies sort after are sometimes not available with LaTeX
- The final output of Rmarkdown knitting or Shiny app rendering is HTML embedded with the mathjax script. This is an extra script that must be incorporated into the document for the units or symbols to convert properly. More so, javascript calls need to be fully functional in the browser for the process to carry on.
With r2symbols, the idea is very simple. There are already a lot of HTML codes available for many of these symbols, so this package simply incorporates the appropriate symbol into the document and in the final ouput, mathjax script is not needed for it to show up properly. Additionally, the code you will be writing is all R code and no LaTeX is needed.
Examples
Here are some examples on how to use the r2symbols package
Attach the library and request the alpha and beta symbols
α symbol("beta") β symbol("mouse") 🐁 symbol(456) 🦶 # OR together symbol("alpha","beta") αβ # OR use alias sym("alpha","beta") αβAttach the library, establish global settings for the symbols and then request symbols
library(r2symbols)
symbol.setting(font.size=50,font.weight ="normal",font.color = "blue")
symbol("copyright","heart","chessq","ox","deer","beer")Attach the library, then request symbols with specific settings
∓ # OR use alias symbol("integral",font.size=30,font.weight ="bold",font.color = "blue") ∫ #multiple symbols and settings sym("naira","yen","minusplus",font.color="violet") ₦¥∓Insert inline symbols
For example, you can make a writing using symbol number
likesymbol(243) for φg/mL or with the name like
symbol("mu") for μg/mL
OR, I could make a global settings first -
library(r2symbols)
symbol.setting(font.size=30,font.weight ="bold",font.color = "brown")Then…
For example, you can make a writing using symbol number like φg/mL or with the name like μg/mL