package Text::Markup::Textile;
use 5.8.1;
use strict;
use File::BOM qw(open_bom);
use Text::Textile '2.10';
our $VERSION = '0.17';
sub parser {
my ($file, $encoding, $opts) = @_;
my $textile = Text::Textile->new(
charset => 'utf-8',
char_encoding => 0,
trim_spaces => 1,
@{ $opts || [] }
);
open_bom my $fh, $file, ":encoding($encoding)";
local $/;
my $html = $textile->process(<$fh>);
return unless $html =~ /\S/;
utf8::encode($html);
return qq{<html>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
</head>
<body>
$html
</body>
</html>
};
}
1;
__END__
=head1 Name
Text::Markup::Textile - Textile parser for Text::Markup
=head1 Synopsis
my $html = Text::Markup->new->parse(file => 'README.textile');
=head1 Description
This is the L<Textile|http://www.textism.com/tools/textile/> parser for
L<Text::Markup>. It reads in the file (relying on a
L<BOM|http://www.unicode.org/unicode/faq/utf_bom.html#BOM>), hands it off to
L<Text::Textile> for parsing, and then returns the generated HTML as an
encoded UTF-8 string with an C<http-equiv="Content-Type"> element identifying
the encoding as UTF-8.
It recognizes files with the following extension as Textile:
=over
=item F<.textile>
=back
=head1 Author
David E. Wheeler <david@justatheory.com>
=head1 Copyright and License
Copyright (c) 2011-2012 David E. Wheeler. Some Rights Reserved.
This module is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.
=cut