Skip to main content

Quickstart

Follow this ten-minute walkthrough to author a Turtle file, validate it with SHACL, connect a data source, and query it with SPARQL — the core neonto loop.

Before you start, make sure you've installed the extension and are logged in with an active license.

1. Author a Turtle file​

A .ttl file with the completion popup open, listing terms from the workspace vocabulary with documentation shown for the selected entry

Figure 1. Turtle Completion

  1. Create a new file named example.ttl.
  2. Start typing a triple, for example ex:, and press Ctrl+Space to trigger autocompletion for classes and prefixes.
  3. Hover over a term (e.g. rdf:type or a class from a linked vocabulary) to see its documentation.
  4. Check the Problems panel (Ctrl+Shift+M) for any diagnostics, and hover over the squiggles to see details.

Diagnostics for syntax issues and undefined prefixes appear automatically as you type.

For the full authoring reference, see Working with Turtle.

2. Validate with SHACL​

The Problems panel showing SHACL validation results at error, warning, and info severity, with a violation underlined in the data file above

Figure 2. SHACL Validation Results

  1. Open the SHACL Validations view in the sidebar.
  2. Click the + button to add a validation connection, linking a SHACL shapes file to your RDF data file.
  3. Run the validation via the Command Palette (Ctrl+Shift+P / F1) → neonto: Run SHACL Validation, or right-click the connection in the sidebar.
  4. Review results in the Problems panel and as inline diagnostics in the editor.

See SHACL Validation for reports and constraint visualization.

3. Map data with YARRRML​

The generated Turtle shown alongside the YARRRML mapping in the editor

Figure 3. YARRRML Mapping

  1. Create a new file named mapping.yarrrml.
  2. Write your mapping rules to convert tabular or JSON data into RDF, utilizing autocompletion (Ctrl+Space) for prefixes and functions.
  3. Click the Create RML from YARRRML button in the editor title bar to compile your rules into RML.
  4. Execute the mapping via the Command Palette to materialize your data into triples.

See Working with YARRRML for the full mapping reference.

4. Add a data source​

The Data Source Connections view listing Local Sources, Linked Open Vocabularies (LOV), and a SPARQL endpoint, with the + Add Data Source button in the view title bar

Figure 4. Data Source Connections

  1. Open the neonto icon in the left sidebar to reveal the Data Source Connections view.
  2. Click the + (Add Data Source) button next to the Data Source Connections title.
  3. Choose SPARQL endpoint as the source type and enter the DBpedia endpoint URL (https://dbpedia.org/sparql).

See Data Sources for details on source types and management.

5. Run a SPARQL query​

The query result opened as a .result.txt document, showing the returned binding from the DBpedia query

Figure 5. SPARQL Query Results

  1. Create a new file named query.sparql.
  2. Write a simple query against DBpedia, e.g.
PREFIX dbr: <http://dbpedia.org/resource/>

SELECT * WHERE {
  dbr:Berlin ?p ?o .
}
LIMIT 10
  1. Run it via the Command Palette → neonto: Run SPARQL Query, or the button in the editor title bar.
  2. Review the results — with the default simple format they open as a .result.txt document next to your query.

See Working with SPARQL for query execution and result formats.

Where to go next​