You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: 01-tree-specification.bs
+6-4Lines changed: 6 additions & 4 deletions
Original file line number
Diff line number
Diff line change
@@ -23,7 +23,7 @@ Abstract:
23
23
The TREE specification introduces these core concepts:
24
24
* `tree:Collection` is a set of members. It typically has these properties when described in a node:
25
25
- `tree:member` points at the root focus node for each member from which to retrieve and extract all quads of that member
26
-
- `tree:view` points to the `tree:Node` you are currently visiting
26
+
- `tree:view` points to the `tree:Node` you are currently visiting, or points to one specific root node in the HTTP response after dereferencing the `tree:Collection` identifier.
27
27
- `tree:shape` indicates the [[!SHACL]] shape (exactly one) to which each member in the collection adheres
28
28
* `tree:Node` is a page in the search tree
29
29
- `tree:relation` points at relations to other nodes
@@ -124,10 +124,10 @@ When the URL after all redirects, is used in a triple `?c tree:view <> .`, a cli
124
124
125
125
Note: Dereferencing in this specification also means parsing the RDF triples or quads from the HTTP response. TREE does not limit the content-types that can be used to represent RDF triples. Client developers should do a best-effort for their community.
126
126
127
-
If there is no such triple, then the client MUST check whether the URL before redirects (`E`) has been used in a pattern `<E> tree:view ?N.` where there’s exactly one `?N`, then the algorithm MUST return `?N` as the rootnode and `E` as the collection.
127
+
If there is no such triple, then the client MUST check whether the URL before redirects (`E`) has been used in a pattern `<E> tree:view ?N.` where there’s exactly one `?N`, then the algorithm MUST return `?N` as the root node and `E` as the collection.
128
128
129
-
The client then MUST dereference the identified rootnode (if it did not do that already) and merge those quads with the already found quads.
130
-
It now MUST look for a potential search forms that MAY be linked, either i) on top of the rootnode, or ii) on top of the entity linked through `tree:viewDescription`, using `tree:search`.
129
+
The client then MUST dereference the identified root node (if it did not do that already) and merge those quads with the already found quads.
130
+
It now MUST look for a potential search forms that MAY be linked, either i) on top of the root node, or ii) on top of the entity linked through `tree:viewDescription`, using `tree:search`.
131
131
132
132
In case it is not done using an unambiguous URL, clients MAY implement the report on [Discovery and Context Information (work in progress)](https://w3id.org/tree/specification/discovery).
133
133
This report also explains how clients MAY implement support for extracting context information such as provenance, contact points, etc.
@@ -148,6 +148,8 @@ Depending on the goals of the client, it MAY implement the member extraction alg
148
148
The method used within TREE is combination of Concise Bounded Descriptions [[!CBD]], named graphs and the topology of a shape (deducted from the `tree:shape`).
149
149
The full algorithm is specified in the [shape topologies](https://w3id.org/tree/specification/shape-topologies) report.
150
150
151
+
On top of the Member Extraction Algorithm, a client MAY implement the [Profile Algorithm](https://w3id.org/tree/specification/profile).
152
+
151
153
# Traversing the search tree # {#traversing}
152
154
153
155
After dereferencing a `tree:Node`, a client MUST extract all (zero or more) `tree:Relation` descriptions from the page.
0 commit comments