Added column_spec function for HTML and LaTeX
diff --git a/R/column_spec.R b/R/column_spec.R
index e69de29..bc8ef7e 100644
--- a/R/column_spec.R
+++ b/R/column_spec.R
@@ -0,0 +1,92 @@
+#' Specify the look of the selected column
+#'
+#' @description This function allows users to select a column and then specify
+#' its look. Right now it supports the following three properties: column width,
+#' bold text and italic text.
+#'
+#' @param kable_input Output of `knitr::kable()` with `format` specified
+#' @param column A numeric value indicating which column to be selected
+#' @param width A character string telling HTML & LaTeX how wide the column
+#' needs to be, e.g. "10cm", "3in" or "30em".
+#' @param bold A T/F value to control whether the text of the selected column
+#' need to be bolded.
+#' @param italic A T/F value to control whether the text of the selected column
+#' need to be emphasized.
+#' @export
+column_spec <- function(kable_input, column, width, bold = F, italic = F) {
+ if (!is.numeric(column)) {
+ stop("column must be a numeric value")
+ }
+ kable_format <- attr(kable_input, "format")
+ if (!kable_format %in% c("html", "latex")) {
+ message("Currently generic markdown table using pandoc is not supported.")
+ return(kable_input)
+ }
+ if (kable_format == "html") {
+ return(column_spec_html(kable_input, column, width, bold, italic))
+ }
+ if (kable_format == "latex") {
+ return(column_spec_latex(kable_input, column, width, bold, italic))
+ }
+}
+
+column_spec_html <- function(kable_input, column, width, bold, italic) {
+ kable_attrs <- attributes(kable_input)
+ kable_xml <- read_xml(as.character(kable_input), options = "COMPACT")
+ kable_tbody <- xml_tpart(kable_xml, "tbody")
+
+ group_header_rows <- attr(kable_input, "group_header_rows")
+ all_contents_rows <- seq(1, length(kable_tbody))
+ if (!is.null(group_header_rows)) {
+ all_contents_rows <- all_contents_rows[!all_contents_rows %in%
+ group_header_rows]
+ }
+
+ for (i in all_contents_rows) {
+ target_cell <- xml_child(xml_child(kable_tbody, i), column)
+ if (!is.null(width)) {
+ xml_attr(target_cell, "style") <- paste0(xml_attr(target_cell, "style"),
+ "width: ", width, "; ")
+ }
+ if (bold) {
+ xml_attr(target_cell, "style") <- paste0(xml_attr(target_cell, "style"),
+ "font-weight: bold;")
+ }
+ if (italic) {
+ xml_attr(target_cell, "style") <- paste0(xml_attr(target_cell, "style"),
+ "font-style: italic;")
+ }
+ }
+ out <- structure(as.character(kable_xml), format = "html",
+ class = "knitr_kable")
+ attributes(out) <- kable_attrs
+ return(out)
+}
+
+column_spec_latex <- function(kable_input, column, width, bold, italic) {
+ table_info <- magic_mirror(kable_input)
+ align_collapse <- ifelse(table_info$booktabs, "", "\\|")
+ kable_align_old <- paste(table_info$align_vector, collapse = align_collapse)
+
+ if (!is.null(width)) {
+ table_info$align_vector[column] <- paste0("p\\{", width, "\\}")
+ }
+
+ if (bold | italic) {
+ usepackage_latex("array")
+ latex_array_options <- c("\\\\bfseries", "\\\\em")[c(bold, italic)]
+ latex_array_options <- paste0(
+ "\\>\\{", paste(latex_array_options, collapse = ""), "\\}"
+ )
+ table_info$align_vector[column] <- paste0(latex_array_options,
+ table_info$align_vector[column])
+ }
+
+ kable_align_new <- paste(table_info$align_vector, collapse = align_collapse)
+
+ out <- sub(kable_align_old, kable_align_new, as.character(kable_input),
+ perl = T)
+ out <- structure(out, format = "latex", class = "knitr_kable")
+ attr(out, "original_kable_meta") <- table_info
+ return(out)
+}