docorator (version 0.5.2)

docorate: Decorate and output a table, listing, or figure to a file

Description

This function was deprecated and replaced with as_docorator and a corresponding render function i.e render_pdf

Usage

docorate(
  x,
  filename,
  path = NULL,
  header = fancyhead(fancyrow(right = doc_pagenum())),
  footer = fancyfoot(fancyrow(left = doc_path(filename, path), right = doc_datetime())),
  ...,
  fontsize = 10,
  geometry = geom_set(),
  fig_dim = c(5, 8),
  tbl_scale = TRUE,
  tbl_stub_pct = 0.3
)

Value

This function is called for its side effects

Arguments

x

object containing the display. See @details for more information.

filename

required name of file including extension (note: only PDF supported currently)

path

optional path to save the output pdf to

header

Document header. Accepts a fancyhead object. If NULL, no header will be displayed.

footer

Document footer Accepts a fancyfoot object. If NULL, no footer will be displayed.

...

These dots are for future extensions and must be empty.

fontsize

Font size (pt). Defaults to 10. Accepted values: 10, 11, 12.

geometry

Document sizing options based on the geometry latex package. Accepts a named list. Default is geom_set().

fig_dim

vector containing figure height and width in inches. Defaults to c(5,8)

tbl_scale

Boolean for whether or not to automatically scale table columns to fit display area. Defaults to TRUE. Note that this will overwrite scaling set in the table directly unless set to FALSE.

tbl_stub_pct

percent of total width that should be dedicated to stub column(s). If more than 1 stub column then this is the total for both.

Details

While the x argument flexibly accepts many different R objects, the following classes/types are recommended:

• gt

• gt_group (list of gt objects)

• ggplot

• list of ggplots

• path to PNG file created via png_path()

• list of paths to PNG files created via png_path()

Examples

if (FALSE) {
gt::gtcars |>
  dplyr::slice_head(n = 10) |>
  dplyr::select(mfr, model, year, msrp) |>
  gt::gt(groupname_col = "mfr",
         row_group_as_column = TRUE) |>
  docorate(
   header = fancyhead(fancyrow("Header 1"), fancyrow("Header 2")),
   filename = "mytbl.pdf")
 }