R3port (version 0.2.5)

html_combine: Combines multiple HTML files to a single tex and compiles document

Description

This function combines multiple HTML files. This is done based on the name of the files and should end with raw.tex to make the function pick-up these files.

Usage

html_combine(
  combine = ".",
  out = NULL,
  toctheme = TRUE,
  css = paste0(system.file(package = "R3port"), "/style.css"),
  clean = 0,
  ...
)

Value

The function returns a HTML file (or writes output to console)

Arguments

combine

character string with the location of the raw html files or list with file names within same directory

out

filename for the output HTML file (if NULL it will print to console)

toctheme

logical indicating if the created file should also have a toc (take into account for template)

css

character with name of the css style sheet to use, default use package style sheet

clean

integer between 0 and 2 indicating if all individual files should be kept (0), all individual raw html files should be deleted (1) or all individual files should be deleted (2)

...

additional arguments passed through to html_doc. Most important are template, rendlist, css and show

Details

Currently the generated output is saved in the same place where the separate tables and plots are located defined in the 'combine' argument. This is done even when a different file path is specified in 'out' (using the basename function). The reason is to not copy files linked within the document and preventing broken links. This behaviour might change in future releases

Examples

# Take into account the usage of tempfile() with multiple function calls
data(Theoph)
html_list(Theoph[1:11,],out=tempfile(fileext=".html"),show=FALSE)
html_plot(plot(conc~Time,data=Theoph),out=tempfile(fileext=".html"),show=FALSE)
if (FALSE) {
  html_combine(combine=tempdir(),out="rep1.html")

  # toctheme can be used to have a clickable toc,
  # a bootstrap template for this is provided in the package
  html_combine(combine=tempdir(),out="rep1.html",
              template=paste0(system.file(package="R3port"),"/bootstrap.html"),
              toctheme=TRUE)
 }