NAME

Text::MultiMarkdown::ApacheHandler - Processes files with MultiMarkdown syntax for Apache

VERSION

Version 0.01

SYNOPSIS

Processes files containing MultiMarkdown syntax into HTML files and serves them, optionally applying CSS styles according to rules in your httpd.conf or (more likely) .htaccess files. Optionally applies SmartyPants post-processing using Text::Typography.

You might put some lines like this in your ".htaccess" or "httpd.conf" file:

        AddType text/multimarkdown .markdown .mkd .mhtml
        <Files ~ "\.(markdown|mkd|mhtml)$">
                SetHandler perl-script
                PerlHandler Text::MultiMarkdown::ApacheHandler
                PerlSetVar mm_useSmartyPants 1
        </Files>

METHODS

handler: Standard Apache module entry point

AUTHOR

Darren Kulp, "<darren at kulp.ch>"

BUGS

Please report any bugs or feature requests to "bug-text-multimarkdown-apachehandler at rt.cpan.org", or through the web interface at <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Text-MultiMarkdown-ApacheHandler>. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc Text::MultiMarkdown::ApacheHandler

You can also look for information at:

AnnoCPAN: Annotated CPAN documentation
<http://annocpan.org/dist/Text-MultiMarkdown-ApacheHandler>
CPAN Ratings
<http://cpanratings.perl.org/d/Text-MultiMarkdown-ApacheHandler>
RT: CPAN's request tracker
<http://rt.cpan.org/NoAuth/Bugs.html?Dist=Text-MultiMarkdown-ApacheHandler>
Search CPAN
<http://search.cpan.org/dist/Text-MultiMarkdown-ApacheHandler>

TODO

Tests. I haven't yet looked into how to do tests for an Apache module like this; I want to do them more for the experience than the necessity, since there is practically nothing in this module.

ACKNOWLEDGEMENTS

The excellent Text::Markdown module and its author, "Writing Apache Modules with Perl and C" by Lincoln Stein and Doug MacEachern, MultiMarkdown from <http://fletcher.freeshell.org/wiki/MultiMarkdown>, and of course the original Markdown from <http://daringfireball.net/projects/markdown>

COPYRIGHT & LICENSE

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