7.5 CSS and themes

The format xaringan::moon_reader has a css option, to which you can pass a vector of CSS file paths, e.g.,

---
output:
  xaringan::moon_reader:
    css: ["default", "extra.css"]
---

In theory, the file path should contain the extension .css. If a path does not contain a filename extension, it is assumed to be a built-in CSS file in the xaringan package. For example, default in the above example means default.css in the package under the path xaringan:::pkg_resource(). To see all built-in CSS files, call xaringan:::list_css() in R.

When you only want to override a few CSS rules in the default theme, you do not have to copy the whole file default.css; instead, create a new (and hopefully smaller) CSS file that only provides new CSS rules.

Users have contributed a few themes to xaringan. For example, you can use the metropolis theme (https://github.com/pat-s/xaringan-metropolis):

---
output:
  xaringan::moon_reader:
    css: [default, metropolis, metropolis-fonts]
---

To see all possible themes:

names(xaringan:::list_css())

##  [1] "chocolate-fonts"  "chocolate"       
##  [3] "default-fonts"    "default"         
##  [5] "duke-blue"        "fc-fonts"        
##  [7] "fc"               "hygge-duke"      
##  [9] "hygge"            "ki-fonts"        
## [11] "ki"               "kunoichi"        
## [13] "lucy-fonts"       "lucy"            
## [15] "metropolis-fonts" "metropolis"      
## [17] "middlebury-fonts" "middlebury"      
## [19] "ninjutsu"         "rladies-fonts"   
## [21] "rladies"          "robot-fonts"     
## [23] "robot"            "rutgers-fonts"   
## [25] "rutgers"          "shinobi"         
## [27] "tamu-fonts"       "tamu"            
## [29] "uio-fonts"        "uio"             
## [31] "uo-fonts"         "uo"              
## [33] "uol-fonts"        "uol"             
## [35] "useR-fonts"       "useR"

If you also want to contribute themes, please read the guide at https://yihui.name/en/2017/10/xaringan-themes.