wsmo logo

Persistent URIs for WSMO and WSML deliverables

WSMO Note 24 March 2004

This version:
http://www.wsmo.org/2004/NOTE-URIs/20040324/
Latest version:
http://www.wsmo.org/2004/NOTE-URIs/
Editor:
Jos de Bruijn

This document is also available in non-normative PDF version.
Copyright © 2004 DERI®, All Rights Reserved. DERI liability, trademark, document use, and software licensing rules apply.


Abstract

This note describes the way URIs (Uniform Resource Identifiers) [] for working drafts in the WSMO and WSML Working Groups should look. We also provide some useful tips on implementing these rules can be implemented on the current Apache web server, which hosts the wsmo.org web site.

Table of contents

1. WSMO Working Draft URIs
2. Reaching the latest version of a certain version of a WSMO Working Draft
3. Reaching the latest version of a WSMO Working Draft
Appendix A. URL Rewriting on the Apache web server
Acknowledgement


1. WSMO Working Draft URIs

This section is normative

This section contains the rules for persistent URIs, which are used to give different versions of working drafts in the WSMO and WSML Working Groups are permanent presence on the World Wide Web.

The URI of a WSMO[1] working draft consists of the following parts:

http://www.wsmo.org/year/deliverable-number/[sub-deliverable-number/]version/date/

A more detailed description per item in the URI:

year
The year the working draft was written, in the usual four character notation, e.g. 2004.
deliverable-number
The (top-level) number of the working draft, including the lower-case 'd' character, e.g. d16.
sub-deliverable-number (optional)
The sub-deliverable number, including the top-level deliverable number, the lower-case 'd' character and the '.' indicating the separation between the top-level deliverable number and the sub-deliverable number, e.g. d16.2.
version
The version of the working draft, including the lower-case 'v' character and the '.' indicating the separation between the major and the minor version, e.g. v0.1.
date
The date of the working draft in the convenient yyyymmdd format, e.g. 20040324.

As an example, the March 24, 2004 version of deliverable 16.2 version 0.1 should be persistently available at the following URI:

http://www.wsmo.org/2004/d16/d16.2/v0.1/20040324/

2. Reaching the latest version of a certain version of a WSMO Working Draft

This section is normative

The URI of the latest version of a certain version of a WSMO working draft consists of the following parts:

http://www.wsmo.org/year/deliverable-number/[sub-deliverable-number/]version/

When the browser accesses a URI of this type, the browser should be automatically redirected to the latest version (see Appendix A for an example of doing this on an Apache web server).

For example, if the user wants to access the latest version of deliverable 16.2, version 0.1, the user needs to access the following URI:

http://www.wsmo.org/2004/d16/d16.2/v0.1/

Assuming that the latest version of d16.2 v0.1 is dated March 24, 2004, the browser is redirected to the following URI:

http://www.wsmo.org/2004/d16/d16.2/v0.1/20040324/

3. Reaching the latest version of a WSMO Working Draft

This section is normative

The URI of the latest version of a WSMO working draft consists of the following parts:

http://www.wsmo.org/year/deliverable-number/[sub-deliverable-number/]

When the browser accesses a URI of this type, the browser should be automatically redirected to the current version (see Appendix A for an example of doing this on an Apache web server).

For example, if the user wants to access the current version of deliverable 16, the user needs to access the following URI:

http://www.wsmo.org/2004/d16/d16.2/

Assuming that the current version of d16.2 is 0.1, the browser is redirected to the following URI:

http://www.wsmo.org/2004/d16/d16.2/v0.1/

Appendix A. URL Rewriting on the Apache web server

This section is non-normative

As we have seen in section 2 and section 3, every working draft needs HTTP redirects in two locations. The first is the deliverable level, where a redirect is necessary to the current version of the deliverable. The second is the version level, where a redirect to the latest version is necessary.

This appendix shows by example how both these redirects can be achieved on an Apache web server (such as the one on which the wsmo.org web site is currently hosted).

The example used in this appendix is WSMO deliverable d16.2 with current version v0.1 and latest version March 24, 2004. This version of the deliverable is available from:

http://www.wsmo.org/2004/d16/d16.2/v0.1/20040324/

Our goal is to implement HTTP redirects to this version of the deliverable from the following URIs:

http://www.wsmo.org/2004/d16/d16.2/v0.1/
http://www.wsmo.org/2004/d16/d16.2/

One way to implement these HTTP redirects on an Apache web server is use the .htaccess file to implement URL rewriting.

We first implement the redirect from http://www.wsmo.org/2004/d16/d16.2/v0.1/ to http://www.wsmo.org/2004/d16/d16.2/v0.1/20040324/ by creating a file .htaccess in the directory http://www.wsmo.org/2004/d16/d16.2/v0.1/ on the web server, with the following content:

RedirectMatch /2004/d16/d16.2/v0.1/$ http://www.wsmo.org/2004/d16/d16.2/v0.1/20040324/

We then implement the redirect from http://www.wsmo.org/2004/d16/d16.2/ to http://www.wsmo.org/2004/d16/d16.2/v0.1/ by creating a file .htaccess in the directory http://www.wsmo.org/2004/d16/d16.2/ on the web server, with the following content:

RedirectMatch /2004/d16/d16.2/$ http://www.wsmo.org/2004/d16/d16.2/v0.1/

This concludes the implementation of the required HTTP redirects.

Acknowledgement

The work is funded by the European Commission under the projects DIP, Knowledge Web, Ontoweb, SEKT, SWWS, Esperonto, and h-TechSight; by Science Foundation Ireland under the DERI-Lion project; and by the Vienna city government under the CoOperate programme.

The editors would like to thank to all the members of the WSMO working group for their advice and input to this document.


[1] The WSMO and WSML Working Groups share the same URI space for working drafts and use the same numbering for working drafts. Therefore, all rules presented for WSMO working drafts also apply for WSML working drafts.


$Date: 2004/03/24 20:18:48 $

webmaster