NAME Apache::Clickable - Make URLs and Emails in HTML clickable SYNOPSIS # in httpd.conf <Location /clickable> SetHandler perl-script PerlHandler Apache::Clickable </Location> # filter aware PerlModule Apache::Clickable SetHandler perl-script PerlSetVar Filter On PerlHandler Apache::Clickable Apache::AntiSpam Apache::Compress DESCRIPTION Apache::Clickable is a filter to make URLs in HTML clickable. With URI::Find and Email::Find, this module finds URL and Email in HTML document, and automatically constructs hyperlinks for them. For example, <body> Documentation is available at http://www.foobar.com/ freely.<P> someone@foobar.com </body> This HTML would be filtered to: <body> Documentation is available at <a href="http://www.foobar.com/">http://www.foobar.com</a> freely.<P> <a href="mailto:someone@foobar.com">someone@foobar.com</a> </body> This module is Filter aware, meaning that it can work within Apache::Filter framework without modification. CONFIGURATION PerlSetVar ClickableTarget _blank PerlSetVar ClickableEmail Off ClickableTarget PerlSetVar ClickableTarget _blank specifies target window name of hyperlinks. If set "_blank" for example, it filters to: <a href="http://www.foobar.com/" target="_blank">http://www.foobar.com/</a> None by default. ClickableEmail PerlSetVar ClickableEmail Off specifies whether it makes email clickable. On by default. See the Apache::AntiSpam manpage for more. TODO * Configurable hyperlink construction using subclass. * Currently, this module requires HTML::Parser, not to make duplicate hyperlinks. Maybe this can be done without HTML::Parser. AUTHOR Tatsuhiko Miyagawa <miyagawa@bulknews.net> This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. SEE ALSO the Apache::Filter manpage, the Apache::AntiSpam manpage, the URI::Find manpage, the Email::Find manpage, the HTML::Parser manpage