These basic instructions should be sufficient to install and run mod_accessibility. Further details are provided below, but can be ignored for a basic installation.
LoadFile /usr/local/lib/libxml2.so LoadModule accessibility_module modules/mod_accessibility.so
AddOutputFilter accessibility .html
Apache's standard filter control directives are not quite enough. A problem arises when Apache runs a subrequest - e.g. a .var file used to serve the language requested by a user's browser. If we just use AddOutputFilter, then mod_accessibility will run twice - once as required, but also once to parse the .var file.
To prevent this happening, mod_accessibility by default removes itself
when a handler other than the default HTML handler is in use. To enable
it, the AccessibilityAddHandler is provided (see below).
Use this to add support for the handlers you are using: e.g.
will enable it for CGI scripts, XML applications and as-is files. This is additional to the standard Apache configuration.
For more information about the configuration, see the Apache manual. Except for the AccessibilityAddHandler directive, the above requires only standard Apache directives that should be familiar to any server administrator.
See the configuration page for details of configuring mod_accessibility.
Most mod_accessibility views preserve your stylesheets. However, the Betsie view suppresses all stylesheets, while the Outline and Links views are metadata rather than full views of a page. For each of these views, mod_accessibility links a CSS stylesheet. You can therefore fine-tune the presentation of these views by writing your own betsie.css, links.css and outline.css.
If you need something that's not yet available, it may or may not already be work-in-progress or planned. Please ask.
mod_accessibility fetches remote content by HTTP when it resolves a link (for its title), or includes the contents of a frame. It offers a choice of HTTP Client implementations:
xmlNanoHTTP supports HTTP proxies; the mod_accessibility apr_network_io HTTP implementation doesn't. If you wish mod_accessibility to go through a proxy, you should set the HTTP_PROXY environment variable to specify the proxy, and leave AccessibilityHTTPTimeout unset. Your proxy can be configured to take care of timeouts.
It is recommended that you always give your users a choice of whether or not to filter your pages. There are many ways to accomplish this, but the simplest way is to make your documents available at different URLs with and without mod_accessibility configured.
For example, if your server is
you could leave that as-is, but configure another virtual server at
http://access.example.org/, with identical configuration
but with the addition of an
You could then offer a simple link to each site from the other.
mod_accessibility should be inserted in the output filter chain after any other modules used for content generation - such as mod_include (SSI/.shtml) or XSLT - but before any encoding filters such as mod_gzip or mod_deflate, or of course mod_ssl (secure HTTP encryption), or mod_cache. Apache will take care of the latter automatically, but you need to ensure that it comes after other contents filters.
(mod_accessibility works well after other content filters).
AddOutputFilter INCLUDES;accessibility .shtml or AddOutputFilter modxml-xslt;accessibility .xml
(mod_accessibility should not normally be used before other content filters).
AddOutputFilter accessibility;INCLUDES .shtml or AddOutputFilter accessibility;modxml-xslt .xml
(Under construction - you can probably safely ignore this).
If your server is correctly configured before you add mod_accessibility, it should work correctly (although we don't have the capability to test this). However, a minor error in your configuration, or a sloppy CGI or PHP script, may cause unexpected results. In technical terms, you should ensure that the charset parameter is set in your Content-Type header.
mod_accessibility generates utf-8 (unicode) output. This should be suitable for most servers, as it is supported by browsers, and supports a very wide range of character sets. If you want to generate a different character set, you can do it by inserting another filter, such as mod_charset or mod_charset_lite, after mod_accessibility.