=begin rakudoc :type<plugin>

Introduction

This plugin replaces the code-block template so that the highlight-js library is included to highlight code according to the :lang attribute.

Raku and RakuDoc code is highlighted using either:

• @Lizmat's Deparse highlighter,

• or @PatrickBoker's Rainbow highlighter (the default).

Since the Deparse highlighter requires correct Raku code and generates an error when the code is not correct, while the Rainbow highlighter is more forgiving, the latter is the default.

In order to select the Deparse highlighter, use the option :highlighter<deparse> , eg.,

    =begin code :highlighter<deparse>
    ...
    =end code

Examples

The following are examples of code blocks that are highlighted.

Highlighting status (working/not working and why) is given below the example. Hover for more info.

Other languages (via highlight-js)

Code in Haskell

greeting :: String -> String
greeting  ""   = "Hello, World!"
greeting "bub" = "Hey bub."
greeting  name = "Hello, " ++ name ++ "!"

Code in Ruby

# Ruby
if x > 5
    puts "Bigger!"
elsif x == 5
    puts "The same!"
else
    puts "Smaller!"
end

Code in Python

squares = []
for x in range(5):
    squares.append(lambda: x ** 2)
print(squares[2]())
print(squares[4]())
# both 16 since there is only one x

Raku examples

Inside a code block with no :lang set, so Raku, :highlighter<deparse>

my $x = 2;
# a brilliant program!

Code from indented para

# indenting causes an implicit code block my $raku = 'fantastic';

Code with :allow<B K> so not highlighted

# a renderer should observe the basis markup
# and the markup but render R<markup> verbatim
my $x = 3;

Code from operators, using Rainbow

    my @arr = [10, 20, 30];
    my $i = 0;

    if rand < 1/2 {
        @arr[++$i] += 1;                # @arr = [10,21,30]
    } else {
        @arr[++$i] = @arr[++$i] + 1;    # @arr = [10,31,30] (or [10,20,21]?)
    }                                   # the result may be implementation-specific
    say @arr;

=place semantic:AUTHOR :caption<Credits>

=place semantic:VERSION :!toc =end rakudoc