Add `link_decoration` parameter to style functions (#57)

NEWS.md

@@ -13,6 +13,10 @@
   
 * xaringanthemer no longer sets the `fig.showtext` chunk option when the
   showtext package isn't installed (#56).
+ 
+* The style functions gain a `link_decoration` argument to set the
+  [`text-decoration`](https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration)
+  property for links (#57).
 
 # xaringanthemes 0.3.4
 

R/style_duo.R

@@ -266,6 +266,10 @@
 #' @param code_font_family_fallback Code Font Fallback. Defaults to
 #'   `xaringanthemer_font_default("code_font_family_fallback")`. Modifies the
 #'   `.remark-code, .remark-inline-code` classes.
+#' @param link_decoration Text decoration of links. Defaults to none. Modifies
+#'   the `a, a > code` elements. Accepts CSS
+#'   [text-decoration](https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration)
+#'   property values.
 #' @template theme_params
 #' @template style-usage
 #' @template style_duo
@@ -336,6 +340,7 @@ style_duo <- function(
   code_font_size = "0.9rem",
   code_font_url = xaringanthemer_font_default("code_font_url"),
   code_font_family_fallback = xaringanthemer_font_default("code_font_family_fallback"),
+  link_decoration = "none",
   colors = NULL,
   extra_css = NULL,
   extra_fonts = NULL,

R/style_duo_accent.R

@@ -278,6 +278,10 @@
 #' @param code_font_family_fallback Code Font Fallback. Defaults to
 #'   `xaringanthemer_font_default("code_font_family_fallback")`. Modifies the
 #'   `.remark-code, .remark-inline-code` classes.
+#' @param link_decoration Text decoration of links. Defaults to none. Modifies
+#'   the `a, a > code` elements. Accepts CSS
+#'   [text-decoration](https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration)
+#'   property values.
 #' @template theme_params
 #' @template style-usage
 #' @template style_duo_accent
@@ -350,6 +354,7 @@ style_duo_accent <- function(
   code_font_size = "0.9rem",
   code_font_url = xaringanthemer_font_default("code_font_url"),
   code_font_family_fallback = xaringanthemer_font_default("code_font_family_fallback"),
+  link_decoration = "none",
   colors = NULL,
   extra_css = NULL,
   extra_fonts = NULL,

R/style_duo_accent_inverse.R

@@ -279,6 +279,10 @@
 #' @param code_font_family_fallback Code Font Fallback. Defaults to
 #'   `xaringanthemer_font_default("code_font_family_fallback")`. Modifies the
 #'   `.remark-code, .remark-inline-code` classes.
+#' @param link_decoration Text decoration of links. Defaults to none. Modifies
+#'   the `a, a > code` elements. Accepts CSS
+#'   [text-decoration](https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration)
+#'   property values.
 #' @template theme_params
 #' @template style-usage
 #' @template style_duo_accent_inverse
@@ -351,6 +355,7 @@ style_duo_accent_inverse <- function(
   code_font_size = "0.9rem",
   code_font_url = xaringanthemer_font_default("code_font_url"),
   code_font_family_fallback = xaringanthemer_font_default("code_font_family_fallback"),
+  link_decoration = "none",
   colors = NULL,
   extra_css = NULL,
   extra_fonts = NULL,

R/style_mono_accent.R

@@ -269,6 +269,10 @@
 #' @param code_font_family_fallback Code Font Fallback. Defaults to
 #'   `xaringanthemer_font_default("code_font_family_fallback")`. Modifies the
 #'   `.remark-code, .remark-inline-code` classes.
+#' @param link_decoration Text decoration of links. Defaults to none. Modifies
+#'   the `a, a > code` elements. Accepts CSS
+#'   [text-decoration](https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration)
+#'   property values.
 #' @template theme_params
 #' @template style-usage
 #' @template style_mono_accent
@@ -340,6 +344,7 @@ style_mono_accent <- function(
   code_font_size = "0.9rem",
   code_font_url = xaringanthemer_font_default("code_font_url"),
   code_font_family_fallback = xaringanthemer_font_default("code_font_family_fallback"),
+  link_decoration = "none",
   colors = NULL,
   extra_css = NULL,
   extra_fonts = NULL,

R/style_mono_accent_inverse.R

@@ -270,6 +270,10 @@
 #' @param code_font_family_fallback Code Font Fallback. Defaults to
 #'   `xaringanthemer_font_default("code_font_family_fallback")`. Modifies the
 #'   `.remark-code, .remark-inline-code` classes.
+#' @param link_decoration Text decoration of links. Defaults to none. Modifies
+#'   the `a, a > code` elements. Accepts CSS
+#'   [text-decoration](https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration)
+#'   property values.
 #' @template theme_params
 #' @template style-usage
 #' @template style_mono_accent_inverse
@@ -341,6 +345,7 @@ style_mono_accent_inverse <- function(
   code_font_size = "0.9rem",
   code_font_url = xaringanthemer_font_default("code_font_url"),
   code_font_family_fallback = xaringanthemer_font_default("code_font_family_fallback"),
+  link_decoration = "none",
   colors = NULL,
   extra_css = NULL,
   extra_fonts = NULL,

R/style_mono_dark.R

@@ -271,6 +271,10 @@
 #' @param code_font_family_fallback Code Font Fallback. Defaults to
 #'   `xaringanthemer_font_default("code_font_family_fallback")`. Modifies the
 #'   `.remark-code, .remark-inline-code` classes.
+#' @param link_decoration Text decoration of links. Defaults to none. Modifies
+#'   the `a, a > code` elements. Accepts CSS
+#'   [text-decoration](https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration)
+#'   property values.
 #' @template theme_params
 #' @template style-usage
 #' @template style_mono_dark
@@ -342,6 +346,7 @@ style_mono_dark <- function(
   code_font_size = "0.9rem",
   code_font_url = xaringanthemer_font_default("code_font_url"),
   code_font_family_fallback = xaringanthemer_font_default("code_font_family_fallback"),
+  link_decoration = "none",
   colors = NULL,
   extra_css = NULL,
   extra_fonts = NULL,

R/style_mono_light.R

@@ -271,6 +271,10 @@
 #' @param code_font_family_fallback Code Font Fallback. Defaults to
 #'   `xaringanthemer_font_default("code_font_family_fallback")`. Modifies the
 #'   `.remark-code, .remark-inline-code` classes.
+#' @param link_decoration Text decoration of links. Defaults to none. Modifies
+#'   the `a, a > code` elements. Accepts CSS
+#'   [text-decoration](https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration)
+#'   property values.
 #' @template theme_params
 #' @template style-usage
 #' @template style_mono_light
@@ -342,6 +346,7 @@ style_mono_light <- function(
   code_font_size = "0.9rem",
   code_font_url = xaringanthemer_font_default("code_font_url"),
   code_font_family_fallback = xaringanthemer_font_default("code_font_family_fallback"),
+  link_decoration = "none",
   colors = NULL,
   extra_css = NULL,
   extra_fonts = NULL,

R/style_solarized_dark.R

@@ -256,6 +256,10 @@
 #' @param code_font_family_fallback Code Font Fallback. Defaults to
 #'   `xaringanthemer_font_default("code_font_family_fallback")`. Modifies the
 #'   `.remark-code, .remark-inline-code` classes.
+#' @param link_decoration Text decoration of links. Defaults to none. Modifies
+#'   the `a, a > code` elements. Accepts CSS
+#'   [text-decoration](https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration)
+#'   property values.
 #' @template theme_params
 #' @template style-usage
 #' @template style_solarized_dark
@@ -324,6 +328,7 @@ style_solarized_dark <- function(
   code_font_size = "0.9rem",
   code_font_url = xaringanthemer_font_default("code_font_url"),
   code_font_family_fallback = xaringanthemer_font_default("code_font_family_fallback"),
+  link_decoration = "none",
   colors = NULL,
   extra_css = NULL,
   extra_fonts = NULL,

R/style_solarized_light.R

@@ -256,6 +256,10 @@
 #' @param code_font_family_fallback Code Font Fallback. Defaults to
 #'   `xaringanthemer_font_default("code_font_family_fallback")`. Modifies the
 #'   `.remark-code, .remark-inline-code` classes.
+#' @param link_decoration Text decoration of links. Defaults to none. Modifies
+#'   the `a, a > code` elements. Accepts CSS
+#'   [text-decoration](https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration)
+#'   property values.
 #' @template theme_params
 #' @template style-usage
 #' @template style_solarized_light
@@ -324,6 +328,7 @@ style_solarized_light <- function(
   code_font_size = "0.9rem",
   code_font_url = xaringanthemer_font_default("code_font_url"),
   code_font_family_fallback = xaringanthemer_font_default("code_font_family_fallback"),
+  link_decoration = "none",
   colors = NULL,
   extra_css = NULL,
   extra_fonts = NULL,

R/style_xaringan.R

@@ -256,6 +256,10 @@
 #' @param code_font_family_fallback Code Font Fallback. Defaults to
 #'   `xaringanthemer_font_default("code_font_family_fallback")`. Modifies the
 #'   `.remark-code, .remark-inline-code` classes.
+#' @param link_decoration Text decoration of links. Defaults to none. Modifies
+#'   the `a, a > code` elements. Accepts CSS
+#'   [text-decoration](https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration)
+#'   property values.
 #' @template theme_params
 #' @template style-usage
 #' @template style_xaringan
@@ -323,6 +327,7 @@ style_xaringan <- function(
   code_font_size = "0.9rem",
   code_font_url = xaringanthemer_font_default("code_font_url"),
   code_font_family_fallback = xaringanthemer_font_default("code_font_family_fallback"),
+  link_decoration = "none",
   colors = NULL,
   extra_css = NULL,
   extra_fonts = NULL,

data-raw/theme_template_variables.R

@@ -63,6 +63,7 @@ template_variables <- tibble::tribble(
   , "code_font_size", "0.9rem", ".remark-inline", "Code Text Font Size", "--code-font-size"
   , "code_font_url", '{xaringanthemer_font_default("code_font_url")}', "@import url", "Code Font URL", NA_character_
   , "code_font_family_fallback", '{xaringanthemer_font_default("code_font_family_fallback")}', ".remark-code, .remark-inline-code", "Code Font Fallback", NA_character_
+  , "link_decoration", "none", "a, a > code", "Text decoration of links", NA_character_
 )
 
 set_default <- function(tv, ..., set_var = "default") {
@@ -99,7 +100,8 @@ template_variables <- set_default(
   text_slide_number_font_size = mdn_font_size,
   text_font_weight = mdn_font_weight,
   header_font_weight = mdn_font_weight,
-  code_font_size = mdn_font_size
+  code_font_size = mdn_font_size,
+  link_decoration = "[text-decoration](https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration)"
 )
 
 template_mono_light <- tibble::tribble(

inst/resources/template.css

@@ -116,7 +116,7 @@ strong {
 }
 a, a > code {
   color: var(--link-color);
-  text-decoration: none;
+  text-decoration: {{link_decoration}};
 }
 .footnote {
   position: absolute;{{#footnote_color}}

man/style_duo.Rd

@@ -71,6 +71,7 @@ style_duo(
   code_font_size = "0.9rem",
   code_font_url = xaringanthemer_font_default("code_font_url"),
   code_font_family_fallback = xaringanthemer_font_default("code_font_family_fallback"),
+  link_decoration = "none",
   colors = NULL,
   extra_css = NULL,
   extra_fonts = NULL,
@@ -408,6 +409,11 @@ elements.}
 \code{xaringanthemer_font_default("code_font_family_fallback")}. Modifies the
 \verb{.remark-code, .remark-inline-code} classes.}
 
+\item{link_decoration}{Text decoration of links. Defaults to none. Modifies
+the \verb{a, a > code} elements. Accepts CSS
+\href{https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration}{text-decoration}
+property values.}
+
 \item{colors}{A named vector of custom colors. The names of the colors
 become CSS variables and classes that can be used within your slides.
 For example, \code{colors = c(blue = "#bad4ed")} adds a CSS variable

man/style_duo_accent.Rd

@@ -76,6 +76,7 @@ style_duo_accent(
   code_font_size = "0.9rem",
   code_font_url = xaringanthemer_font_default("code_font_url"),
   code_font_family_fallback = xaringanthemer_font_default("code_font_family_fallback"),
+  link_decoration = "none",
   colors = NULL,
   extra_css = NULL,
   extra_fonts = NULL,
@@ -427,6 +428,11 @@ elements.}
 \code{xaringanthemer_font_default("code_font_family_fallback")}. Modifies the
 \verb{.remark-code, .remark-inline-code} classes.}
 
+\item{link_decoration}{Text decoration of links. Defaults to none. Modifies
+the \verb{a, a > code} elements. Accepts CSS
+\href{https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration}{text-decoration}
+property values.}
+
 \item{colors}{A named vector of custom colors. The names of the colors
 become CSS variables and classes that can be used within your slides.
 For example, \code{colors = c(blue = "#bad4ed")} adds a CSS variable

man/style_duo_accent_inverse.Rd

@@ -77,6 +77,7 @@ style_duo_accent_inverse(
   code_font_size = "0.9rem",
   code_font_url = xaringanthemer_font_default("code_font_url"),
   code_font_family_fallback = xaringanthemer_font_default("code_font_family_fallback"),
+  link_decoration = "none",
   colors = NULL,
   extra_css = NULL,
   extra_fonts = NULL,
@@ -429,6 +430,11 @@ elements.}
 \code{xaringanthemer_font_default("code_font_family_fallback")}. Modifies the
 \verb{.remark-code, .remark-inline-code} classes.}
 
+\item{link_decoration}{Text decoration of links. Defaults to none. Modifies
+the \verb{a, a > code} elements. Accepts CSS
+\href{https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration}{text-decoration}
+property values.}
+
 \item{colors}{A named vector of custom colors. The names of the colors
 become CSS variables and classes that can be used within your slides.
 For example, \code{colors = c(blue = "#bad4ed")} adds a CSS variable

man/style_mono_accent.Rd

@@ -71,6 +71,7 @@ style_mono_accent(
   code_font_size = "0.9rem",
   code_font_url = xaringanthemer_font_default("code_font_url"),
   code_font_family_fallback = xaringanthemer_font_default("code_font_family_fallback"),
+  link_decoration = "none",
   colors = NULL,
   extra_css = NULL,
   extra_fonts = NULL,
@@ -412,6 +413,11 @@ elements.}
 \code{xaringanthemer_font_default("code_font_family_fallback")}. Modifies the
 \verb{.remark-code, .remark-inline-code} classes.}
 
+\item{link_decoration}{Text decoration of links. Defaults to none. Modifies
+the \verb{a, a > code} elements. Accepts CSS
+\href{https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration}{text-decoration}
+property values.}
+
 \item{colors}{A named vector of custom colors. The names of the colors
 become CSS variables and classes that can be used within your slides.
 For example, \code{colors = c(blue = "#bad4ed")} adds a CSS variable

man/style_mono_accent_inverse.Rd

@@ -71,6 +71,7 @@ style_mono_accent_inverse(
   code_font_size = "0.9rem",
   code_font_url = xaringanthemer_font_default("code_font_url"),
   code_font_family_fallback = xaringanthemer_font_default("code_font_family_fallback"),
+  link_decoration = "none",
   colors = NULL,
   extra_css = NULL,
   extra_fonts = NULL,
@@ -413,6 +414,11 @@ elements.}
 \code{xaringanthemer_font_default("code_font_family_fallback")}. Modifies the
 \verb{.remark-code, .remark-inline-code} classes.}
 
+\item{link_decoration}{Text decoration of links. Defaults to none. Modifies
+the \verb{a, a > code} elements. Accepts CSS
+\href{https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration}{text-decoration}
+property values.}
+
 \item{colors}{A named vector of custom colors. The names of the colors
 become CSS variables and classes that can be used within your slides.
 For example, \code{colors = c(blue = "#bad4ed")} adds a CSS variable

man/style_mono_dark.Rd

@@ -71,6 +71,7 @@ style_mono_dark(
   code_font_size = "0.9rem",
   code_font_url = xaringanthemer_font_default("code_font_url"),
   code_font_family_fallback = xaringanthemer_font_default("code_font_family_fallback"),
+  link_decoration = "none",
   colors = NULL,
   extra_css = NULL,
   extra_fonts = NULL,
@@ -414,6 +415,11 @@ elements.}
 \code{xaringanthemer_font_default("code_font_family_fallback")}. Modifies the
 \verb{.remark-code, .remark-inline-code} classes.}
 
+\item{link_decoration}{Text decoration of links. Defaults to none. Modifies
+the \verb{a, a > code} elements. Accepts CSS
+\href{https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration}{text-decoration}
+property values.}
+
 \item{colors}{A named vector of custom colors. The names of the colors
 become CSS variables and classes that can be used within your slides.
 For example, \code{colors = c(blue = "#bad4ed")} adds a CSS variable

man/style_mono_light.Rd

@@ -71,6 +71,7 @@ style_mono_light(
   code_font_size = "0.9rem",
   code_font_url = xaringanthemer_font_default("code_font_url"),
   code_font_family_fallback = xaringanthemer_font_default("code_font_family_fallback"),
+  link_decoration = "none",
   colors = NULL,
   extra_css = NULL,
   extra_fonts = NULL,
@@ -414,6 +415,11 @@ elements.}
 \code{xaringanthemer_font_default("code_font_family_fallback")}. Modifies the
 \verb{.remark-code, .remark-inline-code} classes.}
 
+\item{link_decoration}{Text decoration of links. Defaults to none. Modifies
+the \verb{a, a > code} elements. Accepts CSS
+\href{https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration}{text-decoration}
+property values.}
+
 \item{colors}{A named vector of custom colors. The names of the colors
 become CSS variables and classes that can be used within your slides.
 For example, \code{colors = c(blue = "#bad4ed")} adds a CSS variable

man/style_solarized_dark.Rd

@@ -68,6 +68,7 @@ style_solarized_dark(
   code_font_size = "0.9rem",
   code_font_url = xaringanthemer_font_default("code_font_url"),
   code_font_family_fallback = xaringanthemer_font_default("code_font_family_fallback"),
+  link_decoration = "none",
   colors = NULL,
   extra_css = NULL,
   extra_fonts = NULL,
@@ -393,6 +394,11 @@ elements.}
 \code{xaringanthemer_font_default("code_font_family_fallback")}. Modifies the
 \verb{.remark-code, .remark-inline-code} classes.}
 
+\item{link_decoration}{Text decoration of links. Defaults to none. Modifies
+the \verb{a, a > code} elements. Accepts CSS
+\href{https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration}{text-decoration}
+property values.}
+
 \item{colors}{A named vector of custom colors. The names of the colors
 become CSS variables and classes that can be used within your slides.
 For example, \code{colors = c(blue = "#bad4ed")} adds a CSS variable

man/style_solarized_light.Rd

@@ -68,6 +68,7 @@ style_solarized_light(
   code_font_size = "0.9rem",
   code_font_url = xaringanthemer_font_default("code_font_url"),
   code_font_family_fallback = xaringanthemer_font_default("code_font_family_fallback"),
+  link_decoration = "none",
   colors = NULL,
   extra_css = NULL,
   extra_fonts = NULL,
@@ -393,6 +394,11 @@ elements.}
 \code{xaringanthemer_font_default("code_font_family_fallback")}. Modifies the
 \verb{.remark-code, .remark-inline-code} classes.}
 
+\item{link_decoration}{Text decoration of links. Defaults to none. Modifies
+the \verb{a, a > code} elements. Accepts CSS
+\href{https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration}{text-decoration}
+property values.}
+
 \item{colors}{A named vector of custom colors. The names of the colors
 become CSS variables and classes that can be used within your slides.
 For example, \code{colors = c(blue = "#bad4ed")} adds a CSS variable

man/style_xaringan.Rd

@@ -71,6 +71,7 @@ style_xaringan(
   code_font_size = "0.9rem",
   code_font_url = xaringanthemer_font_default("code_font_url"),
   code_font_family_fallback = xaringanthemer_font_default("code_font_family_fallback"),
+  link_decoration = "none",
   colors = NULL,
   extra_css = NULL,
   extra_fonts = NULL,
@@ -399,6 +400,11 @@ elements.}
 \code{xaringanthemer_font_default("code_font_family_fallback")}. Modifies the
 \verb{.remark-code, .remark-inline-code} classes.}
 
+\item{link_decoration}{Text decoration of links. Defaults to none. Modifies
+the \verb{a, a > code} elements. Accepts CSS
+\href{https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration}{text-decoration}
+property values.}
+
 \item{colors}{A named vector of custom colors. The names of the colors
 become CSS variables and classes that can be used within your slides.
 For example, \code{colors = c(blue = "#bad4ed")} adds a CSS variable