-
Notifications
You must be signed in to change notification settings - Fork 80
/
README.Rmd
106 lines (74 loc) · 3.17 KB
/
README.Rmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
---
title: "flextable R package"
output:
github_document
---
<!-- README.md is generated from README.Rmd. Please edit that file -->
[![R build status](https://github.com/davidgohel/flextable/workflows/R-CMD-check/badge.svg)](https://github.com/davidgohel/flextable/actions)
[![version](https://www.r-pkg.org/badges/version/flextable)](https://CRAN.R-project.org/package=flextable)
![Active](https://www.repostatus.org/badges/latest/active.svg)
```{r, echo = FALSE}
knitr::opts_chunk$set(
message = FALSE,
collapse = TRUE,
comment = "#>"
)
```
The flextable package provides a framework for easily create tables for
reporting and publications. Tables can be easily formatted with
a set of verbs such as `bold()`, `color()`, they can receive a
header of more than one line, cells can be merged or contain
an image. The package make it possible to build any table for
publication from a `data.frame` and provides sugar function
`as_flextable()` to convert several R objects to a flextable,
such as an object return from `table()` or a model.
```{r eval=FALSE}
set_flextable_defaults(
font.family = "Arial", font.size = 10,
border.color = "gray")
flextable(head(cars)) %>%
bold(part = "header") %>%
add_footer_lines("The 'cars' dataset")
ggplot2::diamonds |>
with(table(cut, color)) |>
as_flextable()
```
Tables can be embedded within HTML, PDF, Word and PowerPoint documents
from R Markdown documents and within RTF or Microsoft Word or PowerPoint
documents with package officer. Tables can also be rendered as R plots
or graphic files (png).
<img src="man/figures/fig_formats.png" width="170px" alt="flextable formats" align="center" />
```{r eval=FALSE}
flextable(mtcars) %>%
theme_vanilla() %>%
save_as_docx(path = "mytable.docx")
```
A `flextable` object is a data.frame representation. An API is available to let
R users create tables for reporting and control their formatting properties and
their layout. The package provides functions that give control over:
- header, body and footer content
- text, paragraphs, cells and border formatting of any element
- displayed values
The package also offers a set of high-level functions that allow tabular
reporting of statistical models and the creation of complex cross tabulations.
## Installation
```{r eval = FALSE}
install.packages("flextable")
```
You can get the development version from GitHub:
```{r eval = FALSE}
devtools::install_github("davidgohel/flextable")
```
## Resources
- User guide: https://ardata-fr.github.io/flextable-book/
- Manuals: https://davidgohel.github.io/flextable/reference/index.html
- Gallery of examples: https://ardata.fr/en/flextable-gallery/
### Getting help / questions
If you have questions about how to use the package, visit Stackoverflow and use
tags `flextable` and `r` [Stackoverflow
link](https://stackoverflow.com/questions/tagged/flextable+r). You can also use
<https://github.com/davidgohel/flextable/discussions> to start a discussion.
### Bug reports
When you file a [bug report](https://github.com/davidgohel/flextable/issues),
please spend some time making it easy for us to reproduce. If you
take the time to make the bug report consistent, it will be easier to fix.