OntoCode feature tour¶
A visual and structural overview of the OntoCode VS Code IDE (v0.13). For hands-on setup, start with First success (~10 min core path).
Canonical capability list: What ships today. New in v0.13: Migration guide.
Activity bar and explorer¶
The OntoCode activity bar hosts five tree views:
| View | Purpose |
|---|---|
| Ontologies | Indexed files, formats, parse status |
| Classes | Class hierarchy (asserted, or inferred/combined after reasoner) |
| Properties | Object, data, and annotation properties |
| Individuals | Named individuals |
| Diagnostics | Lint summaries grouped by severity |
Explorer sidebar (Ontologies, Classes, Properties, Individuals, Diagnostics) and the React Entity Inspector open when you click an entity (e.g. Person in example.ttl).
Typical flow: expand Classes → click an entity name → Entity Inspector opens on the right. With Inspector and Graph panels open, the same entity stays in sync (focus relay, v0.13).
Entity Inspector (React)¶
The inspector shows IRI, kind, labels, comments, parents, children, and axioms. For .ttl files, the Edit section supports:
- Add or change labels and comments
- Add named parent classes
- Delete entity
- Edit in Manchester / Add Manchester axiom for complex expressions
Turtle (.ttl) and OBO (.obo) support write-back in the inspector. RDF/XML, OWL/XML, and JSON-LD are read-only — index and browse only.
Query Workbench (React)¶
Command Palette → OntoCode: Open Query Workbench
- SQL mode — catalog virtual tables (
classes,properties,diagnostics, Horned-OWL axiom tables, …) - SPARQL mode — graph patterns over indexed triples
- Schema browser (v0.13) — browse tables/columns from LSP
listSqlSchema; insert names into the editor - Export results to CSV or JSON; history and saved queries
Guide: Query Workbench
Manchester editor (React)¶
Opened from the inspector or Command Palette for complex SubClassOf, EquivalentClasses, and DisjointClasses axioms. Validates Manchester syntax, previews Turtle, then applies to the .ttl file.
Guide: Manchester editor
Graph panels (React)¶
| Command | Graph |
|---|---|
| Open Class Graph | Subclass neighborhood around a class |
| Open Property Graph | Property domain/range neighborhood |
| Open Import Graph | Ontology import dependencies |
| Open Neighborhood Graph | Mixed entity neighborhood |
Click nodes to jump back to the Entity Inspector.
Guide: Graph view
Reasoner and explanation¶
| Panel | Purpose |
|---|---|
| Reasoner Results | Profile used, consistency, unsatisfiable classes, warnings |
| Explanation | EL-first justification for unsatisfiable classes (after reasoner run) |
After classification, use Set Hierarchy Mode (asserted / inferred / combined) to update the Classes tree.
Guide: Reasoner
Refactor preview and semantic diff (React)¶
| Panel | Purpose |
|---|---|
| Refactor Preview | Diff before rename, migrate, move, or extract module |
| Semantic Diff | Compare versions, directories, or workspace snapshots — axiom-level changes and breaking-change flags |
Guides: Refactoring · Semantic diff
Manage Imports (v0.11)¶
Right-click a .ttl file in Ontologies → Manage Imports to add or remove owl:imports declarations with preview and apply.
Guide: Manage Imports
Turtle semantic highlighting and diagnostics config (v0.13)¶
In .ttl and .obo editors:
- Semantic tokens — namespaces, IRIs, keywords, comments (LSP
textDocument/semanticTokens/full) - Configurable diagnostics —
.ontocore/diagnostics.tomlat workspace root orontocode.diagnostics.rulessetting
Guide: Migration v0.13 · LSP API
Turtle completion and quick fixes (v0.11)¶
In .ttl editors:
- Completion on
:,<,@— prefixes, QNames, catalog IRIs - Quick fixes (lightbulb) for undefined prefix, missing label, and broken import diagnostics
Editor integration¶
Open any supported ontology file (.ttl, .owl, .obo, …) for:
- Hover on IRIs
- Go to definition (
F12) - Document outline (
Ctrl+Shift+O/Cmd+Shift+O) - Workspace symbol search (
Ctrl+T/Cmd+T) - Inline diagnostics in the Problems panel
Settings worth knowing¶
| Setting | Default | Notes |
|---|---|---|
ontocode.lspPath |
empty | Override bundled ontocore-lsp (trusted workspaces only) |
ontocode.hierarchy.mode |
asserted |
Switch after reasoner for inferred tree |
ontocode.reasoner.default |
el |
Default profile for Run Reasoner |
ontocode.indexCache |
false |
Optional .ontocore/cache/ disk index |
ontocode.diagnostics.rules |
{} |
Per-rule enable/severity (overridden by .ontocore/diagnostics.toml) |
Full list: Install VS Code
Next steps¶
| Goal | Document |
|---|---|
| Complete the tutorial | First success |
| From Protégé | Migrating from Protégé |
| CLI / CI without VS Code | OntoCore overview |