This is mod_annodex version 0.2.2 for Apache 2.0.

See http://www.annodex.net/software/mod_annodex/ for updates and detailed
usage information.

What does it do?
================

mod_annodex provides full support for Annodex.net media. For more details
about annodex format, see http://www.annodex.net/

mod_annodex is a handler for type application/x-annodex. It provides the
following features:

	* dynamic generation of Annodex media from CMML files.

	* handling of timed query offsets, such as

	  http://media.example.com/fish.anx?t=npt:01:20.8
        or
	  http://media.example.com/fish.anx?id=Preparation
	
	* dynamic retrieval of CMML summaries, if the Accept: header
	  prefers type text/x-cmml over application/x-annodex.

Building and installing
-----------------------

This tarball was developed on Debian GNU/Linux. To build on Debian, do
the following:

	0. ensure you have the appropriate apache2-*-dev package for
	   your apache2 installation.
	1. Type 'make' to build
	2. Type 'make install' to place the module into the correct
	   directory for Apache to find it.

On other systems, you may need to modify the Makefile appropriately.
A good starting point is to use apxs to generate a Makefile for you.
'apxs -g -n fish' will generate template apache module source in a
directory called fish; its Makefile contains the correct Apache paths
and build options for your system. Note that on some systems apxs for
Apache 2.0 is named apxs2.

Configuration
-------------

As with any Apache module, you must modify your httpd.conf to enable
mod_annodex. The following example sets mod_annodex to be the handler
for all .anx files:

# Support for Annodex media
LoadModule annodex_module /usr/lib/apache2/modules/mod_annodex.so

<IfModule mod_annodex.c>
    # Enable mod_annodex for all .anx files
    AddHandler annodex .anx
</IfModule>

annodex.load and annodex.conf files for Debian's /etc/apache2/mods-available 
directory are provided in the mod_annodex-ap20 source distribution.

Contact
-------

Please use the annodex-users mailing list to discuss configuration and
usage of this module.

Copyright
---------

Copyright (C) 2003, 2004, 2005 CSIRO Australia

This is free software, available under the terms of the Apache Software
License 1.1. See the file LICENSE for details.

Conrad Parker, Silvia Pfeiffer
Annodex.net