Ga naar inhoud

vsa svg — één vsa-bestand naar SVG renderen

Waartoe

Eén .vsa-bestand snel als SVG-afbeelding bekijken (scherm of afdruk). Geen Markdown-pipeline — daarvoor vsa process of vsa build-markdown.

Render één vsa-bestand naar één SVG-afbeelding.

Synopsis

vsa svg [-h] [--config CONFIG] [--max-line-width MAX_LINE_WIDTH] input output

Beschrijving

vsa svg leest één .vsa-bestand, lost @include-vsa op indien aanwezig, parset de VSA-notatie en rendert het resultaat naar een SVG-bestand. Dit commando verwerkt geen Markdownblokken — voor Markdown met VSA-blokken gebruik je vsa process of vsa build-markdown.

vsa svg valideert de invoer niet expliciet vooraf; een parsefout leidt tot een foutmelding en exitcode 1. Draai bij twijfel eerst vsa validate.

Argumenten en opties

Naam Verplicht Betekenis Default Beperkingen
input Ja VSA-bronbestand dat gelezen wordt. — Moet bestaan.
output Ja SVG-bestand dat wordt aangemaakt of overschreven. — Bovenliggende map moet bestaan.
--config CONFIG Nee Pad naar een alternatief vsa.toml. Auto-detectie van vsa.toml —
--max-line-width MAX_LINE_WIDTH Nee Maximale SVG-regelbreedte voordat wordt afgebroken. max-line-width uit vsa.toml, anders 800 Getal (float)
-h, --help Nee Toon hulp voor dit subcommando. — —

Output

  • stdout: SVG geschreven naar: <output> bij succes.
  • Bestand: output wordt aangemaakt (of overschreven als het al bestaat).
  • Geen Markdown wordt gelezen of geschreven.

Exit status

Exitcode Betekenis
0 SVG succesvol geschreven.
1 Bestand niet gevonden, of parsefout.

Voorbeelden — succes

vsa svg examples\minimal\050_svg_demo.vsa tmp\demo.svg

Verwachte output:

SVG geschreven naar: tmp\demo.svg

Het bestand tmp\demo.svg wordt aangemaakt (map tmp\ moet al bestaan). Bekijk het resultaat direct:

start tmp\demo.svg

Met een aangepaste regelbreedte:

vsa svg examples\minimal\100_multiline_demo.vsa tmp\demo-smal.svg --max-line-width 400

SVG geschreven naar: tmp\demo-smal.svg

Validatie vs. SVG

examples\minimal\050_svg_demo.vsa faalt op vsa validate (semantische hoogte-mismatch), maar rendert wel gewoon met vsa svg — dit commando voert geen semantische controle uit. Draai vsa validate eerst als je zeker wilt zijn van geldige VSA-notatie.

Voorbeelden — falen

vsa svg pad\dat\niet\bestaat.vsa tmp\demo.svg

Verwachte output (stderr):

[Errno 2] No such file or directory: 'pad\\dat\\niet\\bestaat.vsa'

Exitcode: 1.

Fix: controleer het invoerpad, bijvoorbeeld met dir.

Parsefout (onafgesloten scope) — voorbeeldinvoer met {tekst zonder }:

vsa svg kapot.vsa tmp\out.svg

Verwachte richting: foutmelding op stderr, exitcode 1.

Fix: draai eerst vsa validate kapot.vsa voor exacte foutcode en regel/kolom; herstel de VSA-notatie; daarna opnieuw vsa svg.

Zie ook