write_docx: Produces the final Docx file

In shug0131/cctu: In-House Functions for Report Writing at Cambridge Clinical Trials Unit

Produces the final Docx file

Description

Produces the final Docx file

Usage

write_docx(
  report_title,
  author,
  meta_table = get_meta_table(),
  filename = file.path(getOption("cctu_output", default = "Output"), "Reports",
    "Report.docx"),
  table_path = file.path(getOption("cctu_output", default = "Output"), "Core"),
  figure_format = "png",
  figure_path = file.path(getOption("cctu_output", default = "Output"), "Figures"),
  popn_labels = NULL,
  verbose = options()$verbose,
  keep_xml = FALSE
)

Arguments

report_title	text string used to label the report title page
author	text string naming the author
meta_table	a data frame that contains meta information on tables (title, population, number). Defaults is get_meta_table()
filename	text string giving the filename/path to output the word document to
table_path	text string giving the filepath to the tables folder. This is used to directly open table files and copy the content.
figure_format	it only supports png format.
figure_path	text string giving the filepath to the figures folder. This is used to create a reference within the word document. Hence it needs to be a relative (to the output report) path "../Figures". Likely to lead to empty figures in the report if it is changed.
popn_labels	alternative text string giving labels used for the population - might want to include the population size... They must match correctly to unique(meta_table$population), excluding rows with a blank, or no, population given
verbose	logical to print information on changes to the global environment or external files. Defaults to options()$verbose.
keep_xml	a boolean if the compiled XML should be kept, used for debugging purpose.

Details

suggest that file.path is used to create non default file paths, to cope with OS vaguaries.

Value

This function is run for its side-effects: creates an xml document that glues together all the outputs and meta data as per the meta-table argument; a transformation fo this as per the xslt file, the default can be opened as a word document.

shug0131/cctu documentation built on Feb. 15, 2025, 3:27 p.m.