Provided by: libarch-perl_0.5.2-1_all bug

NAME

       Arch::FileHighlighter - syntax-highlight file's content using markup

SYNOPSIS

           use Arch::FileHighlighter;
           my $fh = Arch::FileHighlighter->new(
               [ 'internal(pm+c)', 'none(txt), 'enscript', 'internal', ]
           );

           my $html_ref = $fh->highlight($0);
           print $$html_ref;

           print ${$fh->highlight('file.c', '/* some code */')};

DESCRIPTION

       This class processes file contents and produces syntax highlighting markup.  This may be
       used together with css that defines exact text colors and faces.

       The default is to use the builtin "internal" processing, that is pretty poor; only very
       basic file types and syntax constructions are supported.  It is suggested to configure and
       use the external "enscript" utility.  GNU enscript understands quite a rich number of file
       types and produces a useful syntax highlighting. "enscript" filter is used by default if
       /usr/bin/enscript is found.

       It is possible to configure different filters ("none", "internal", "enscript") depending
       on file name extension. In any case the resulting markup is always unified, i.e. all
       special characters are HTML-encoded using SGML entities, and the markup that looks like
       <spanclass="syntax_foo">bar</span> is used.

METHODS

       The following methods are available:

       new, instance, highlight.

       new [filters]
           Create a new instance of Arch::FileHighlighter.

           filters is arrayref of strings of the form filter(ext1+ext2+...)", where filter is one
           of "enscript", "internal" or "none". Special extension ":xml" is a shortcut for
           "html+htm+sgml+xml+wml+rss+glade".  The filters optionally constrained by file
           extensions are probed sequentially and the first passed one is used.

           Note that if enscript is configured in the sequence, but is not installed, then its
           probing may print a warning to stderr. The "enscript" filter is handled a bit
           specially, it may take parameters "mono" (less colors) and "asis" instead of the file
           extensions. If enscript returns html without any tags, then the filter is handled as
           failed, unless "asis" is given.

           By default, filters is [ 'internal' ], or [ 'enscript', 'internal' ] depending on
           presense of '/usr/bin/enscript'.

       instance [filters]
           Alternative constructor. Return the last created instance of Arch::FileHighlighter or
           create a new one.

           The purpose of this alternative constructor is to allow the singleton behaviour as
           well as certain Aspect Oriented Programming practices.

       highlight filename [content]
           Process filename using configured filters (as described in the constructor) and
           produce the file content with embeded <span class="class">...</span> markup. class is
           one of:

               syntax_keyword
               syntax_builtin
               syntax_comment
               syntax_special
               syntax_funcdef
               syntax_vartype
               syntax_string
               syntax_constant

           If content is provided (either string or reference to string), it is used, otherwise
           the content of filename is loaded.

BUGS

       Awaiting for your reports.

AUTHORS

       Mikhael Goikhman (migo@homemail.com--Perl-GPL/arch-perl--devel).

SEE ALSO

       For more information, see enscript, Arch::Util, Syntax::Highlight::Perl.