File Coverage

blib/lib/HTML/WikiConverter/SnipSnap.pm

Criterion	Covered	Total	%
statement	9	33	27.2
branch	0	14	0.0
condition	0	4	0.0
subroutine	3	7	42.8
pod	0	1	0.0
total	12	59	20.3

package HTML::WikiConverter::SnipSnap;

use warnings;
use strict;

use base 'HTML::WikiConverter';

our $VERSION = '0.50';

=head1 NAME

HTML::WikiConverter::SnipSnap - Convert HTML to SnipSnap markup

=head1 SYNOPSIS

  use HTML::WikiConverter;
  my $wc = new HTML::WikiConverter( dialect => 'SnipSnap' );
  print $wc->html2wiki( $html );

=head1 DESCRIPTION

This module contains rules for converting HTML into SnipSnap
markup. See L for additional usage details.

=cut

sub rules {
  my %rules = (
    b => { start => '__', end => '__' },
    strong => { alias => 'b' },
    i => { start => '~~', end => '~~' },
    em => { alias => 'i' },
    strike => { start => '--', end => '--' },

    p => { block => 1, trim => 'both', line_format => 'multi' },
    hr => { replace => "\n\n----\n\n" },
    br => { replace => "\\\\" },

    a => { replace => \&_link },
    blockquote => { start => '{quote}', end => '{quote}' },

    ul => { line_format => 'multi', block => 1 },
    ol => { alias => 'ul' },
    li => { start => \&_li_start, trim => 'leading' },

    table => { start => "{table}\n", end => '{table}', block => 1, line_format => 'multi' },
    tr => { line_format => 'single', end => "\n" },
    td => { end => \&_td_end },
    th => { alias => 'td' },

    h1 => { start => '1 ', block => 1 },
  );

  for( 2..6 ) {
    $rules{"h$_"} = { start => '1.1 ', block => 1 };
  }

  return \%rules;
}

sub _td_end {
  my( $self, $node, $rules ) = @_;
  my @right_cells = grep { $_->tag && $_->tag =~ /th|td/ } $node->right;
  return ' | ' if @right_cells;
  return '';
}

sub _link {
  my( $self, $node, $rules ) = @_;
  my $url = $node->attr('href') || '';
  my $text = $self->get_elem_contents($node) || '';

  if( my $title = $self->get_wiki_page($url) ) {
    $text =~ s~\+~ ~g;
    return "[$text]" if lc $text eq lc $title;
    return "[$text|$title]";
  } else {
    return $url if $url eq $text;
    return "{link:$text|$url}";
  }
}

sub _li_start {
  my( $self, $node, $rules ) = @_;

  my $bullet = $node->parent->tag eq 'ol' ? '1' : '*';
  my @parents = $node->look_up( _tag => qr/ul|ol/ );
  my $prefix = ( $bullet ) x @parents;
  $prefix .= '.' if $node->parent->tag eq 'ol';

  return "\n$prefix ";
}

=head1 AUTHOR

David J. Iberri, C<<  >>

=head1 BUGS

Please report any bugs or feature requests to
C, or through the web
interface at
L.
I will be notified, and then you'll automatically be notified of
progress on your bug as I make changes.

=head1 SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc HTML::WikiConverter::SnipSnap

You can also look for information at:

=over 4

=item * AnnoCPAN: Annotated CPAN documentation

L

=item * CPAN Ratings

L

=item * RT: CPAN's request tracker

L

=item * Search CPAN

L

=back

=head1 COPYRIGHT & LICENSE

Copyright 2006 David J. Iberri, all rights reserved.

This program is free software; you can redistribute it and/or modify
it under the same terms as Perl itself.

=cut

1;