GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  HTML::FORMATTEXT::WITHLINKS::ANDTABLES (3)

.ds Aq ’

NAME

HTML::FormatText::WithLinks::AndTables - Converts HTML to Text with tables intact

CONTENTS

VERSION

version 0.06

SYNOPSIS



    use HTML::FormatText::WithLinks::AndTables;

    my $text = HTML::FormatText::WithLinks::AndTables->convert($html);



Or optionally...



    my $conf = { # same as HTML::FormatText excepting below
        cellpadding   => 2,  # defaults to 1
        no_rowspacing => 1,  # bool, suppress vertical space between table rows
    };

    my $text = HTML::FormatText::WithLinks::AndTables->convert($html, $conf);



DESCRIPTION

This module was inspired by HTML::FormatText::WithLinks which has proven to be a useful ‘lynx -dump‘ work-alike. However one frustration was that no other HTML converters I came across had the ability to deal affectively with HTML <TABLE>s. This module can in a rudimentary sense do so. The aim was to provide facility to take a simple HTML based email template, and to also convert it to text with the <TABLE> structure intact for inclusion as multipart/alternative content. Further, it will preserve both the formatting specified by the <TD> tag’s align attribute, and will also preserve multiline text inside of a <TD> element provided it is broken using <BR/> tags.

    EXPORT

None by default.

METHODS

    convert

EXAMPLE

Given the HTML below ...



    <HTML><BODY>
    <TABLE>
        <TR>
            <TD ALIGN="right">Name:</TD>
            <TD>Mr. Foo Bar</TD>
        </TR>
        <TR>
            <TD ALIGN="right">Address:</TD>
            <TD>
                #1-276 Quux Lane,     <BR/>
                Schenectady, NY, USA, <BR/>
                12345
            </TD>
        </TR>
        <TR>
            <TD ALIGN="right">Email:</TD>
            <TD><a href="mailto:foo@bar.baz">foo@bar.baz</a></TD>
        </TR>
    </TABLE>
    </BODY></HTML>



... the (default) return value of convert() will be as follows.



       Name:  Mr. Foo Bar

    Address:  #1-276 Quux Lane,
              Schenectady, NY, USA,
              12345

      Email:  [1]foo@bar.baz



              1. mailto:foo@bar.baz



SEE ALSO



    HTML::FormatText::WithLinks
    HTML::TreeBuilder



CAVEATS



    * <TH> elements are treated identically to <TD> elements

    * It assumes a fixed width font for display of resulting text.

    * It doesnt work well on nested <TABLE>s or other nested blocks within <TABLE>s.



AUTHOR

Shaun Fryer, <pause.cpan.org at sourcery.ca> (author emeritus)

Dale Evans, <daleevans at cpan.org> (current maintainer)

BUGS

Please report any bugs or feature requests to bug-html-formattext-withlinks-andtables at rt.cpan.org, or through the web interface at <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=HTML-FormatText-WithLinks-AndTables>. I will be notified, and then you’ll automatically be notified of progress on your bug as I make changes.

SUPPORT

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



    perldoc HTML::FormatText::WithLinks::AndTables



You can also look for information at:
o RT: CPAN’s request tracker

<http://rt.cpan.org/NoAuth/Bugs.html?Dist=HTML-FormatText-WithLinks-AndTables>

o AnnoCPAN: Annotated CPAN documentation

<http://annocpan.org/dist/HTML-FormatText-WithLinks-AndTables>

o CPAN Ratings

<http://cpanratings.perl.org/d/HTML-FormatText-WithLinks-AndTables>

o Search CPAN

<http://search.cpan.org/dist/HTML-FormatText-WithLinks-AndTables>

ACKNOWLEDGEMENTS

Everybody. :) <http://en.wikipedia.org/wiki/Standing_on_the_shoulders_of_giants>

COPYRIGHT & LICENSE

Copyright 2008 Shaun Fryer, all rights reserved.

Copyright 2015 Dale Evans, all rights reserved

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

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 HTML::FORMATTEXT::WITHLINKS::ANDTABLES (3) 2015-05-22

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.