1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99
|
package Markdent::Handler::HTMLStream::Fragment;
use strict;
use warnings;
use namespace::autoclean;
our $VERSION = '0.40';
use Moose;
use MooseX::SemiAffordanceAccessor;
with 'Markdent::Role::HTMLStream';
sub start_document { }
sub end_document { }
__PACKAGE__->meta->make_immutable;
1;
# ABSTRACT: Turns Markdent events into an HTML fragment
__END__
=pod
=encoding UTF-8
=head1 NAME
Markdent::Handler::HTMLStream::Fragment - Turns Markdent events into an HTML fragment
=head1 VERSION
version 0.40
=head1 DESCRIPTION
This class takes an event stream and turns it into an HTML document, without a
doctype, C<< <html> >>, C<< <head> >> or C<< <body> >> tags.
=head1 METHODS
This role provides the following methods:
=head2 Markdent::Handler::HTMLStream::Document->new(...)
This method creates a new handler. It accepts the following parameters:
=over 4
=item * output => $fh
The file handle or object to which HTML output will be streamed. If you want to
capture the output in a string, you can open a filehandle to a string:
my $buffer = q{};
open my $fh, '>', \$buffer;
If you pass a file handle (or L<IO::Handle> object), then all calls to
C<print()> will be checked, and an error will be thrown.
You can pass an object of any other class, it must implement its own C<print()>
method, and error handling is left up to this method.
=back
=head1 ROLES
This class does the L<Markdent::Role::HTMLStream>,
L<Markdent::Role::EventsAsMethods>, and L<Markdent::Role::Handler> roles.
=head1 BUGS
See L<Markdent> for bug reporting details.
Bugs may be submitted at L<https://github.com/houseabsolute/Markdent/issues>.
I am also usually active on IRC as 'autarch' on C<irc://irc.perl.org>.
=head1 SOURCE
The source code repository for Markdent can be found at L<https://github.com/houseabsolute/Markdent>.
=head1 AUTHOR
Dave Rolsky <autarch@urth.org>
=head1 COPYRIGHT AND LICENSE
This software is copyright (c) 2021 by Dave Rolsky.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
The full text of the license can be found in the
F<LICENSE> file included with this distribution.
=cut
|