NAME

Syntax::Highlight::Perl6 - a Perl 6 syntax highlighter

SYNOPSIS

### NOTE: This is needed and will be removed in future releases
use STD;
use Syntax::Highlight::Perl6;

# Creates the Perl6 syntax highlighter object
my $p = Syntax::Highlight::Perl6->new(
    text => 'my $foo;'
);

# Prints html that can be embedded in your pages
print $p->snippet_html;

# Prints html with css (useful for full pages)
print $p->simple_html;

# Prints html that has a JavaScript node viewer
print $p->full_html;

# Prints ANSI escaped color sequences (useful for console and IRC output)
print $p->ansi_text;

# Prints the Perl 5 array of parse trees (useful for building stuff on top of it) 
print $p->parse_trees;

DESCRIPTION

This module parses Perl 6 source code using STD.pm, then matches nodes to colors and returns them in different output formats. It can be used to create web pages with colorful source code samples in its simple and snippet html modes, or it can be used as a learning tool in examining STD.pm's parsing using the JavaScript node viewer in its full html mode.

The available output formats are:

• HTML (snippet,simple and full)

• ANSI escaped color sequences

• Perl 5 array of parse trees

METHODS

The following methods are available:

new(options)

Returns the syntax highlighting object. It needs a hash of options. The following options are available:

text

This is a required option. This is where you should provide the Perl 6 code.

rule

parse rule name for STD.pm to parse against (default: comp_unit)

inline_resources

Flag to enable/disable CSS/JavaScript HTML inlining. (default: 0 (Disabled))

resource_url

HTML resource url that will be appended when resource inlining is disabled.

page_title

HTML page title for simple_html and full_html (default: '')

utf8_decode

Flag to enable/disable utf8 decoding. (default: 1 (Enabled))

snippet_html()

Returns the Perl 6 highlighted HTML string that can be embedded. No CSS or JavaScript is inside.

simple_html()

Returns the Perl 6 highlighted HTML string. The HTML code is the same as full_html but lacks a JavaScript Parse Tree Viewer.

full_html()

Returns the Perl 6 highlighted HTML string. The HTML consists of a JavaScript Parse Tree Viewer along with CSS-styling. It can inlined if inline_resources option is 1.

ansi_text()

Returns a Perl highlighted ANSI escape color string.

parse_trees()

Returns a Perl 5 array containing parse tree records. The array consists of one or more of the following record:

+-----------------------------------------------+
| Matched  | Matched | Matched   | Parse tree   |
| Start    | string  | rule      | separated    |
| Position | buffer  | name      | by spaces    |
+-----------------------------------------------+

#...
use Data::Dumper;
print Dumper($p->parse_trees);

#$VAR1 = [
#      [
#        8,
#        ';',
#        0,
#        'statementlist eat_terminator '
#      ]

SEE ALSO

Discussion about this module and STD.pm is usually in #perl6 @ irc.freenode.net

Larry Wall's STD.pm lives in http://svn.pugscode.org/pugs/src/perl6/

BUGS

What's a programmer's life without a few bugs to solve:

Can't call method "bless" on an undefined value at STD.pm line 5269.

You have to put "use STD;" before using this module.

use STD; # this must be first for now
use Syntax::Highlight::Perl6;

A log file is always created when using this module.

This is a bug and im working on it. Most probably it is STD.pm-related

Directory 'lex' is created when using this module.

STD.pm caches digraphs and the matched rules in there. So this is Pretty Voodoo Stuff. Otherwise it will be pretty slow.

Slow startup when using the module for the first time

That is related to the creation of the cached 'lex'ing directory by STD.pm. This happens only once.

AUTHOR

Ahmad Zawawi, <ahmad.zawawi@gmail.com>

Written by Ahmad M. Zawawi (azawawi), Moritz Lenz and Paweł Murias (pmurias)

The project idea was inspired by Moritz Lenz (moritz) See http://www.nntp.perl.org/group/perl.perl6.users/2008/07/msg788.html

The initial STD tree traversal code was written by Paweł Murias (pmurias).

A gimme5-generated Perl5 STD.pmc is included to parse Perl 6 code.

The redspans traversal code was written by Larry Wall (TimToady).

redspans stands for red for reductions, and spans from the from/to span calculations".

The JavaSript jQuery code was written by Ahmad M. Zawawi (azawawi)

COPYRIGHT AND LICENSE

Copyright (C) 2008 by Ahmad Zawawi

This library is free software; you can redistribute it and/or modify it under the same terms as the Artistic License 2.0

This library also includes the following libraries:

STD.pm by Larry Wall (Artistic License 2.0 - same license)

JQuery 1.2.6 by John Resig (dual licensed under the MIT and GPL licenses).

cpanm Syntax::Highlight::Perl6

perl -MCPAN -e shell
install Syntax::Highlight::Perl6