Quickstart#

NOTE: It is recommended you install in a python environment. If you do not know how to set up a virtual environment, please refer to this link or check out python’s instructions.

Before converting#

Install cemento with pip.

warning The CEMENTO package only supports python versions >=3.10.

(.venv) $ pip install cemento

Run the following to see if it’s properly installed:

(.venv) $ cemento --help

It should show the following:

_images/good-output.png

Download the Example#

Clone the official repo to get the example. Prefer the master branch:

(.venv) $ git pull https://github.com/Gabbyton/CEMENTO.git
(.venv) $ cd CEMENTO/examples/

There should be two files happy-example.drawio and happy-example.ttl

Converting from draw.io to .ttl#

Inside the examples folder, run the following command:

(.venv) $ cemento drawio_ttl happy-example.drawio sample.ttl
NOTE: Paths can be absolute or relative.

Converting from .ttl to draw.io#

Similar to the above, run the following command:

(.venv) $ cemento ttl_drawio happy-example.ttl sample.drawio

Help message#

If you get lost, there is always:

(.venv) $ cemento --help
(.venv) $ cemento drawio_ttl --help
(.venv) $ cemento ttl_drawio --help

Check output#

Congratulations! If you made it to this point, you’ve managed to convert your files from draw.io to .ttl and back. Compare the results you get with those in happy-example.drawio and happy-example.ttl respectively. Note that the diagram will not be the exact same look, but the connections and terms should all be the same.

What now?#

You can now start converting YOUR diagrams from draw.io to turtle format and vice versa! To read more about other cool features, start with the User Guide.