Rubric::Entry::Formatter - a base class for entry body formatters
version 0.157
This class serves as a single point of dispatch for attempts to format entry bodies from their native format into rendered output.
This code is effectively abandonware. Although releases will sometimes be made to update contact info or to fix packaging flaws, bug reports will mostly be ignored. Feature requests are even more likely to be ignored. (If someone takes up maintenance of this code, they will presumably remove this notice.) This means that whatever version of perl is currently required is unlikely to change -- but also that it might change at any new maintainer's whim.
format
my $formatted = Rubric::Entry::Formatter->format(\%arg);
This method accepts a set of named arguments and returns formatted output in the requested format. If it is unable to do so, it throws an exception.
Valid arguments are:
markup - the markup format used to mark up the text (default: _default) text - the text that has been marked up and should be formatted (required) format - the requested output format (required)
Formatting requests are dispatched according to the configuration in markup_formatter.
markup_formatter
Writing a formatter should be very simple; the interface is very simple, although it's also very young and so it may change when I figure out the problems in the current implementation.
A formatter must implement an as_FORMAT method for each format to which it claims to be able to output formatted text. When Rubric::Entry::Formatter wants to dispatch text for formatting, it will call that method as follows:
as_FORMAT
my $formatted = Formatter->as_whatever(\%arg);
The arguments in %arg will be the same as those passed to Rubric::Entry::Formatter.
%arg
Actually, the method is found and called via can, so a suitably programmed module can respond to can to allow it to render into all the format it likes -- or at least to claim to.
can
Ricardo SIGNES <rjbs@semiotic.systems>
This software is copyright (c) 2004 by Ricardo SIGNES.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install Rubric, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Rubric
CPAN shell
perl -MCPAN -e shell install Rubric
For more information on module installation, please visit the detailed CPAN module installation guide.