Available Options
Options can be set with options()
and change the default behavior of tinytable. You can either set them in a script (usually at the top) or via .Rprofile
. Note that you want to be cautious with putting things in .Rprofile
since they might make results not reproducible (e.g. if you change tinytable_format_digits
in .Rprofile
, the table will be formatted differently).
Default values for function arguments
Most options are function specific and allow you to set default values. These all start with tinytable_X_
where X is tt
/format
/theme
/print
. See the corresponding help documentation for the what the argument looks like.
tt()
Sets default values for tt()
arguments.
tinytable_tt_digits
tinytable_tt_caption
tinytable_tt_notes
tinytable_tt_width
tinytable_tt_theme
tinytable_tt_rownames
format_tt()
Sets default formats for different kinds of variables. see format_tt()
tinytable_format_digits
tinytable_format_num_fmt
tinytable_format_num_zero
tinytable_format_num_suffix
tinytable_format_num_mark_big
tinytable_format_num_mark_dec
tinytable_format_date
tinytable_format_bool
tinytable_format_other
tinytable_format_replace
tinytable_format_escape
tinytable_format_markdown
tinytable_format_quarto
tinytable_format_fn
tinytable_format_sprintf
theme_tt()
When using theme_tt(theme = "theme_name")
, this allows you to set default arguments to the corresponding theme. See theme_tt()
for details.
placement - tinytable_theme_placement_float
- tinytable_theme_placement_horizontal
resize - tinytable_theme_resize_width
- tinytable_theme_resize_direction
multipate - tinytable_theme_multipage_rowhead
- tinytable_theme_multipage_rowfoot
tabular - tinytable_theme_tabular_style
print.tinytable()
tinytable_print_output
Global options
The rest of the options are a set of global options that apply when the tables are being built.
HTML
- EXPERIMENTAL
options(tinytable_html_mathjax = TRUE)
inserts MathJax scripts in the HTML document. Warning: This may conflict with other elements of the page if MathJax is otherwise loaded.
options(tinytable_pdf_clean = TRUE)
deletes temporary and log files.options(tinytable_pdf_engine = "xelatex")
: “xelatex”, “pdflatex”, “lualatex”
Quarto
The format_tt(quarto=TRUE)
argument activates Quarto data processing for specific cells. This funcationality comes with a few warnings:
- Currently, Quarto provides a
\QuartoMarkdownBase64{}
LaTeX macro, but it does not appear to do anything with it. References and markdown codes may not be processed as expected in LaTeX. - Quarto data processing can enter in conflict with
tinytable
styling or formatting options. See below for how to disable it.
options(tinytable_quarto_disable_processing = TRUE)
disables Quarto processing of cell content.Setting this global option to
FALSE
may lead to conflicts with sometinytable
features, but it also allows use of markdown and Quarto-specific code in table cells, such as cross-references.<- data.frame(Math = "x^2^", Citation = "@Lovelace1842") x <- function(z) sprintf("<span data-qmd='%s'></span>", z) fn tt(x) |> format_tt(i = 1, fn = fn)
See this link for more details: https://quarto.org/docs/authoring/tables.html#disabling-quarto-table-processing