From 4bc44a585177f5aa63ccc48537d670a45783101f Mon Sep 17 00:00:00 2001 From: Nicholas Car Date: Mon, 12 Aug 2019 13:17:34 +1000 Subject: [PATCH] AltP -> AltR, Concrete AltR desc & e.g.s moved to appendix --- conneg-by-ap/altp.svg | 1 - conneg-by-ap/altr.svg | 1 + conneg-by-ap/{altp.ttl => altr.ttl} | 0 conneg-by-ap/extra.css | 17 +- conneg-by-ap/index.html | 474 ++++++++++++++-------------- 5 files changed, 262 insertions(+), 231 deletions(-) delete mode 100644 conneg-by-ap/altp.svg create mode 100644 conneg-by-ap/altr.svg rename conneg-by-ap/{altp.ttl => altr.ttl} (100%) diff --git a/conneg-by-ap/altp.svg b/conneg-by-ap/altp.svg deleted file mode 100644 index 5aac394c4..000000000 --- a/conneg-by-ap/altp.svg +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/conneg-by-ap/altr.svg b/conneg-by-ap/altr.svg new file mode 100644 index 000000000..848103526 --- /dev/null +++ b/conneg-by-ap/altr.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/conneg-by-ap/altp.ttl b/conneg-by-ap/altr.ttl similarity index 100% rename from conneg-by-ap/altp.ttl rename to conneg-by-ap/altr.ttl diff --git a/conneg-by-ap/extra.css b/conneg-by-ap/extra.css index 3e2d0a4ea..34f90154a 100644 --- a/conneg-by-ap/extra.css +++ b/conneg-by-ap/extra.css @@ -24,4 +24,19 @@ div.req-response { div.req-response > p.respTitle { -} \ No newline at end of file +} + +.codelisting { + padding:0 5px 5px 5px; + background-color: #eee; + border-left: solid 0.5em #999; +} + +.codelisting-title { + font-family: sans-serif; + font-size: medium; + line-height: 1.5; + text-transform: none; + color: #666; + margin-top: -1em; +} diff --git a/conneg-by-ap/index.html b/conneg-by-ap/index.html index 3aa85a1ea..29edfd096 100644 --- a/conneg-by-ap/index.html +++ b/conneg-by-ap/index.html @@ -624,215 +624,35 @@

get resource by profile

-
-

Data Model for Alternate Profiles

+
+

Alternate Representations Data Model

- This data model, MUST be used for describing the alternate profiles that representations - of a resource conform to. The URI of this data model to be used for conformance claims, as per claims of - conformance to protocols, is also the namespace of the OWL expression of this model and is: -

-

- http://www.w3.org/ns/dx/conneg/altp + This data model, MUST be used for describing the representations of a resource that conform to different + profiles.

- An overview of the model, according to its [[OWL2-OVERVIEW]] ontology implementation - (see below) is given in . + An graphical overview of this model is given in .

-
- Alternate Profiles data model +
+ Alternate Profiles data model
A diagram of the Alternate Profiles data model implemented in OWL [[OWL2-OVERVIEW]].

- Descriptions of a resource's alternate profiles MAY be presented according to different model schema, depending + Descriptions of alternate representations of resource according to different profiles MAY be presented according + to modelling systems implementing this model, depending on what is deemed to be relevant to the application profile of this specification that they are created for. For example, the HTTP Application Profile () is limited to text within the constrains of the HTTP specification's headers structure in [[RFC7230]] and thus syntactic communication of this data model in that environment must be implemented according to its constraints.

- A Web Ontology Language [[OWL2-OVERVIEW]] ontology of this data model is given below in - Code Listing 1 and is also available in the file - altp.ttl which is able to be obtained by dereferencing its namespace URI - given above. -

- 
-@prefix altp: <http://www.w3.org/ns/dx/conneg/altp#> .
-@prefix dct: <http://purl.org/dc/terms/> .
-@prefix owl: <http://www.w3.org/2002/07/owl#> .
-@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
-@prefix sdo: <http://schema.org/> .
-@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
-@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
-@prefix skos: <http://www.w3.org/2004/02/skos/core#> .
-
-<http://www.w3.org/ns/dx/conneg/altp>
-    a owl:Ontology ;
-    rdfs:label "Alternative Profiles Ontology" ;
-    rdfs:comment """This ontology allows for the description of representations
-                    of Internet resources.
-
-Representations may conform to prof:Profile instances and may have the format
-                    of a particular dct:MediaType."""@en ;
-    dct:created "2019-08-07"^^xsd:date ;
-    dct:modified "2019-08-10"^^xsd:date ;
-    dct:creator [
-        a sdo:Person ;
-        sdo:affiliation [
-            sdo:name "SURROUND Australia Pty Ltd" ;
-            sdo:url <https://surroundaustralia.com>
-        ] ;
-        sdo:email <mailto:nicholas.car@surroundaustralia.com> ;
-        sdo:identifier <http://orcid.org/0000-0002-8742-7730> ;
-        sdo:name "Nicholas J. Car"
-    ] .
-
-dct:conformsTo
-    a owl:ObjectProperty ;
-    rdfs:label "conforms to" ;
-    dct:source dct:conformsTo ;
-    skos:scopeNote "Use this property to indicate a dct:Standard that a
-        altp:Representation conforms to." .
-
-altp:hasRepresentation
-    a owl:ObjectProperty ;
-    rdfs:label "has representation" ;
-    skos:definition "Indicates a Representation of a Resource."@en ;
-    rdfs:domain rdf:Resource ;
-    rdfs:range altp:Representation ;
-    skos:scopeNote "Use this property to indicate a the HTTP-delivered
-                    representation of a resource." .
-
-altp:hasDefaultRepresentation
-    a owl:ObjectProperty ;
-    rdfs:label "has default representation" ;
-    skos:definition "Indicates the default Representation of a Resource."@en ;
-    rdfs:subPropertyOf altp:hasRepresentation ;
-    skos:scopeNote "Use this property to indicate the default HTTP-delivered
-                    representation of a resource that is obtained when no
-                    further instructions are given to a server to obtain a
-                    resource's representation other than the identification
-                    (URI) of the resource" .
-
-rdf:Resource
-    a owl:Class ;
-    rdfs:label "Resource" ;
-    skos:definition "The class resource, everything."@en ;
-    rdfs:subClassOf [
-        a owl:Restriction ;
-        owl:onProperty altp:hasRepresentation ;
-        owl:allValuesFrom altp:Representation
-    ] ;
-    dct:source "http://www.w3.org/2000/01/rdf-schema#Resource" ;
-    skos:scopeNote "In the context of this mode, rdf:Resource instances are
-                    used to identify Internet resources, that is items
-                    identified by a URI." .
-
-altp:Representation
-    a owl:Class ;
-    rdfs:label "Representation" ;
-    skos:definition "An abstraction of the current or desired state of a
-                     thing in HTTP communications."@en ;
-    rdfs:subClassOf [
-        a owl:Restriction ;
-        owl:onProperty dct:conformsTo ;
-        owl:allValuesFrom dct:Standard
-    ] ;
-    dct:source <https://httpwg.org/specs/rfc7230.html> ;
-    rdfs:isDefinedBy <http://www.w3.org/ns/dx/conneg/altp> ;
-    skos:scopeNote "Use this class to indicate instances of representations
-                    of resources" .
-
-dct:Standard
-    a owl:Class ;
-    rdfs:label "Standard" ;
-    skos:definition "A basis for comparison; a reference point against which
-                     other things can be evaluated."@en ;
-    dct:source "http://purl.org/dc/terms/Standard" ;
-    skos:scopeNote "In the context of this mode, use this class to indicate
-                    instances of information models that representations of
-                    resources can conform to." .
-
-
- Code Listing 1 Alternate Profiles Data Model as an OWL ontology -
-

- Tools for testing the conformance of RDF resource representations to this data model are given in - and suggestions for extensions to this data model to include other dimensions of - content negotiation, such as Media Types, are given in . -

-

- An example implementation of this data model in RDF (turtle) is given in followed by the - same content shown in multiple formats in . + Tools for testing the conformance of data instances to some implementations of this data model are given in + . Suggestions for concrete implementations of, and extensions to, this data model for + use in expected situations are given in . Examples of suggested use as per the are + also given in Functional Profiles of this specification are also given in that appendix.

- 
-@prefix altp: <http://www.w3.org/ns/dx/conneg/altp#> .
-@prefix dct: <http://purl.org/dc/terms/> .
-@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
-@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
-
-# This Resource A has 3 Representations, the 3rd of which is the default
-<http://example.org/resource/a>
-    a rdf:Resource ;
-    rdfs:label "Resources A" ;
-    altp:hasRepresentation :rep-1 , :rep-2 , :rep-3 ;
-    altp:hasDefaultRepresentation :rep-3 .
-
-# Each Representation and the Standard each conforms to, X, Y & Z
-:rep-1
-    a altp:Representation ;
-    dct:conformsTo <http://otherexample.org/profile/x> .
-
-:rep-2
-    a altp:Representation ;
-    dct:conformsTo <http://otherexample.org/profile/y> .
-
-:rep-3
-    a altp:Representation ;
-    dct:conformsTo <http://otherexample.org/profile/z> .
-
- 
-# The content of the previous example expressed as in an HTTP Link header
-# as per the HTTP Application Profile of this Specification with the
-# default Representation indicated by the use of rel="self". Note the
-# Representations are seen, one per Link result comma-separated, identified
-# only by the combination of the Resource URI, the URI of the Standard to
-# which they conform and the rel attribute - they do not have individual
-# identifiers
-Link:
-  <http://example.org/resource/a>;
-          rel="alternate";
-          profile="http://otherexample.org/profile/x",
-  <http://example.org/resource/a>;
-          rel="alternate";
-          profile="http://otherexample.org/profile/y",
-  <http://example.org/resource/a>;
-          rel="self";
-          profile="http://otherexample.org/profile/z"
-
----
-
-# The content of the previous example expressed as in table form
-# such as could potentially be expressed in the HTML body of an HTTP
-# response. The Resource URIs include Query String Arguments that,
-# when specified, allow the individual Representations to be returned,
-# as per the QSA Application Profile below.
----------------------------------------------------------------------------------------
-| Shortened Resource URI                | URI of profile conformed to       | Default |
----------------------------------------------------------------------------------------
-| http://.../resource/a?_profile=prof-x | http://otherexample.org/profile/x |         |
-| http://.../resource/a?_profile=prof-y | http://otherexample.org/profile/y |         |
-| http://.../resource/a?_profile=prof-z | http://otherexample.org/profile/z | Yes     |
----------------------------------------------------------------------------------------
-
@@ -980,20 +800,20 @@

list profiles

The Link HTTP header used to communicate alternate profiles for a resource as per conforms to the Alternate Profiles Data Model - () with the mapping given in + () with the mapping given in

-