Changes between Version 15 and Version 16 of schema/xpointer

Timestamp:

Mar 23, 2011, 3:04:27 PM (13 years ago)

Author:

jwillenborg

Comment:

--

schema/xpointer

@@ -35 +35 @@
 * XPointer to an element on a page in an XML document. The result of the XPointer URL is the page and the requested element is highlighted. Example: 
   * <p>Joey Ramone said: "When we started up in March of ’74, it was because the bands we loved, the rock ’n’ roll that we knew, had disappeared. We were playing music for ourselves." (see <ref target="http://mpdl-proto.mpiwg-berlin.mpg.de/tei/en/ramones_2004.xml#xpointer(id('page6')/tei[1]/text[1]/body[1]/chap[1]/p[1]/s[2])">page 6, sentence 2</ref>).</p>
-* XPointer to a text portion of an element on a page in an XML document. The result of the XPointer URL is the page and the requested text portion of the element is highlighted. Example: 
-  * <p>The Ramones started up in March 1974 (see <ref target="http://mpdl-proto.mpiwg-berlin.mpg.de/tei/en/ramones_2004.xml#xpointer(id('page6')/tei[1]/text[1]/body[1]/chap[1]/p[1]/s[1]/range(1.22, 1.34))">page 6, sentence 1, character 22 to 32</ref>).</p>
+* XPointer to a text portion (range) of an element on a page in an XML document. The result of the XPointer URL is the page and the requested text portion of the element is highlighted.
+  * function range with two parameters (easy but not standard xpointer range notation): 
+    * from: start point of the range as count of text characters from the beginning of all the text nodes of the element
+    * to: end point of the range as count of text characters from the beginning of all the text nodes of the element
+  * Example: 
+    * <p>The Ramones started up in March 1974 (see <ref target="http://mpdl-proto.mpiwg-berlin.mpg.de/tei/en/ramones_2004.xml#xpointer(id('page6')/tei[1]/text[1]/body[1]/chap[1]/p[1]/s[1]/range(22, 34))">page 6, sentence 1, character 22 to 32</ref>).</p>
 
 External user annotations of documents are stored relative to document pages by mapping XPointer page points/ranges to an internal identifier as a combination of document identifier, page number, element xpath expression, and a point/range expression. Example:
 * before the first sentence on page 6: /tei/en/ramones_2004.xml, page6, /tei[1]/text[1]/body[1]/chap[1]/p[1]/s[1], point(.0)
 * after the first sentence on page 6: /tei/en/ramones_2004.xml, page6, /tei[1]/text[1]/body[1]/chap[1]/p[1]/s[1], point(.1)
-* from character 22 to 34 in the first sentence of page 6: /tei/en/ramones_2004.xml, page6, /tei[1]/text[1]/body[1]/chap[1]/p[1]/s[1], range(1.22, 1.34)
+* from character 22 to 34 in the first sentence of page 6: /tei/en/ramones_2004.xml, page6, /tei[1]/text[1]/body[1]/chap[1]/p[1]/s[1], range(22, 34)
 
 === XLink ===
@@ -121 +125 @@
       * the id is not intuitive
 * point/range expression
-  * point(.0) or point(.1) or range(1.22, 1.34)
+  * point(.0) or point(.1) or range(22, 34)
     * Advantages
       * pointers could point to a text portion
@@ -145 +149 @@
       * the broken link is sent to the older version of the document if a versioning system is running or an error message is given that the document has changed
 * point/range expression
-  * point(.0) or point(.1) or range(1.22, 1.34)
+  * point(.0) or point(.1) or range(22, 34)
     * Reasons
       * compatible with XPointer, only this alternative