Rosetta 🌐

Rosetta, inspired by the Rosetta Stone, transforms e.g. between:

• Text Encodings (e.g. UTF-8 ⇔ ISO 8859-1 etc.)
• RDF Turtle ⇔ JSON-LD ⇔ YAML-LD ⇔ Enola Things
• YAML & JSON ⇔ RDF Turtle with JSON-LD Contexts
• YAML ⇔ JSON ⇔ TextProto ⇔ Binary Protocol Buffer “Wire” formats
• Graph Diagrams from RDF et al.
• Many other formats!
• XML

Specifying the --schema flag is optional for YAML <=> JSON conversion, but required for TextProto.

Rosetta transforms a (single) input resource into one output resource of another format. Alternatively, generate can load (possibly several) resources (or “logical IRIs”) which contain Things and transform them into (some of) these formats.

Graph Diagrams

Enola can generate Graph Diagrams like this, through DocGen (see Tutorial), or Rosetta.

Graphviz

Similarly to e.g. rdflib’s rdf2dot (and rdfs2dot):

$ ./enola rosetta --in test/picasso.ttl --out "docs/BUILT/picasso.gv?full=true" && dot -Tsvg -O docs/BUILT/picasso.gv

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/build

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/.editorconfig

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/.prettierignore

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/.prettierrc.yaml

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/dev

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/.markdownlint.yaml

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/@babel/helper-compilation-targets/node_modules/.bin/semver

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/@babel/core/node_modules/.bin/semver

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/parser

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/esparse

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/js-yaml

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/browserslist

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/node-which

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/json5

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/acorn

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/esvalidate

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/tsc

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/update-browserslist-db

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/jsesc

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/eslint

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/tsserver

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/eslint-config-prettier

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/prettier

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/semver

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/@istanbuljs/load-nyc-config/node_modules/.bin/js-yaml

produces picasso.gv and picasso.gv.svg:

The full URL query string can be used to control appearance, and --no-file-loader suppresses the file; see:

$ ./enola rosetta --no-file-loader --in test/picasso.ttl --out "docs/BUILT/picasso-small.gv?full=false" && dot -Tsvg -O docs/BUILT/picasso-small.gv

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/build

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/.editorconfig

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/.prettierignore

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/.prettierrc.yaml

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/dev

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/.markdownlint.yaml

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/@babel/helper-compilation-targets/node_modules/.bin/semver

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/@babel/core/node_modules/.bin/semver

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/parser

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/esparse

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/js-yaml

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/browserslist

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/node-which

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/json5

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/acorn

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/esvalidate

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/tsc

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/update-browserslist-db

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/jsesc

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/eslint

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/tsserver

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/eslint-config-prettier

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/prettier

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/semver

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/@istanbuljs/load-nyc-config/node_modules/.bin/js-yaml

GEXF

$ ./enola rosetta --in test/picasso.ttl --out docs/BUILT/picasso.gexf

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/build

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/.editorconfig

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/.prettierignore

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/.prettierrc.yaml

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/dev

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/.markdownlint.yaml

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/@babel/helper-compilation-targets/node_modules/.bin/semver

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/@babel/core/node_modules/.bin/semver

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/parser

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/esparse

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/js-yaml

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/browserslist

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/node-which

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/json5

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/acorn

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/esvalidate

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/tsc

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/update-browserslist-db

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/jsesc

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/eslint

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/tsserver

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/eslint-config-prettier

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/prettier

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/semver

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/@istanbuljs/load-nyc-config/node_modules/.bin/js-yaml

produces picasso.gexf in GEXF format (see also GEXF examples), which can be opened e.g. in Gephi Lite or Retina.

Tika

See here!

YAML to JSON

$ ./enola rosetta --in test/picasso.yaml --out /tmp/picasso.json

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/build

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/.editorconfig

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/.prettierignore

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/.prettierrc.yaml

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/dev

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/.markdownlint.yaml

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/@babel/helper-compilation-targets/node_modules/.bin/semver

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/@babel/core/node_modules/.bin/semver

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/parser

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/esparse

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/js-yaml

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/browserslist

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/node-which

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/json5

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/acorn

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/esvalidate

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/tsc

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/update-browserslist-db

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/jsesc

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/eslint

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/tsserver

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/eslint-config-prettier

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/prettier

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/semver

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/@istanbuljs/load-nyc-config/node_modules/.bin/js-yaml

