Hao Zhu | cdd7f92 | 2018-01-08 11:39:40 -0500 | [diff] [blame] | 1 | % Generated by roxygen2: do not edit by hand |
| 2 | % Please edit documentation in R/footnote.R |
| 3 | \name{footnote} |
| 4 | \alias{footnote} |
| 5 | \title{Add footnote (new)} |
| 6 | \usage{ |
| 7 | footnote(kable_input, general = NULL, number = NULL, alphabet = NULL, |
| 8 | symbol = NULL, footnote_order = c("general", "number", "alphabet", |
Hao Zhu | e0782ab | 2018-01-09 13:24:13 -0500 | [diff] [blame] | 9 | "symbol"), footnote_as_chunk = FALSE, escape = TRUE, |
Hao Zhu | 72917f9 | 2019-03-15 18:41:42 -0400 | [diff] [blame] | 10 | threeparttable = FALSE, fixed_small_size = FALSE, |
| 11 | general_title = "Note: ", number_title = "", alphabet_title = "", |
| 12 | symbol_title = "", title_format = "italic", symbol_manual = NULL) |
Hao Zhu | e0782ab | 2018-01-09 13:24:13 -0500 | [diff] [blame] | 13 | } |
| 14 | \arguments{ |
| 15 | \item{kable_input}{HTML or LaTeX table generated by \code{knitr::kable}} |
| 16 | |
| 17 | \item{general}{Text for general footnote comments. Footnotes in this section |
| 18 | won't be labeled with any notations} |
| 19 | |
| 20 | \item{number}{A vector of footnote texts. Footnotes here will be numbered. |
| 21 | There is no upper cap for the number of footnotes here} |
| 22 | |
| 23 | \item{alphabet}{A vector of footnote texts, Footnotes here will be labeled |
| 24 | with abc. The vector here should not have more than 26 elements.} |
| 25 | |
| 26 | \item{symbol}{A vector of footnote texts, Footnotes here will be labeled |
| 27 | with special symbols. The vector here should not have more than 20 elements.} |
| 28 | |
| 29 | \item{footnote_order}{The order of how to arrange \code{general}, \code{number}, |
| 30 | \code{alphabet} and \code{symbol}.} |
| 31 | |
| 32 | \item{footnote_as_chunk}{T/F value. Default is FALSE. It controls whether |
| 33 | the footnotes should be printed in a chunk (without line break).} |
| 34 | |
| 35 | \item{escape}{T/F value. It controls whether the contents and titles should |
| 36 | be escaped against HTML or LaTeX. Default is TRUE.} |
| 37 | |
Hao Zhu | eaef431 | 2018-01-10 17:05:23 -0500 | [diff] [blame] | 38 | \item{threeparttable}{T/F value for whether to use LaTeX package |
| 39 | threeparttable. Threeparttable will force the width of caption and |
| 40 | footnotes be the width of the original table. It's useful when you have |
| 41 | long paragraph of footnotes.} |
| 42 | |
Hao Zhu | 72917f9 | 2019-03-15 18:41:42 -0400 | [diff] [blame] | 43 | \item{fixed_small_size}{T/F When you want to keep the footnote small after |
| 44 | specifying large font size with the kable_styling() (e.g. ideal font for headers |
| 45 | and table content with small font in footnotes).} |
| 46 | |
Hao Zhu | e0782ab | 2018-01-09 13:24:13 -0500 | [diff] [blame] | 47 | \item{general_title}{Section header for general footnotes. Default is |
| 48 | "Note: ".} |
| 49 | |
| 50 | \item{number_title}{Section header for number footnotes. Default is "".} |
| 51 | |
| 52 | \item{alphabet_title}{Section header for alphabet footnotes. Default is "".} |
| 53 | |
| 54 | \item{symbol_title}{Section header for symbol footnotes. Default is "".} |
Hao Zhu | 6107f37 | 2018-05-21 00:23:26 -0400 | [diff] [blame] | 55 | |
| 56 | \item{title_format}{Choose from "italic"(default), "bold" and "underline". |
| 57 | Multiple options are possible.} |
Hao Zhu | 149faed | 2018-10-23 16:36:22 -0400 | [diff] [blame] | 58 | |
| 59 | \item{symbol_manual}{User can manually supply a vector of either html or |
| 60 | latex symbols. For example, \code{symbol_manual = c('*', '\\\\dag', '\\\\ddag')}.`} |
Hao Zhu | cdd7f92 | 2018-01-08 11:39:40 -0500 | [diff] [blame] | 61 | } |
| 62 | \description{ |
Hao Zhu | e0782ab | 2018-01-09 13:24:13 -0500 | [diff] [blame] | 63 | \code{footnote} provides a more flexible way to add footnote. You |
| 64 | can add mutiple sets of footnote using differeny notation system. It is |
| 65 | also possible to specify footnote section header one by one and print |
| 66 | footnotes as a chunk of texts. |
Hao Zhu | cdd7f92 | 2018-01-08 11:39:40 -0500 | [diff] [blame] | 67 | } |
Hao Zhu | 593f57e | 2018-01-09 13:30:01 -0500 | [diff] [blame] | 68 | \examples{ |
Hao Zhu | b1e2e3d | 2018-01-09 13:31:42 -0500 | [diff] [blame] | 69 | dt <- mtcars[1:5, 1:5] |
Hao Zhu | 593f57e | 2018-01-09 13:30:01 -0500 | [diff] [blame] | 70 | footnote(knitr::kable(dt, "html"), alphabet = c("Note a", "Note b")) |
| 71 | |
| 72 | } |