Re: earl location pointer methods

Hi all,

Thank you Jim for doing this work, I have a couple of comments and questions (that are not only directed to Jim):


Overall:
  * We want to have a generic pointer class, and then have each type of pointer be a subclass of this. Please explain if you think this is not a good approach.
  * We also wanted to have an in-between class that holds several location pointers. Each instance of this class represents exactly one instance of a location (that may be expressed through several different types of pointers) [1]. Can this be done?

LineCharLength:
  * The property name and the class name are very similar and prone to confusion (they are only different by one letter capitalization). Any suggestions for other names?
  * Does it make sense to add xsd:integer as the domain for the line/char/length properties?

Snippet:
  * Again the class and property name ("snippet" vs "Snippet") may be a little confusing. Also the name "Content" may be a little misleading and something like "String" or "Text" may be clearer.
  * There seems to be recursive referencing of Content and byteContent but I may be confusing this, please confirm that this model is fine.

XPath:
  * Here there seems to be a recursive referencing of Namespace but again I am not sure, please confirm.



[1] What I believe we discussed was something like this:

<result>
  <location-instance>
    <some-form-of-pointer/>
    <another-form-of-pointer/>
    ....
  </location-instance>
  <location-instance>
    ....
    ....
    ....

Is this what the group recalls?


Thanks,
  Shadi


