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