Turtle 🐢 to JSON-LD 🔗

$ ./enola rosetta --in test/picasso.ttl --out /tmp/picasso.jsonld

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/build

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/.editorconfig

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/.prettierignore

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/.prettierrc.yaml

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/dev

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/.markdownlint.yaml

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/@babel/helper-compilation-targets/node_modules/.bin/semver

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/@babel/core/node_modules/.bin/semver

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/parser

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/esparse

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/js-yaml

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/browserslist

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/node-which

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/json5

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/acorn

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/esvalidate

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/tsc

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/update-browserslist-db

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/jsesc

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/eslint

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/tsserver

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/eslint-config-prettier

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/prettier

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/semver

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/@istanbuljs/load-nyc-config/node_modules/.bin/js-yaml

JSON & YAML to Turtle 🐢 via JSON-LD

See JSON-LD.

XML

$ ./enola rosetta --in test/greeting1-nested.xml --out="fd:1?mediaType=text/turtle"

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/build

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/.editorconfig

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/.prettierignore

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/.prettierrc.yaml

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/dev

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/.markdownlint.yaml

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/@babel/helper-compilation-targets/node_modules/.bin/semver

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/@babel/core/node_modules/.bin/semver

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/parser

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/esparse

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/js-yaml

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/browserslist

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/node-which

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/json5

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/acorn

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/esvalidate

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/tsc

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/update-browserslist-db

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/jsesc

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/eslint

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/tsserver

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/eslint-config-prettier

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/prettier

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/semver

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/@istanbuljs/load-nyc-config/node_modules/.bin/js-yaml
@prefix ex: <https://example.org/> .

<file:/home/runner/work/enola/enola/test/greeting1-nested.xml> ex:greeting1 [
      ex:message "hello, world"
    ] .

Turtle 🐢 to Things ⛓️

$ ./enola rosetta --in test/picasso.ttl --out /tmp/picasso.thing.yaml

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/build

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/.editorconfig

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/.prettierignore

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/.prettierrc.yaml

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/dev

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/.markdownlint.yaml

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/@babel/helper-compilation-targets/node_modules/.bin/semver

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/@babel/core/node_modules/.bin/semver

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/parser

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/esparse

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/js-yaml

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/browserslist

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/node-which

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/json5

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/acorn

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/esvalidate

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/tsc

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/update-browserslist-db

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/jsesc

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/eslint

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/tsserver

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/eslint-config-prettier

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/prettier

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/semver

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/@istanbuljs/load-nyc-config/node_modules/.bin/js-yaml

UTF-8 to ISO 8859-1

$ file docs/use/rosetta/hello.txt
docs/use/rosetta/hello.txt: Unicode text, UTF-8 text

$ cat docs/use/rosetta/hello.txt
hello, wörld 😄

$ ./enola rosetta --in 'docs/use/rosetta/hello.txt?charset=UTF-8' --out '/tmp/hello-windows.txt?charset=ISO-8859-1'

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/build

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/.editorconfig

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/.prettierignore

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/.prettierrc.yaml

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/dev

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/.markdownlint.yaml

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/@babel/helper-compilation-targets/node_modules/.bin/semver

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/@babel/core/node_modules/.bin/semver

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/parser

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/esparse

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/js-yaml

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/browserslist

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/node-which

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/json5

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/acorn

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/esvalidate

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/tsc

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/update-browserslist-db

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/jsesc

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/eslint

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/tsserver

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/eslint-config-prettier

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/prettier

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/.bin/semver

WARNING: Ignoring symlink: /home/runner/work/enola/enola/web/node_modules/@istanbuljs/load-nyc-config/node_modules/.bin/js-yaml

$ file /tmp/hello-windows.txt
/tmp/hello-windows.txt: ISO-8859 text

$ cat /tmp/hello-windows.txt
hello, w�rld ?