Reference¶

Access Levels¶

Access Levels determine who can see a dataset, query, story, or group. They are documented on the Access Control page, together with the rules that constrain them.

Roles¶

Roles determine what a member of a group may do. They are documented on the Access Control page, together with custom roles and API token permissions.

Markdown support¶

Triply allows rich text formatting to be used in the following places:

Dataset description
Account description
Saved Query description
Data Story elements
Site welcome message

The following Markdown elements are supported:

Headings¶

Headings are used to divide a text into different sections. The hash character (#) at the beginning of a line indicates a heading is used. Multiple hash characters indicate nested headings.

# Heading 1

## Heading 2

### Heading 3

#### Heading 4

##### Heading 5

###### Heading 6

Text styling¶

Style	Syntax	Output
Bold	`bold`	bold
Italic	`_italic_`	italic
Strikethrough	`~~strikethrough~~`	~~strikethrough~~

Hyperlinks¶

Style	Syntax	Output
Raw URL	`<https://triply.cc>`	https://triply.cc
Labeled URL	`[label](https://triply.cc)`	label

Notice that URLs can also be relative. This allows you to refer to other datasets, saved queries, etc. by using relative paths.

Code¶

There are options for formatting in-line code as well as multi-line code blocks.

In-line code¶

Code can also be used in-line with single backticks:

Use `code` inside a sentence.

Multi-line code blocks¶

Multi-line code blocks start and end with three consecutive backticks. The following Markdown denotes two lines of Turtle:


select * {
  graph ?g {
    ?s ?p ?o.
  }
}

The above is rendered as follows:

select * {
  graph ?g {
    ?s ?p ?o.
  }
}

Code language¶

The opening backticks are optionally following by the name of the code language. The following code languages are supported:

Language	Syntax
SPARQL	`sparql`
Turtle	`ttl`
TypeScript	`typescript`
R	`r`
Python	`python`

The other supported languages are: Bash (bash), C (c), C++ (cpp), C# (csharp), Extended Backus-Naur Form (ebnf), Go (go), Haskell (haskell), Java (java), JavaScript (javascript), LaTeX (latex), Makefile (makefile), Markdown (markdown), Objective C (objectivec), Pascal (pascal), Perl (perl), Powershell (powershell), Prolog (prolog), Regular Expression (regex), Ruby (ruby), Scala (scala), SQL (sql), Yaml (yaml).

Introspection¶

TriplyDB provides SPARQL functions that can be used to obtain data about the current working environment. Examples are the name and URL of the current dataset, or the name and URL of the current user. This concept is called introspection. Introspection is supported for TriplyDB's default SPARQL Engine, Speedy. This means that in order to use introspection, service should be set to "Speedy" for (saved) SPARQL queries.

All the introspection functions are identified by IRIs in the namespace https://triplydb.com/Triply/function/. In the rest of this section, the following prefix is assumed:

prefix tf: <https://triplydb.com/Triply/function/>

The table below lists the introspection functions and the datatype of their result. The introspection functions do not need input parameters.

Function	Returns datatype	Explanation
tf:instance_url()	xsd:anyURI	The URL of the TriplyDB instance
tf:authenticated_user_url()	xsd:anyURI	The URL of the user executing the SPARQL query
tf:authenticated_user_name()	xsd:string	The name of the user executing the SPARQL query
tf:queried_dataset_url()	xsd:anyURI	The URL of the dataset that is being queried
tf:queried_dataset_name()	xsd:string	The name of the dataset that is being queried
tf:queried_dataset_owner_url()	xsd:anyURI	The URL of the owner of the dataset that is being queried
tf:queried_dataset_owner_name()	xsd:string	The name of the owner of the dataset that is being queried

One way in which introspection functions can be put to use is in making dynamic overviews in data stories. The example below shows how the URL of the current user can be matched to provenance data in the Editor to create a personalised overview of Editor operations:

prefix tf: <https://triplydb.com/Triply/function/>
prefix editor: <https://triplydb.com/Triply/TriplyDB-instance-editor-vocabulary/>
select ?action ?time
where {
  bind (iri(tf:authenticated_user_url()) as ?userIri)
  ?event
    editor:actor ?userIri ;
    editor:action ?action ;
    editor:time ?time
  .
}