W3CAnnotea

DRAFT

Instructions to use Dom's XSLT annotation script

Dominique Hazaël-Massieux created a cool XSLT script with which let's users see the annotations attached to a html page in any browser.

1. Usage

Open the dialog box shown in Figure 1.1.

The URI of the HTML page that you want to see the annotations of at is to be filled in to the first input field and the annotea server to the second field. You can also select if you want to see the body of the annotations in a tooltip.

image of page: http://www.w3.org/2003/12/annotea-show

Figure 1.1: Dialog box for presenting annotations on a page

After you click the "Show" button the annotations appear as shown in Figure 1.2. Annotations with a well defined place are presented with a pencil in their actual place. In addition all annotations are presented in a retractable list on a side bar. (Need to check from Dom if the sidebar can be located next to the page, not on top of it.)

presenting annotations an a page with dom's script

Figure 1.2: Presenting annotations on W3C home page by using Dom's XSLT script.

The HTML interface also provides a checkbox for making this view optional. This makes it easy to show and hide the annotations.

The dialog box creates a link that integrates several Web-technologies:

In the following is a sample link to W3C home page retrieving annotations from W3C test server with http://annotest.w3.org/annotations.

http://www.w3.org/2000/06/webdata/xslt?xslfile=http%3A%2F%2Fwww.w3.org%2F2003%2F12%2Fannotea-proxy&xmlfile=http%3A%2F%2Fcgi.w3.org%2Fcgi-bin%2Ftidy-if%3FdocAddr%3Dhttp%253A%252F%252Fwww.w3.org%252F&annoteaServer=http%3A%2F%2Fannotest.w3.org%2Fannotations&tooltip=1

3. Restrictions

So far we have tested it with couple of browsers. IE had problems in knowing which application to use for showing the annotation body. But Dom promised to correct this.

The script currently it has the following restrictions:

  1. The XPointer implementation let's you see only the annotations that are related to a fragment ID in place. Others are shown on the side bar. Hopefully the XPointer implementation can be made smarter. (We plan to create a wishlist of some things that are needed.)
  2. Currently the script only works with public annotation servers such as the http://annotest.w3.org/annotations server.

Marja-Riitta Koivunen
Last Modified $Date: 2004/01/23 14:51:14 $

Copyright © 1999-2003 W3C® (MIT, ERCIM, Keio), All Rights Reserved. W3C liability, trademark, document use and software licensing rules apply. Your interactions with this site are in accordance with our public and Member privacy statements.