😎 Give your xaringan slides some style
No puede seleccionar más de 25 temas Los temas deben comenzar con una letra o número, pueden incluir guiones ('-') y pueden tener hasta 35 caracteres de largo.

229 líneas
13KB

  1. % Generated by roxygen2: do not edit by hand
  2. % Please edit documentation in R/style_xaringan.R
  3. \name{style_xaringan}
  4. \alias{style_xaringan}
  5. \title{Write A Customized Xaringan Theme}
  6. \usage{
  7. style_xaringan(
  8. text_color = "#000",
  9. header_color = "#000",
  10. background_color = "#FFF",
  11. link_color = "rgb(249, 38, 114)",
  12. text_bold_color = NULL,
  13. text_slide_number_color = inverse_background_color,
  14. padding = "16px 64px 16px 64px",
  15. background_image = NULL,
  16. background_size = NULL,
  17. background_position = NULL,
  18. code_highlight_color = "rgba(255,255,0,0.5)",
  19. code_inline_color = "#000",
  20. code_inline_background_color = NULL,
  21. code_inline_font_size = "1rem",
  22. inverse_background_color = "#272822",
  23. inverse_text_color = "#d6d6d6",
  24. inverse_text_shadow = FALSE,
  25. inverse_header_color = "#f3f3f3",
  26. title_slide_text_color = inverse_text_color,
  27. title_slide_background_color = inverse_background_color,
  28. title_slide_background_image = NULL,
  29. title_slide_background_size = NULL,
  30. title_slide_background_position = NULL,
  31. footnote_color = NULL,
  32. footnote_font_size = "0.9rem",
  33. footnote_position_bottom = "60px",
  34. left_column_subtle_color = "#777",
  35. left_column_selected_color = "#000",
  36. blockquote_left_border_color = "lightgray",
  37. table_border_color = "#666",
  38. table_row_border_color = "#ddd",
  39. table_row_even_background_color = "#eee",
  40. base_font_size = "20px",
  41. text_font_size = "1rem",
  42. header_h1_font_size = "2.75rem",
  43. header_h2_font_size = "2.25rem",
  44. header_h3_font_size = "1.75rem",
  45. header_background_auto = FALSE,
  46. header_background_color = header_color,
  47. header_background_text_color = background_color,
  48. header_background_padding = NULL,
  49. header_background_content_padding_top = "7rem",
  50. header_background_ignore_classes = c("normal", "inverse", "title", "middle", "bottom"),
  51. text_slide_number_font_size = "0.9rem",
  52. text_font_google = NULL,
  53. text_font_family = "Noto Sans",
  54. text_font_weight = "normal",
  55. text_font_url = "https://fonts.googleapis.com/css?family=Noto+Sans:400,400i,700,700i&display=swap",
  56. text_font_family_fallback = "-apple-system, BlinkMacSystemFont, avenir next, avenir, helvetica neue, helvetica, Ubuntu, roboto, noto, segoe ui, arial",
  57. text_font_base = "sans-serif",
  58. header_font_google = NULL,
  59. header_font_family = "Cabin",
  60. header_font_weight = "600",
  61. header_font_url = "https://fonts.googleapis.com/css?family=Cabin:600,600i&display=swap",
  62. code_font_google = NULL,
  63. code_font_family = "Source Code Pro",
  64. code_font_size = "0.9rem",
  65. code_font_url = "https://fonts.googleapis.com/css?family=Source+Code+Pro:400,700&display=swap",
  66. code_font_family_fallback = "Menlo, Consolas, Monaco, Liberation Mono, Lucida Console",
  67. colors = NULL,
  68. extra_css = NULL,
  69. extra_fonts = NULL,
  70. outfile = "xaringan-themer.css"
  71. )
  72. }
  73. \arguments{
  74. \item{text_color}{Text Color. Defaults to #000. Modifies the \code{body} element.}
  75. \item{header_color}{Header Color. Defaults to #000. Modifies the \verb{h1, h2, h3} elements.}
  76. \item{background_color}{Slide Background Color. Defaults to #FFF. Modifies the \code{.remark-slide-content} class.}
  77. \item{link_color}{Link Color. Defaults to rgb(249, 38, 114). Modifies the \verb{a, a > code} elements.}
  78. \item{text_bold_color}{Bold Text Color. Defaults to \code{NULL}. Modifies the \code{strong} element.}
  79. \item{text_slide_number_color}{Slide Number Color. Defaults to \code{inverse_background_color}. Modifies the \code{.remark-slide-number} class.}
  80. \item{padding}{Slide Padding in \verb{top right [bottom left]} format. Defaults to 16px 64px 16px 64px. Modifies the \code{.remark-slide-content} class.}
  81. \item{background_image}{Background image applied to each \emph{and every} slide. Set \code{title_slide_background_image = "none"} to remove the background image from the title slide. Defaults to \code{NULL}. Modifies the \code{.remark-slide-content} class.}
  82. \item{background_size}{Background image size, requires \code{background_image} to be set. If \code{background_image} is set, \code{background_size} will default to \code{cover} so the backround fills the screen. If both \code{background_image} and \code{background_position} are set, will default to 100 percent. Defaults to \code{NULL}. Modifies the \code{.remark-slide-content} class.}
  83. \item{background_position}{Background image position, requires \code{background_image} to be set, and it is recommended to adjust \code{background_size}. Defaults to \code{NULL}. Modifies the \code{.remark-slide-content} class.}
  84. \item{code_highlight_color}{Code Line Highlight. Defaults to rgba(255,255,0,0.5). Modifies the \code{.remark-code-line-highlighted} class.}
  85. \item{code_inline_color}{Inline Code Color. Defaults to #000. Modifies the \code{.remark-inline-code} class.}
  86. \item{code_inline_background_color}{Inline Code Background Color. Defaults to \code{NULL}. Modifies the \code{.remark-inline-code} class.}
  87. \item{code_inline_font_size}{Inline Code Text Font Size. Defaults to 1rem. Modifies the \code{.remark-inline-code} class.}
  88. \item{inverse_background_color}{Inverse Background Color. Defaults to #272822. Modifies the \code{.inverse} class.}
  89. \item{inverse_text_color}{Inverse Text Color. Defaults to #d6d6d6. Modifies the \code{.inverse} class.}
  90. \item{inverse_text_shadow}{Enables Shadow on text of inverse slides. Defaults to \code{FALSE}. Modifies the \code{.inverse} class.}
  91. \item{inverse_header_color}{Inverse Header Color. Defaults to #f3f3f3. Modifies the \verb{.inverse h1, .inverse h2, .inverse h3} classes.}
  92. \item{title_slide_text_color}{Title Slide Text Color. Defaults to \code{inverse_text_color}. Modifies the \code{.title-slide} class.}
  93. \item{title_slide_background_color}{Title Slide Background Color. Defaults to \code{inverse_background_color}. Modifies the \code{.title-slide} class.}
  94. \item{title_slide_background_image}{Title Slide Background Image URL. Defaults to \code{NULL}. Modifies the \code{.title-slide} class.}
  95. \item{title_slide_background_size}{Title Slide Background Image Size, defaults to "cover" if background image is set. Defaults to \code{NULL}. Modifies the \code{.title-slide} class.}
  96. \item{title_slide_background_position}{Title Slide Background Image Position. Defaults to \code{NULL}. Modifies the \code{.title-slide} class.}
  97. \item{footnote_color}{Footnote text color (if \code{NA}, then it will be the same color as \code{text_color}). Defaults to \code{NULL}. Modifies the \code{.footnote} class.}
  98. \item{footnote_font_size}{Footnote font size. Defaults to 0.9rem. Modifies the \code{.footnote} class.}
  99. \item{footnote_position_bottom}{Footnote location from bottom of screen. Defaults to 60px. Modifies the \code{.footnote} class.}
  100. \item{left_column_subtle_color}{Left Column Text (not last). Defaults to #777. Modifies the \verb{.left-column h2, .left-column h3} classes.}
  101. \item{left_column_selected_color}{Left Column Current Selection. Defaults to #000. Modifies the \verb{.left-column h2:last-of-type, .left-column h3:last-child} classes.}
  102. \item{blockquote_left_border_color}{Blockquote Left Border Color. Defaults to lightgray. Modifies the \code{blockquote} element.}
  103. \item{table_border_color}{Table top/bottom border. Defaults to #666. Modifies the \verb{table: border-top, border-bottom} elements.}
  104. \item{table_row_border_color}{Table row inner bottom border. Defaults to #ddd. Modifies the \verb{table thead th: border-bottom} elements.}
  105. \item{table_row_even_background_color}{Table Even Row Background Color. Defaults to #eee. Modifies the \verb{thead, tfoot, tr:nth-child(even)} elements.}
  106. \item{base_font_size}{Base Font Size for All Slide Elements (must be \code{px}). Defaults to 20px. Modifies the \code{html} element.}
  107. \item{text_font_size}{Slide Body Text Font Size. Defaults to 1rem. Modifies the \code{.remark-slide-content} class.}
  108. \item{header_h1_font_size}{h1 Header Text Font Size. Defaults to 2.75rem. Modifies the \verb{.remark-slide-content h1} class.}
  109. \item{header_h2_font_size}{h2 Header Text Font Size. Defaults to 2.25rem. Modifies the \verb{.remark-slide-content h2} class.}
  110. \item{header_h3_font_size}{h3 Header Text Font Size. Defaults to 1.75rem. Modifies the \verb{.remark-slide-content h3} class.}
  111. \item{header_background_auto}{Add background under slide title automatically for h1 header elements. If not enabled, use \code{class: header_background} to enable. Defaults to \code{FALSE}.}
  112. \item{header_background_color}{Background Color for h1 Header with Background. Defaults to \code{header_color}. Modifies the \verb{.remark-slide-content h1} class.}
  113. \item{header_background_text_color}{Text Color for h1 Header with Background. Defaults to \code{background_color}. Modifies the \verb{.remark-slide-content h1} class.}
  114. \item{header_background_padding}{Padding for h1 Header with Background. Defaults to \code{NULL}. Modifies the \verb{.remark-slide-content h1} class.}
  115. \item{header_background_content_padding_top}{Top Padding for Content in Slide with Header with Background. Defaults to 7rem. Modifies the \code{.remark-slide-content} class.}
  116. \item{header_background_ignore_classes}{Slide Classes Where Header with Background will not be Applied. Defaults to \code{c('normal', 'inverse', 'title', 'middle', 'bottom')}. Modifies the \code{.remark-slide-content} class.}
  117. \item{text_slide_number_font_size}{Slide Number Text Font Size. Defaults to 0.9rem. Modifies the \code{.remark-slide-number} class.}
  118. \item{text_font_google}{Use \code{google_font()} to specify body font. Defaults to \code{NULL}. Modifies the \code{body} element.}
  119. \item{text_font_family}{Body Text Font Family (xaringan default is \code{'Droid Serif'}). Defaults to Noto Sans. Modifies the \code{body} element.}
  120. \item{text_font_weight}{Body Text Font Weight. Defaults to normal. Modifies the \code{body} element.}
  121. \item{text_font_url}{Body Text Font URL(s). Defaults to https://fonts.googleapis.com/css?family=Noto+Sans:400,400i,700,700i&display=swap. Modifies the \verb{@import url()} elements.}
  122. \item{text_font_family_fallback}{Body Text Font Fallbacks. Defaults to -apple-system, BlinkMacSystemFont, avenir next, avenir, helvetica neue, helvetica, Ubuntu, roboto, noto, segoe ui, arial. Modifies the \code{body} element.}
  123. \item{text_font_base}{Body Text Base Font (Total Failure Fallback). Defaults to sans-serif. Modifies the \code{body} element.}
  124. \item{header_font_google}{Use \code{google_font()} to specify header font. Defaults to \code{NULL}. Modifies the \code{body} element.}
  125. \item{header_font_family}{Header Font Family (xaringan default is \code{'Yanone Kaffeesatz'}). Defaults to Cabin. Modifies the \verb{h1, h2, h3} elements.}
  126. \item{header_font_weight}{Header Font Weight. Defaults to 600. Modifies the \verb{h1, h2, h3} elements.}
  127. \item{header_font_url}{Header Font URL. Defaults to https://fonts.googleapis.com/css?family=Cabin:600,600i&display=swap. Modifies the \verb{@import url} elements.}
  128. \item{code_font_google}{Use \code{google_font()} to specify code font. Defaults to \code{NULL}. Modifies the \code{body} element.}
  129. \item{code_font_family}{Code Font Family. Defaults to Source Code Pro. Modifies the \verb{.remark-code, .remark-inline-code} classes.}
  130. \item{code_font_size}{Code Text Font Size. Defaults to 0.9rem. Modifies the \code{.remark-inline} class.}
  131. \item{code_font_url}{Code Font URL. Defaults to https://fonts.googleapis.com/css?family=Source+Code+Pro:400,700&display=swap. Modifies the \verb{@import url} elements.}
  132. \item{code_font_family_fallback}{Code Font Fallback. Defaults to Menlo, Consolas, Monaco, Liberation Mono, Lucida Console. Modifies the \verb{.remark-code, .remark-inline-code} classes.}
  133. \item{colors}{A named vector of custom colors. The names of the colors
  134. become CSS variables and classes that can be used within your slides.
  135. For example, \code{colors = c(blue = "#bad4ed")} adds a CSS variable
  136. \code{--blue}, a \code{.blue} CSS class that applies the color to the text or
  137. foreground color, and a \code{.bg-blue} CSS class that applies the color
  138. to the background.}
  139. \item{extra_css}{A named list of CSS definitions each containing a named list
  140. of CSS property-value pairs, i.e.
  141. \code{list(".class-id" = list("css-property" = "value"))}}
  142. \item{extra_fonts}{A list of additional fonts to import, each list element
  143. can be either a URL as a character string or a call to
  144. \code{\link{google_font}()}}
  145. \item{outfile}{Customized xaringan CSS output file name, default is "xaringan-themer.css"}
  146. }
  147. \description{
  148. Creates a customized Xaringan theme CSS file.
  149. }
  150. \seealso{
  151. Other themes:
  152. \code{\link{style_duo_accent_inverse}()},
  153. \code{\link{style_duo_accent}()},
  154. \code{\link{style_duo}()},
  155. \code{\link{style_mono_accent_inverse}()},
  156. \code{\link{style_mono_accent}()},
  157. \code{\link{style_mono_dark}()},
  158. \code{\link{style_mono_light}()},
  159. \code{\link{style_solarized_dark}()},
  160. \code{\link{style_solarized_light}()}
  161. }
  162. \concept{themes}