File Coverage

blib/lib/HTML/WikiConverter/Txt2tags.pm

Criterion	Covered	Total	%
statement	9	69	13.0
branch	0	36	0.0
condition	0	44	0.0
subroutine	3	11	27.2
pod	0	3	0.0
total	12	163	7.3

package HTML::WikiConverter::Txt2tags;

use warnings;
use strict;

use base 'HTML::WikiConverter';

our $VERSION = '0.04';

=head1 NAME

HTML::WikiConverter::Txt2tags - Convert HTML to Txt2tags markup

=head1 SYNOPSIS

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

or

  html2wiki --dialect Txt2tags file.html

or

  curl --silent  http://theody.net/elements.html |  html2wiki --dialect Txt2tags > elements.t2t


=head1 DESCRIPTION

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

See L for more information on Txt2tags.



=cut

sub attributes { {
  camel_case => { default => 0 }
} }

sub rules {
  my %rules = (
    b => { start => '**', end => '**' },
    strong => { alias => 'b' },
    i => { start => '//', end => '//' },
    em => { alias => 'i' },
    cite => { alias => 'i' },
    u => { start => '__', end => '__' },
    s => { start => '--', end => '--' },

    tt => { start => '``', end => '``' },
    code => { alias => 'tt' },
    a => { replace => \&_link },
    img => { replace => \&_image },

    pre => { start => "```\n", end => "\n```", block => 1, line_format => 'blocks', trim => 'none' },
    blockquote => { start => "\n", line_prefix => "\t", block => 1, line_format => 'multi', trim => 'leading' },

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

    sup => { preserve => 1 },
    sub => { preserve => 1 },
    del => { alias => 's' },


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

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

    dt => { start => ":", end => "\n"},
    dd => { start => "  ", end => "\n"},
    span => { preserve => 0 },
  );


  $rules{h1} = { start => "LINEBREAK= ", end => ' =LINEBREAK', block => 1, trim => 'both', line_format => 'single', line_prefix => "" };

  $rules{h2} = { start => "LINEBREAK== ", end => " ==LINEBREAK", block => 1, trim => 'both', line_format => 'single', line_prefix => ""};

  $rules{h3} = { start => "LINEBREAK=== ", end => " ===LINEBREAK", block => 1, trim => 'both', line_format => 'single', line_prefix => "" };

  $rules{h4} = { start => "LINEBREAK==== ", end => ' ====LINEBREAK', block => 1, trim => 'both', line_format => 'single', line_prefix => "" };

  $rules{h5} = { start => "LINEBREAK===== ", end => ' =====LINEBREAK', block => 1, trim => 'both', line_format => 'single' };

  $rules{h6} = { start => "LINEBREAK====== ", end => ' ======LINEBREAK', block => 1, trim => 'both', line_format => 'single' };

  return \%rules;
}

sub postprocess_output {
  my( $self, $outref ) = @_;
  $$outref =~ s~^>+\s+~~gm; # rm empty blockquote prefixes
  $$outref =~ s~^(>+)~$1 ~gm; # add space after prefix for clarity
  $$outref =~ s/LINEBREAK/\n\n/gm; # forces linebreak when \n are not enough

}

sub _li_start {
my( $self, $node, $rules ) = @_;
  my $bullet = '';
  $bullet = '-'  if $node->parent->tag eq 'ul';
  $bullet = '+' if $node->parent->tag eq 'ol';
  return "\n$bullet ";
}

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) ) {
    # [[MiXed cAsE]] ==> MiXed cAsE
    $title =~ s/_/ /g;
    return $text if $self->camel_case and lc $title eq lc $text and $self->is_camel_case($text);
    return "[[$text]]" if lc $text eq lc $title;
    return "[[$title|$text]]";
  } else {
    return $url if $url eq $text;
    return "[$text $url]";
  }
}

sub _image {
  my( $self, $node, $rules ) = @_;
  my $src = $node->attr('src') || '';
  return '' unless $src;

  my $w = $node->attr('width') || 0;
  my $h = $node->attr('height') || 0;
  if( $w and $h ) {
    $src .= "?${w}x${h}";
  } elsif( $w ) {
    $src .= "?${w}";
  }

  my $class = $node->attr('class') || '';
  my $padleft = $class eq 'mediaright' || $class eq 'mediacenter' ? ' ' : '';
  my $padright = $class eq 'medialeft' || $class eq 'mediacenter' ? ' ' : '';
  $src = "$padleft$src$padright";

  # All images considered external
  my $caption = $node->attr('title') || $node->attr('alt') || '';
  return "[$src]" if $caption;
  return "[$src]";
}

sub _td_start {
  my( $self, $node, $rules ) = @_;
  my $prefix = $node->tag eq 'th' ? '|' : '|';
  $prefix .= ' ';

  my $class = $node->attr('class') || '';
  $prefix .= ' ' if $class eq 'rightalign' or $class eq 'centeralign';

  return $prefix;
}

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

  my $end = ' ';

  my $class = $node->attr('class') || '';
  $end .= ' ' if $class eq 'leftalign' or $class eq 'centeralign';

  my $colspan = $node->attr('colspan') || 1;

  my @right_cells = grep { $_->tag && $_->tag =~ /th|td/ } $node->right;
  return $end if $colspan == 1 and @right_cells;

  my $suffix = $node->tag eq 'th' ? '|' : '|';
  $suffix = ( $suffix ) x $colspan;
  return $end.$suffix;
}

=head1 AUTHOR

Eric Forgeot C<<  >>, based on David J. Iberri's work

=head1 BUGS

Please report any bugs or feature requests through the web
interface at
L.



=head1 SUPPORT

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

    perldoc HTML::WikiConverter::Txt2tags

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

Based on the DokuWiki.pm converter. Many thanks to David J. Iberri, C<<  >> for writing HTML::WikiConverter.

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;