Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Drawio Processor

Purpose

Converts Draw.io diagram files to PNG, SVG, or PDF.

How It Works

Discovers .drawio files in the project and runs drawio in export mode on each file, generating output in the configured formats.

Source Files

  • Input: **/*.drawio
  • Output: out/processor.generator.drawio/{format}/{relative_path}.{format}

Configuration

[processor.generator.drawio]
command = "drawio"                     # The drawio command to run
formats = ["png"]                      # Output formats (png, svg, pdf)
args = []                              # Additional arguments to pass to drawio
output_dir = "out/processor.generator.drawio"              # Output directory
dep_inputs = []                      # Additional files that trigger rebuilds when changed
KeyTypeDefaultDescription
commandstring"drawio"The drawio executable to run
formatsstring[]["png"]Output formats to generate (png, svg, pdf)
argsstring[][]Extra arguments passed to drawio
output_dirstring"out/processor.generator.drawio"Base output directory
dep_inputsstring[][]Extra files whose changes trigger rebuilds

Batch support

Each input file is processed individually, producing its own output file.

Clean behavior

This processor is a Generator — rsconstruct clean outputs removes each declared output file individually with no directory recursion. After all per-product cleans complete, the orchestrator removes any parent directories that are now empty. Pass --no-empty-dirs to keep them. See Clean behavior and rsconstruct clean.