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

SVG Output

SVG output is suitable for previews, documentation, and web publishing.

xaligo render diagram.xal --format svg -o diagram.svg

An identified child frame is one SVG artifact by default. A one-frame document writes exactly diagram.svg. If the document contains frames overview and service-detail, the same command writes:

diagram-overview.svg
diagram-service-detail.svg

The frame ID is made filename-safe by retaining ASCII letters, digits, _, and -, replacing every run of other characters with one -, and trimming leading and trailing -. An empty safe ID falls back to frame-<source-order>; colliding filenames are reported as an error. No ZIP archive is created.

Use the compatibility option to keep every frame on one historical canvas:

xaligo render diagram.xal --format svg -o diagram.svg --combine-frames

Live preview uses this combined view automatically.

The page frame itself is not rendered as a visible outline. In default page-local output, its exact rectangle is the SVG canvas, viewBox, and clip boundary. No marker or stroke safety padding is added outside the page, so a top/bottom metadata band’s row-gap gutter reaches the physical SVG edge while the tag cells remain inset by that value. Combined compatibility output omits each page-frame outline but retains marker-safe canvas expansion.

With --services, SVG can draw a legend:

xaligo render diagram.xal --format svg -o diagram.svg \
  --services services.csv \
  --svg-legend-position bottom

SVG rendering uses the shared orthogonal router and includes:

  • Route and traffic layer ordering.
  • Line-jump masks at interior crossings.
  • Automatic junction markers for shared route endpoints.
  • Distinct marker geometry for V1 arrow, triangle, stealth, diamond, and oval arrowheads.
  • Strict frame canvas/viewBox clipping for default page artifacts, and stroke/marker-expanded bounds for combined compatibility output.
  • Service legends when metadata is provided.

The complete document scene is routed before its frame pages are projected. A cross-frame connection therefore appears as to <destination frame ID> on the source SVG and from <source frame ID> on the destination SVG. Combined output keeps those two page-link stubs and does not reconnect them across the inter-frame gap. Explicit src/dst-frame-side or src/dst-frame-anchor attributes select the outer frame side and tangent coordinate independently from the item endpoint. The drawable terminal is on a parallel inward line: resolved metadata row-gap, or 4 layout pixels without metadata; zero keeps the outer edge. The label stays 4 layout pixels inward and at least 4 layout pixels alongside that final terminal, using the closest along-edge position that avoids endpoint and metadata geometry.