Shows what a template offers the report builders: every layout, its master,
and the placeholders it carries. Useful to decide which layout to name in
report_add_slide(), or to sanity-check an organisation template before
building a deck against it.
Usage
report_layouts(template = NULL, style = c("elevated", "plain"))Arguments
- template
Path to a
.pptx, an existing document fromreport_new(), orNULL(default) for the brand template registered byuse_brand()(falling back to a built-in template, seestyle).- style
Built-in template to inspect when no
templateand no brand template are set:"elevated"(default) or"plain". Seereport_new().
Value
A tibble with one row per layout: layout,
master, has_title, n_body, body_width, body_height (inches of
the first body placeholder, NA when the layout has none).
Details
The report builders pick layouts automatically by inspecting placeholders,
so most decks never need this – but when a corporate template offers
several content layouts, report_layouts() plus an explicit
report_add_slide(layout = ...) gives you full control. Requires the
suggested officer package.
See also
report_new(), report_add_slide(), use_brand().
Other reporting:
example_report(),
list_report_templates(),
report_add_plot(),
report_add_slide(),
report_add_table(),
report_add_text(),
report_deck(),
report_new(),
report_save(),
report_section(),
report_slide(),
report_title_slide(),
scaffold_report()
Examples
report_layouts()
#> # A tibble: 11 × 6
#> layout master has_title n_body body_width body_height
#> <chr> <chr> <lgl> <int> <dbl> <dbl>
#> 1 Blank Office Theme FALSE 0 NA NA
#> 2 Comparison Office Theme TRUE 4 5.64 0.9
#> 3 Content with Caption Office Theme TRUE 2 6.75 5.33
#> 4 Picture with Caption Office Theme TRUE 1 4.3 4.17
#> 5 Section Header Office Theme TRUE 1 11.5 1.64
#> 6 Title Only Office Theme TRUE 0 NA NA
#> 7 Title Slide Office Theme TRUE 0 NA NA
#> 8 Title and Content Office Theme TRUE 1 11.5 4.76
#> 9 Title and Vertical Text Office Theme TRUE 1 11.5 4.76
#> 10 Two Content Office Theme TRUE 2 5.67 4.76
#> 11 Vertical Title and Text Office Theme TRUE 1 8.46 6.36