setup_MarkdownReports: setup_MarkdownReports

Description Usage Arguments Examples

Description

Setup the markdown report file and the output directory, create a sub directory in "OutDir". Its name is stamped with the script name and the modification time. Create the "path_of_report" variable used by all log-writing and ~wplot functions.

Usage

1
2
3
4
5
6
setup_MarkdownReports(OutDir = getwd(), scriptname = basename(OutDir),
  title = "", setDir = T, append = F, addTableOfContents = F,
  b.defSize = c(def = 7, A4 = 8.27, `1col.nature` = 3.5, `2col.nature` = 7.2,
  `1col.cell` = 3.35, `1.5col.cell` = 4.49, `2col.cell` = 6.85)[1],
  b.defSize.fullpage = 8.27, b.usepng = F, b.png4Github = T,
  b.mdlink = T, b.save.wplots = T)

Arguments

OutDir

The output directory (absolute / full path).

title

Manually set the title of the report.

append

Set append to TRUE if you do not want to overwrite the previous report. Use continue_logging_markdown() if you return logging into an existing report. FALSE by default: rerunning the script overwrites the previous report. Archive reports manually into the timestamped subfolder within the OutDir.

addTableOfContents

write '[TOC]' below the header of the file, This is compiled to a proper Table Of Contents by, e.g. Typora.

b.defSize

Default width of plot EXCEPT in pdfA4plot_on(), assuming h=w by default. c("def"= 7, "A4" = 8.27, "1col.nature" = 3.50, "2col.nature" = 7.20, "1col.cell" = 3.35, "1.5col.cell" = 4.49, "2col.cell" = 6.85)

b.defSize.fullpage

Default width of plot in pdfA4plot_on()A global background variable used by pdfA4plot_on.

b.usepng

A global background variable used by the plotting functions. If TRUE, a link to the .png versions of the saved plot will be created. The .png file itself is not created.

b.png4Github

A global background variable used by the plotting functions. If TRUE (default), the link to the .png versions of the saved plot will be created in a GitHub compatible format. That means, when you upload your markdown report and the .png images to your GitHub wiki under "Reports/" the links will correctly display the images online.

b.mdlink

A global background variable used by the plotting functions. If TRUE (default), all saved (.pdf) plots will be linked into your report.

b.save.wplots

A global background variable used by the plotting functions. If TRUE (default), plots will be saved to a .pdf file.

b.scriptname

Name of the script (file) generating the report. "b.scriptname" will be used as the default title for the report. It is assigned to the global environment and used in pdf's title field to denote which script generated the file.

Examples

1
setup_logging_markdown (scriptname =  , title =  , append = T, b.png4Github = T)

vertesy/MarkdownReports.v2.9.5 documentation built on May 22, 2019, 4 p.m.