rxp_rmd: Render an R Markdown Document as a Nix Derivation

In rixpress: Build Reproducible Analytical Pipelines with 'Nix'

Render an R Markdown Document as a Nix Derivation

Description

Render an R Markdown Document as a Nix Derivation

Usage

rxp_rmd(
  name,
  rmd_file,
  additional_files = "",
  nix_env = "default.nix",
  params = NULL,
  env_var = NULL,
  noop_build = FALSE
)

Arguments

name	Symbol, derivation name.
rmd_file	Character, path to .Rmd file.
additional_files	Character vector, additional files to include, for example a folder containing the pictures to include in the R Markdown document.
nix_env	Character, path to the Nix environment file, default is "default.nix".
params	List, parameters to pass to the R Markdown document. Default is NULL.
env_var	List, defaults to NULL. A named list of environment variables to set before running the R Markdown render command, e.g., c(RSTUDIO_PANDOC = "/path/to/pandoc"). Each entry will be added as an export statement in the build phase.
noop_build	Logical, defaults to FALSE. If TRUE, the derivation produces a no-op build (a stub output with no actual build steps). Any downstream derivations depending on a no-op build will themselves also become no-op builds.

Details

To include objects built in the pipeline, rxp_read("derivation_name") should be put in the .Rmd file.

Value

An object of class derivation which inherits from lists.

See Also

Other derivations: rxp_jl(), rxp_jl_file(), rxp_py(), rxp_py_file(), rxp_qmd(), rxp_r(), rxp_r_file()

Examples

## Not run: 
  # Compile a .Rmd file to a pdf
  # `images` is a folder containing images to include in the R Markdown doc
  rxp_rmd(
    name = report,
    rmd_file = "report.Rmd",
    additional_files = "images"
  )

  # Skip building this derivation
  rxp_rmd(
    name = draft_report,
    rmd_file = "draft.Rmd",
    noop_build = TRUE
  )

## End(Not run)

rixpress documentation built on Feb. 19, 2026, 9:06 a.m.