Tonto
Guides

Generation Workflows

Generate OntoUML JSON, gUFO Turtle, PlantUML diagrams, and Tonto source from JSON.

Tonto generators let one textual project produce multiple artifacts.

Validate first

Run local validation before generating:

tonto-cli validate .

Use API validation for additional OntoUML checks:

tonto-cli validate . --with-api

Generate OntoUML JSON

tonto-cli generate .

Generated JSON is written to the manifest outFolder.

Use a custom destination:

tonto-cli generate . --destination out-json

Tonto to JSON

Tonto to JSON command in VS Code

Import JSON into Tonto

tonto-cli import model.json --destination imported-model

Use this workflow for migrating existing OntoUML JSON models into textual Tonto projects.

Transform to gUFO

tonto-cli transform .

The VS Code extension also exposes:

Tonto: Transform to GUFO

Tonto to gUFO

Tonto to gUFO command in VS Code

Generate PlantUML

tonto-cli plantuml .

Use per-package output for large models:

tonto-cli plantuml . --per-package

Use layout options for readability:

tonto-cli plantuml . --layout top-to-bottom
tonto-cli plantuml . --layout orthogonal

For a repeatable publication flow:

tpm install
tonto-cli validate .
tonto-cli generate .
tonto-cli plantuml . --per-package

Track source files and manifest changes in Git. Track generated files only when your team needs generated artifacts in the repository.