/ 
Text-Markup-0.33
River stage one • 1 direct dependent • 1 total dependent
/ Text::Markup::Asciidoctor

Name

Text::Markup::Asciidoc - Asciidoc parser for Text::Markup

Synopsis

use Text::Markup::Asciidoctor;
my $html = Text::Markup->new->parse(file => 'hello.adoc');
my $raw = Text::Markup->new->parse(
    file    => 'hello.adoc',
    options => [raw => 1],
);

Description

This is the Asciidoc parser for Text::Markup. It depends on the asciidoctor command-line application; see the installation docs for details, or use the command gem install asciidoctor. Note that Text::Markup does not load this module by default, but when loaded manually will replace Text::Markup::Asciidoc as preferred Asciidoc parser.

Text::Markup::Asciidoctor reads in the file (relying on a BOM), hands it off to asciidoctor for parsing, and then returns the generated HTML as an encoded UTF-8 string with an http-equiv="Content-Type" element identifying the encoding as UTF-8.

Text::Markup::Asciidoctor recognizes files with the following extensions as Asciidoc:

.asciidoc
.asc
.adoc

To change it the files it recognizes, load this module directly and pass a regular expression matching the desired extension(s), like so:

use Text::Markup::AsciiDoctor qr{ski?doc};

Normally this parser returns the output of asciidoctor wrapped in a minimal HTML page skeleton. If you would prefer to just get the exact output returned by asciidoctor, you can pass in a true value for the raw option.

Author

David E. Wheeler <david@justatheory.com>

Copyright and License

Copyright (c) 2012-2024 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.