Jim Ley wrote:
> 
> "Jim Ley" <jim@jibbering.com>
> 
> Below is the rdfs for earl location pointer types, I've taken into 
> account the subsequent threads, so there's byteOffset and charOffset, as 
> well as an XPath class which can support namespaces.
> 
> Cheers,
> 
> Jim.
> 
> 
> 
> 
> <rdf:RDF
> xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
> xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"
> xmlns:earl="http://www.w3.org/WAI/ER/EARL/nmg-strawman#"
> xmlns:owl="http://www.w3.org/2002/07/owl#"
>>
> 
>  <rdf:Property 
> rdf:about="http://www.w3.org/WAI/ER/EARL/nmg-strawman#lineCharLength">
>    <rdfs:label xml:lang="en">line char length</rdfs:label>
>    <rdfs:comment xml:lang="en">The location, represented by a line char 
> length</rdfs:comment>
>    <rdfs:range 
> rdf:resource="http://www.w3.org/WAI/ER/EARL/nmg-strawman#LineCharLength"/>
>  </rdf:Property>
> 
> <rdfs:Class 
> rdf:about="http://www.w3.org/WAI/ER/EARL/nmg-strawman#LineCharLength">
>    <rdfs:label xml:lang="en">LineCharLength</rdfs:label>
>    <rdfs:comment xml:lang="en">The line/character and optionally length 
> of a piece of interest</rdfs:comment>
>  <owl:Restriction>
>     <owl:onProperty 
> rdf:resource="http://www.w3.org/WAI/ER/EARL/nmg-strawman#line"/>
>    <owl:minCardinality 
> rdf:datatype="http://www.w3.org/2001/XMLSchema#nonNegativeInteger">1</owl:minCardinality> 
> 
>   <owl:maxCardinality 
> rdf:datatype="http://www.w3.org/2001/XMLSchema#nonNegativeInteger">1</owl:maxCardinality> 
> 
>  </owl:Restriction>
>  <owl:Restriction>
>     <owl:onProperty 
> rdf:resource="http://www.w3.org/WAI/ER/EARL/nmg-strawman#char"/>
>    <owl:minCardinality 
> rdf:datatype="http://www.w3.org/2001/XMLSchema#nonNegativeInteger">1</owl:minCardinality> 
> 
>   <owl:maxCardinality 
> rdf:datatype="http://www.w3.org/2001/XMLSchema#nonNegativeInteger">1</owl:maxCardinality> 
> 
>  </owl:Restriction>
>  <owl:Restriction>
>     <owl:onProperty 
> rdf:resource="http://www.w3.org/WAI/ER/EARL/nmg-strawman#length"/>
>    <owl:minCardinality 
> rdf:datatype="http://www.w3.org/2001/XMLSchema#nonNegativeInteger">0</owl:minCardinality> 
> 
>   <owl:maxCardinality 
> rdf:datatype="http://www.w3.org/2001/XMLSchema#nonNegativeInteger">1</owl:maxCardinality> 
> 
>  </owl:Restriction>
> </rdfs:Class>
> <rdf:Property rdf:about="http://www.w3.org/WAI/ER/EARL/nmg-strawman#line">
>    <rdfs:label xml:lang="en">line</rdfs:label>
>    <rdfs:comment xml:lang="en">The line in a source document</rdfs:comment>
> </rdf:Property>
> <rdf:Property rdf:about="http://www.w3.org/WAI/ER/EARL/nmg-strawman#char">
>    <rdfs:label xml:lang="en">char</rdfs:label>
>    <rdfs:comment xml:lang="en">The character in a line</rdfs:comment>
> </rdf:Property>
> <rdf:Property 
> rdf:about="http://www.w3.org/WAI/ER/EARL/nmg-strawman#length">
>    <rdfs:label xml:lang="en">length</rdfs:label>
>    <rdfs:comment xml:lang="en">The length of a LineCharLength 
> region</rdfs:comment>
> </rdf:Property>
> 
> <rdf:Property 
> rdf:about="http://www.w3.org/WAI/ER/EARL/nmg-strawman#byteOffset">
>   <rdfs:label xml:lang="en">byte offset</rdfs:label>
>   <rdfs:comment xml:lang="en">The number of bytes into the 
> region.</rdfs:comment>
> </rdf:Property>
> 
> <rdf:Property 
> rdf:about="http://www.w3.org/WAI/ER/EARL/nmg-strawman#charOffset">
>   <rdfs:label xml:lang="en">char offset</rdfs:label>
>   <rdfs:comment xml:lang="en">The number of characters into the 
> region.</rdfs:comment>
> </rdf:Property>
> 
> 
> <rdf:Property 
> rdf:about="http://www.w3.org/WAI/ER/EARL/nmg-strawman#xpointer">
>   <rdfs:label xml:lang="en">XPointer</rdfs:label>
>   <rdfs:comment xml:lang="en">An xpointer pointing into the 
> document</rdfs:comment>
> </rdf:Property>
> 
> <rdf:Property 
> rdf:about="http://www.w3.org/WAI/ER/EARL/nmg-strawman#htmlpointer">
>   <rdfs:label xml:lang="en">HTML Pointer</rdfs:label>
>   <rdfs:comment xml:lang="en">An html pointer is similar to an XPointer, 
> but defined over HTML documents, see ...</rdfs:comment>
> </rdf:Property>
> 
> <rdf:Property 
> rdf:about="http://www.w3.org/WAI/ER/EARL/nmg-strawman#snippet">
>   <rdfs:label xml:lang="en">Snippet</rdfs:label>
>   <rdfs:comment xml:lang="en">A pointer to a snippet of the whole 
> content</rdfs:comment>
>   <rdfs:range 
> rdf:resource="http://www.w3.org/WAI/ER/EARL/nmg-strawman#Snippet"/>
> </rdf:Property>
> 
> <rdfs:Class rdf:about="http://www.w3.org/WAI/ER/EARL/nmg-strawman#Snippet">
>    <rdfs:label xml:lang="en">Snippet</rdfs:label>
>    <rdfs:comment xml:lang="en">A part of a document</rdfs:comment>
>  <owl:Restriction>
>     <owl:onProperty 
> rdf:resource="http://www.w3.org/WAI/ER/EARL/nmg-strawman#content"/>
>    <owl:minCardinality 
> rdf:datatype="http://www.w3.org/2001/XMLSchema#nonNegativeInteger">0</owl:minCardinality> 
> 
>   <owl:maxCardinality 
> rdf:datatype="http://www.w3.org/2001/XMLSchema#nonNegativeInteger">1</owl:maxCardinality> 
> 
>  </owl:Restriction>
>  <owl:Restriction>
>     <owl:onProperty 
> rdf:resource="http://www.w3.org/WAI/ER/EARL/nmg-strawman#byteContent"/>
>    <owl:minCardinality 
> rdf:datatype="http://www.w3.org/2001/XMLSchema#nonNegativeInteger">0</owl:minCardinality> 
> 
>   <owl:maxCardinality 
> rdf:datatype="http://www.w3.org/2001/XMLSchema#nonNegativeInteger">1</owl:maxCardinality> 
> 
>  </owl:Restriction>
>  <owl:Restriction>
>     <owl:onProperty 
> rdf:resource="http://www.w3.org/WAI/ER/EARL/nmg-strawman#charOffset"/>
>    <owl:minCardinality 
> rdf:datatype="http://www.w3.org/2001/XMLSchema#nonNegativeInteger">0</owl:minCardinality> 
> 
>   <owl:maxCardinality 
> rdf:datatype="http://www.w3.org/2001/XMLSchema#nonNegativeInteger">1</owl:maxCardinality> 
> 
>  </owl:Restriction>
>  <owl:Restriction>
>     <owl:onProperty 
> rdf:resource="http://www.w3.org/WAI/ER/EARL/nmg-strawman#byteOffset"/>
>    <owl:minCardinality 
> rdf:datatype="http://www.w3.org/2001/XMLSchema#nonNegativeInteger">0</owl:minCardinality> 
> 
>   <owl:maxCardinality 
> rdf:datatype="http://www.w3.org/2001/XMLSchema#nonNegativeInteger">1</owl:maxCardinality> 
> 
>  </owl:Restriction>
> 
> </rdfs:Class>
> 
> <rdf:Property 
> rdf:about="http://www.w3.org/WAI/ER/EARL/nmg-strawman#content">
>   <rdfs:label xml:lang="en">Content</rdfs:label>
>   <rdfs:comment xml:lang="en">Some content that is a snippet of a 
> document.</rdfs:comment>
>   <rdfs:domain 
> rdf:resource="http://www.w3.org/WAI/ER/EARL/nmg-strawman#Snippet"/>
> </rdf:Property>
> 
> <rdf:Property 
> rdf:about="http://www.w3.org/WAI/ER/EARL/nmg-strawman#byteContent">
>   <rdfs:label xml:lang="en">Byte Content</rdfs:label>
>   <rdfs:comment xml:lang="en">Some content that is a snippet of a 
> document, it has been base64 encoded.</rdfs:comment>
>   <rdfs:domain 
> rdf:resource="http://www.w3.org/WAI/ER/EARL/nmg-strawman#Snippet"/>
> </rdf:Property>
> 
> 
> 
> 
> <rdfs:Class rdf:about="http://www.w3.org/WAI/ER/EARL/nmg-strawman#XPath">
>    <rdfs:label xml:lang="en">XPath Class </rdfs:label>
>    <rdfs:comment xml:lang="en">An XPath class that encapsulates an XPath 
> expression and prefixes</rdfs:comment>
>  <owl:Restriction>
>     <owl:onProperty 
> rdf:resource="http://www.w3.org/WAI/ER/EARL/nmg-strawman#expression"/>
>    <owl:minCardinality 
> rdf:datatype="http://www.w3.org/2001/XMLSchema#nonNegativeInteger">1</owl:minCardinality> 
> 
>   <owl:maxCardinality 
> rdf:datatype="http://www.w3.org/2001/XMLSchema#nonNegativeInteger">1</owl:maxCardinality> 
> 
>  </owl:Restriction>
>  <owl:Restriction>
>   <owl:onProperty 
> rdf:resource="http://www.w3.org/WAI/ER/EARL/nmg-strawman#xpathNamespaces"/>
>    <owl:minCardinality 
> rdf:datatype="http://www.w3.org/2001/XMLSchema#nonNegativeInteger">0</owl:minCardinality> 
> 
>  </owl:Restriction>
> </rdfs:Class>
> 
> <rdf:Property 
> rdf:about="http://www.w3.org/WAI/ER/EARL/nmg-strawman#expression">
>   <rdfs:label xml:lang="en">Expression</rdfs:label>
>   <rdfs:comment xml:lang="en">An XPath expression.</rdfs:comment>
>   <rdfs:domain 
> rdf:resource="http://www.w3.org/WAI/ER/EARL/nmg-strawman#XPath"/>
> </rdf:Property>
> 
> <rdf:Property 
> rdf:about="http://www.w3.org/WAI/ER/EARL/nmg-strawman#xpathNamespace">
>   <rdfs:label xml:lang="en">XPath namespace</rdfs:label>
>   <rdfs:comment xml:lang="en">A namespace used in a particular xpath 
> expression</rdfs:comment>
>   <rdfs:domain 
> rdf:resource="http://www.w3.org/WAI/ER/EARL/nmg-strawman#XPath"/>
>   <rdfs:range 
> rdf:resource="http://www.w3.org/WAI/ER/EARL/nmg-strawman#Namespace"/>
> </rdf:Property>
> 
> <rdfs:Class 
> rdf:about="http://www.w3.org/WAI/ER/EARL/nmg-strawman#Namespace">
>    <rdfs:label xml:lang="en">Namespace Class </rdfs:label>
>    <rdfs:comment xml:lang="en">A namespace class that relates a prefix 
> to a namespace for an XPath expression</rdfs:comment>
>  <owl:Restriction>
>     <owl:onProperty 
> rdf:resource="http://www.w3.org/WAI/ER/EARL/nmg-strawman#prefix"/>
>    <owl:minCardinality 
> rdf:datatype="http://www.w3.org/2001/XMLSchema#nonNegativeInteger">1</owl:minCardinality> 
> 
>   <owl:maxCardinality 
> rdf:datatype="http://www.w3.org/2001/XMLSchema#nonNegativeInteger">1</owl:maxCardinality> 
> 
>  </owl:Restriction>
>  <owl:Restriction>
>     <owl:onProperty 
> rdf:resource="http://www.w3.org/WAI/ER/EARL/nmg-strawman#namespaceUri"/>
>    <owl:minCardinality 
> rdf:datatype="http://www.w3.org/2001/XMLSchema#nonNegativeInteger">1</owl:minCardinality> 
> 
>   <owl:maxCardinality 
> rdf:datatype="http://www.w3.org/2001/XMLSchema#nonNegativeInteger">1</owl:maxCardinality> 
> 
>  </owl:Restriction>
> </rdfs:Class>
> 
> <rdf:Property 
> rdf:about="http://www.w3.org/WAI/ER/EARL/nmg-strawman#prefix">
>   <rdfs:label xml:lang="en">namespace prefix</rdfs:label>
>   <rdfs:comment xml:lang="en">A namespace prefix</rdfs:comment>
>   <rdfs:domain 
> rdf:resource="http://www.w3.org/WAI/ER/EARL/nmg-strawman#Namespace"/>
> </rdf:Property>
> 
> <rdf:Property 
> rdf:about="http://www.w3.org/WAI/ER/EARL/nmg-strawman#namespaceUri">
>   <rdfs:label xml:lang="en">namespace uri</rdfs:label>
>   <rdfs:comment xml:lang="en">A namespace uri</rdfs:comment>
>   <rdfs:domain 
> rdf:resource="http://www.w3.org/WAI/ER/EARL/nmg-strawman#Namespace"/>
> </rdf:Property>
> 
> 
> 
> </rdf:RDF>
> 
> 
> 

-- 
Shadi Abou-Zahra     Web Accessibility Specialist for Europe | 
Chair & Staff Contact for the Evaluation and Repair Tools WG | 
World Wide Web Consortium (W3C)           http://www.w3.org/ | 
Web Accessibility Initiative (WAI),   http://www.w3.org/WAI/ | 
WAI-TIES Project,                http://www.w3.org/WAI/TIES/ | 
Evaluation and Repair Tools WG,    http://www.w3.org/WAI/ER/ | 
2004, Route des Lucioles - 06560,  Sophia-Antipolis - France | 
Voice: +33(0)4 92 38 50 64          Fax: +33(0)4 92 38 78 22 | 

Received on Tuesday, 11 July 2006 14:19:32 UTC