General
- Enable/disable features globally; toggle quick actions in the Command Palette.
Installation & Activation
Marketplace install
- Open VS Code → Extensions (Ctrl/Cmd + Shift + X).
- Search for “RDFusion” and click Install.
Install from VSIX
- Build or download
rdfusion-x.y.z.vsix. - VS Code → Extensions → ⋯ menu → Install from VSIX… → choose the file.
Activation triggers
The extension activates automatically when you open a
.ttl (Turtle) or .jsonld (JSON-LD)
file.
Requirements & Internationalization
- VS Code; Internet recommended for such as remote vocabulary lookups (LOV, prefix registries).
- UI is English-only in this version.
Click the GIF to open a larger view. Use Esc to close.
Quick start
-
Create or open a
.ttlor.jsonldfile. -
Type a known prefix (e.g.,
foaf:) or start authoring a triple. Autocomplete and validation appear as you type. - Press Ctrl/Cmd + Space to force suggestions anytime.
- Open the Command Palette (Ctrl/Cmd + Shift + P) and run RDFusion commands like Filter Triples or Generate VoID.
Configuration & Settings
RDFusion exposes settings in File → Preferences → Settings (search “RDFusion”) or via settings.json. Configurations are also available through the Command Palette.
Validation
- SHACL: enable/disable applying SHACL shapes from your workspace.
- Checks: language tags, xsd-datatypes, duplicates, IRI schemes, and more.
Autocompletion
- Auto-declare prefixes: when using an undeclared prefix, add the declaration automatically.
- Suggestion Sources: choose local only, remote only, or both.
- Trigger Behavior: automatic or manual (Ctrl/Cmd + Space).
Performance
- Validation throttling: enable only validations you need on large files.
Configuration & Settings — GIFs
Click a GIF to open a larger view. Use ← / → to switch when
open.
Real-time Validation
As you edit, the extension checks syntax, other restrictions enabled, and SHACL constraints and shows inline diagnostics.
Live error highlighting
Syntax errors and warnings are underlined as you type, with details shown inline.
SHACL constraints
If your workspace contains SHACL shapes, they are applied automatically if enabled.
Toggle & performance
Use Command-Palette or Settings to enable/disable checks. Basic parsing errors are prioritized; deeper checks run when syntax is corrected.
Configurable rules
See Configuration & Settings to enable/disable validations.
Click a GIF to open a larger view. Use ← / → to switch when
open.
Example snippets (copyable)
Turtle
@prefix ex: <http://example.org/> .
@prefix foaf: <http://xmlns.com/foaf/0.1/> .
ex:Homer a foaf:Person ;
foaf:name "Homer Simpson" ;
foaf:age 39 .
ex:Bart a foaf:Person ;
foaf:name "Bart Simpson" .
SHACL
@prefix ex: <http://example.org/> .
@prefix foaf: <http://xmlns.com/foaf/0.1/> .
@prefix sh: <http://www.w3.org/ns/shacl#> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
ex:PersonShape a sh:NodeShape ;
sh:targetClass foaf:Person ;
sh:property [
sh:path foaf:name ;
sh:minCount 1 ;
sh:message """At least one name is
required for a person."""@en ;
] ;
sh:property [
sh:path foaf:age ;
sh:minCount 1 ;
sh:datatype xsd:integer ;
sh:message """Age is required and
must be an integer."""@en ;
] .
Autocompletion & Prefix Management
Triggering suggestions
- Suggestions appear automatically in context; press Ctrl/Cmd + Space anytime.
-
In Turtle, typing
prefix:(e.g.,foaf:) shows terms. -
In JSON-LD, editing
@contextor a compact IRI shows terms and ensures prefixes are declared.
Local & remote sources
Terms come from your open files and remote vocabularies (e.g., FOAF via direct derefrencing / or LOV). Remote results are cached.
(TTL/JSON-LD)
Suggestions inside triples, prefix declarations, and JSON-LD contexts.
Auto-declare prefix
Accepting a completion for an undeclared prefix auto-adds
@prefix (Turtle) or a context entry (JSON-LD).
Refactor JSON-LD CURIEs
Compact IRIs across your JSON-LD file. The refactor updates
@context and rewrites matches.
Configurable behavior
Disable remote lookups when offline, and adjust auto-declare options in Settings.
Three flows: Turtle completion, JSON-LD completion, and
JSON-LD IRI compaction.
Example snippets (copyable)
Turtle
@prefix ex: <http://example.org/> .
@prefix foaf: <http://xmlns.com/foaf/0.1/> .
ex:Homer a foaf:Person ;
foaf:name "Homer Simpson" ;
foaf:age 39 .
JSON-LD
{
"@context": {
"ex": "http://example.org/",
"foaf": "http://xmlns.com/foaf/0.1/"
},
"@id": "ex:Homer",
"@type": "foaf:Person",
"foaf:name": "Homer Simpson",
"foaf:age": 39
}
Triple Management
Filter triples (by subject / predicate / object)
Use Command Palette → RDFusion: Filter Triples by … to generate a new tab view containing only matching triples.
Click to view larger. Non-destructive: your original file is
untouched.
Sort & group
Group by Subject groups triples under their subject; Sort Triples orders triples for cleaner look.
Format Turtle document
Use RDFusion: Format Document to apply consistent indentation, prefix mapping, ... .
IRI shortening (compact view)
Toggle visual shortening for long IRIs (e.g.,
http://example.org/.../Concept). This improves
readability without changing file content.
Merge files
Select multiple RDF files and run RDFusion: Merge Files. The result is a single grouped Turtle document opened in a new tab.
Turtle RDF diff
Compare current open turtle file with HEAD or a specific commit in Git. The diff view compares RDF-aware changes.
Note: When blank nodes are present the diff
shows RDF differences (support will be added soon).
Dataset statistics (VoID)
Run RDFusion: Generate VoID Description to compute counts (triples, distinct subjects/objects, classes) and output a VoID Turtle in a new tab.
