Make ioslides_presentation() more themable via {bslib} and {sass}

Author: cpsievert

R/ioslides_presentation.R

@@ -19,9 +19,12 @@
 #' @param transition Speed of slide transitions. This can be "default",
 #'   "slower", "faster", or a numeric value with a number of seconds (e.g. 0.5).
 #' @param analytics A Google analytics property ID.
-#'@param smart Produce typographically correct output, converting straight
-#'  quotes to curly quotes, \code{---} to em-dashes, \code{--} to en-dashes, and
-#'  \code{...} to ellipses.
+#' @param smart Produce typographically correct output, converting straight
+#'   quotes to curly quotes, \code{---} to em-dashes, \code{--} to en-dashes, and
+#'   \code{...} to ellipses.
+#' @param theme a list of theming arguments (currently `bg`, `fg`, `primary`,
+#'   `success`, `warning`, `danger`, `base_font`, and `code_font` are supported,
+#'   see [bslib::bs_theme()] for more about these options)
 #' @return R Markdown output format to pass to \code{\link{render}}.
 #' @details
 #'   See the \href{https://bookdown.org/yihui/rmarkdown/ioslides-presentation.html}{
@@ -248,6 +251,7 @@ ioslides_presentation <- function(number_sections = FALSE,
                                   md_extensions = NULL,
                                   pandoc_args = NULL,
                                   extra_dependencies = NULL,
+                                  theme = NULL,
                                   ...) {
 
   # base pandoc options for all output
@@ -291,7 +295,7 @@ ioslides_presentation <- function(number_sections = FALSE,
 
   # html dependency for ioslides
   extra_dependencies <- append(extra_dependencies,
-                               list(html_dependency_ioslides()))
+                               html_dependency_ioslides(theme))
 
   # analytics
   if (!is.null(analytics))
@@ -453,14 +457,16 @@ ioslides_presentation <- function(number_sections = FALSE,
                                      mathjax = mathjax,
                                      pandoc_args = pandoc_args,
                                      extra_dependencies = extra_dependencies,
-                                     bootstrap_compatible = TRUE, ...))
+                                     bootstrap_compatible = TRUE, theme = theme, ...))
 }
 
 
-html_dependency_ioslides <- function() {
-  htmlDependency(
-    name = "ioslides",
-    version = "13.5.1",
+html_dependency_ioslides <- function(theme) {
+  name <- "ioslides"
+  version <- "13.5.1"
+  js <- htmlDependency(
+    name = paste0(name, "-js"),
+    version = version,
     src = pkg_file("rmd/ioslides/ioslides-13.5.1"),
     script = c(
       "js/modernizr.custom.45394.js",
@@ -470,10 +476,46 @@ html_dependency_ioslides <- function() {
       "js/hammer.js",
       "js/slide-controller.js",
       "js/slide-deck.js"
-    ),
-    stylesheet = c(
-      "fonts/fonts.css",
-      "theme/css/default.css",
-      "theme/css/phone.css")
     )
+  )
+
+  if (is.null(theme)) {
+    css <- htmlDependency(
+      name = paste0(name, "-css"),
+      version = version,
+      src = pkg_file("rmd/ioslides/ioslides-13.5.1"),
+      stylesheet = c(
+        "fonts/fonts.css",
+        "theme/css/default.css",
+        "theme/css/phone.css"
+      )
+    )
+    return(list(js, css))
+  }
+
+  theme <- as_bs_theme(theme)
+  if (!is_bs_theme(theme)) {
+    stop("`theme` must be a `bslib::bs_theme()` object or a list of arguments to it")
+  }
+  if ("3" %in% theme_version(theme)) {
+    stop("`ioslides_presentation()` is not compatible with Bootstrap 3 (use version = 4 or higher)")
+  }
+  io_file <- function(...) {
+    sass::sass_file(pkg_file("rmd/ioslides/ioslides-13.5.1", ...))
+  }
+  css <- bslib::bs_dependency(
+    input = sass::sass_layer(
+      rules = list(
+        io_file("fonts/fonts.css"),
+        io_file("theme/css/default.scss"),
+        io_file("theme/css/phone.css")
+      ),
+      file_attachments = c(fonts = pkg_file("rmd/ioslides/ioslides-13.5.1/fonts"))
+    ),
+    theme = theme,
+    name = paste0(name, "-css"),
+    version = version,
+    cache_key_extra = packageVersion("rmarkdown")
+  )
+  list(js, css)
 }