rxp_qmd: Render a Quarto Document as a Nix Derivation

In rixpress: Build Reproducible Analytical Pipelines with 'Nix'

Render a Quarto Document as a Nix Derivation

Description

Render a Quarto Document as a Nix Derivation

Usage

rxp_qmd(
  name,
  qmd_file,
  additional_files = "",
  nix_env = "default.nix",
  args = "",
  env_var = NULL,
  noop_build = FALSE
)

Arguments

name	Symbol, derivation name.
qmd_file	Character, path to .qmd file.
additional_files	Character vector, additional files to include, for example a folder containing images to include in the Quarto document.
nix_env	Character, path to the Nix environment file, default is "default.nix".
args	A character of additional arguments to be passed directly to the quarto command.
env_var	List, defaults to NULL. A named list of environment variables to set before running the Quarto render command, e.g., c(QUARTO_PROFILE = "production"). 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 built derivations in the document, rxp_read("derivation_name") should be put in the .qmd 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_r(), rxp_r_file(), rxp_rmd()

Examples

## Not run: 
  # Compile a .qmd file to a pdf using typst
  # `images` is a folder containing images to include in the Quarto doc
  rxp_qmd(
    name = report,
    qmd_file = "report.qmd",
    additional_files = "images",
    args = "--to typst"
  )

  # Skip building this derivation
  rxp_qmd(
    name = draft_report,
    qmd_file = "draft.qmd",
    noop_build = TRUE
  )

## End(Not run)

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