Reveal
Reveal jumps between a Dolfin declaration and its Turtle. Right-click a word in the editor to use it.
From Dolfin to Turtle
In a Dolfin file, right-click a name. The menu has Reveal in graph and one of two Turtle items, depending on the project:
| Project | Menu item | Where it takes you |
|---|---|---|
| Imported from Turtle (has an origin) | Reveal in turtle source | The origin .ttl opens in a tab, the statement is selected and flashes for about a second and a half. |
| Any other project | Reveal in turtle export | The Output panel switches to its Turtle tab and highlights the block the compiler generated. |
What you can reveal
- concepts and properties;
- the name of a
hasfield; - an enum value inside
one of:; - the id of a
fact.
Any other word (for example the type at the end of has owner: Person) is looked up as a concept or property name.
Which statement
A declaration corresponds to all Turtle statements whose subject is its IRI; Reveal shows the first one in the file. If there are several, a message says Showing the first of N statements. In the export, a concept with a one of: list has two blocks; the first (the class declaration) is shown.
A has field corresponds to its property, so a property shared by two concepts (has name on both) reveals the same statement from either. An enum value corresponds to its individual. A concept with an @iri_name override is found by that exact IRI.
When nothing is found
- No turtle counterpart: the declaration is new or renamed and the Turtle has not caught up yet (see sync), or the word is not a declaration.
- An error message if the origin Turtle does not parse.
From Turtle to Dolfin
In the origin Turtle editor, right-click a prefixed name or an <IRI> and choose Reveal in dolfin. The matching Dolfin file opens with the declaration selected. The item exists only in the origin file, not in other .ttl files.
- On a predicate, a keyword or anything that is not a declaration, Reveal uses the subject of the statement you clicked in. Right-clicking
rdfs:domaininsideex:Dog …revealsDog. - When one IRI maps to several declarations, the order of preference is concept, property, fact, enum value, field.
- The Dolfin source is read as it is now, not as it was at import, so it keeps working after you edit either side.
Messages:
- No dolfin counterpart (not in dolfin yet? use Re-translate): you added the class to the Turtle by hand. See Re-translate.
- No dolfin counterpart found: N dolfin file(s) have syntax errors: Reveal skips Dolfin files that do not parse.
A concept that carries a concept-level @iri_name cannot be revealed from the Turtle yet; it gives the miss message.