NAME

Uttu::Handler::axkit

SYNOPSIS

[global]
  content_handler = axkit

[axkit]

DESCRIPTION

By setting the global content_handler configuration variable to axkit, AxKit will be called to parse the web pages and create the content.

You probably don't want to use Uttu if all you want is AxKit. If you are wanting the uri-to-filename translations, consider configuring Uttu to handle the translation and not the content. By using Uttu, you are losing some of the flexibility AxKit offers in the Apache configuration process.

That said, the Uttu AxKit handler can make XML transformations of content trivial if you are also wanting to use a secondary handler such as HTML::Mason to provide the XML.

CONFIGURATION

These variables are used to configure the AxKit object. The variable names should be preceeded with axkit_ or placed in an [axkit] section.

TODO: describe each of the configuration variables.

cache_dir

This option takes a single argument and sets the directory that the cache module stores its files in. No caching will take place if this is not set. To disable caching, unset this option.

cache_provider

content_provider

debug_level

If present, this makes AxKit send output to Apche's error log. The valid range is 0-10, with 10 producing more output.

debug_stack_trace

This flag option says whether to maintain a stack trace with every exception.

debug_time

debug_trace_intermediate

With this option, you advise AxKit to store the result of each transformation request in a special directory for debugging.

dependency_checks

document_root

error_stylesheet

If an error occurs during processing that throws an exception, the exception handler will try and find an ErrorStylesheet to use to process an XML-formatted error page.

gzip_output

This option allows you to use the Compress::Zlib module to gzip output to browsers that support gzip compressed pages.

handle_dirs

This option allows AxKit to process directories.

ignore_style_pi

Turn off parsing and overriding stylesheet selection for XML files containing an "xml-stylesheet" processing instruction at the start of the file.

log_declines

This option is a flag (default off). When AxKit declines to process a URI, it gives a reason. Normally this reason is not sent to the log. However, if this option is set, the reason is logged.

map_style

This option maps module stylesheet MIME types to stylesheet processor modules.

output_charset

Fixes the output character set, rather than using either UTF-8 or the user's preference from the Accept-Charset HTTP header.

output_transformer

This option may be used to list output transformers that are applied just before output is sent to the browser.

plugin

This option may be used to list multiple modules whose handler method is called before any AxKit processing is done.

preferred_media

This specifies a default meda type to use.

preferred_style

This specifies a default stylesheet title to use.

process_<media>

<media> may be one of screen, tty, tv, projection, handheld, print, braille, aural, or all. These configuration variables are used to specify how certain styles are processed.

secondary_provider

This should be one of the other handlers supported by Uttu. Currently, this is only mason. The secondary handler is used to provide the content to AxKit and should be configured as if it were the primary Uttu handler. When a secondary handler is specified, the axkit handler uses it to find files. Otherwise, it allows Apache to find them.

style_provider

translate_output

This option enables output character set translation.

xsp_taglib

XSP supports two types of tag libraries. The simplest type to understand is merely an XSLT or XPathScript (or other transformation language) stylesheet that transforms custom tags into the "raw" XSP tag form. However thre is another kind that is faster, and these taglibs transform the custom tags into pure code which then gets compiled. These taglibs must be loaded into the server using this option.

SEE ALSO

AxKit.

AUTHOR

James G. Smith <jsmith@cpan.org>

Much of the configuration option documentation is based on the documentation in the AxKit module.

COPYRIGHT

Copyright (C) 2002-2003 Texas A&M University. All Rights Reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.