https://github.com/bestpractical/html-quoted

https://github.com/bestpractical/html-quoted

Last synced: about 2 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/bestpractical/html-quoted
• Owner: bestpractical
• Created: 2010-02-11T22:19:40.000Z (almost 15 years ago)
• Default Branch: master
• Last Pushed: 2023-07-11T19:46:55.000Z (over 1 year ago)
• Last Synced: 2023-07-11T20:31:56.000Z (over 1 year ago)
• Language: Perl
• Homepage: http://search.cpan.org/dist/HTML-Quoted
• Size: 138 KB
• Stars: 0
• Watchers: 3
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README
  • Changelog: Changes

Awesome Lists containing this project

README

        
NAME

    HTML::Quoted - extract structure of quoted HTML mail message

SYNOPSIS

        use HTML::Quoted;

        my $html = '...';

        my $struct = HTML::Quoted->extract( $html );

DESCRIPTION

    Parses and extracts quotation structure out of a HTML message. Purpose

    and returned structures are very similar to Text::Quoted.

SUPPORTED FORMATS

    Variouse MUAs use quite different approaches for quoting in mails.

    Some use *blockquote* tag and it's quite easy to parse.

    Some wrap text into *p* tags and add '>' in the beginning of the

    paragraphs.

    Things gettign messier when it's an HTML reply on plain text mail

    thread.

    If you found format that is not supported then file a bug report via

    rt.cpan.org with as short as possible example. Test file is even better.

    Test file with patch is the best. Not obviouse patches without tests

    suck.

METHODS

  extract

        my $struct = HTML::Quoted->extract( $html );

    Takes a string with HTML and returns array reference. Each element in

    the array either array or hash. For example:

        [

            { 'raw' => 'Hi,' },

            { 'raw' => '



On date X wrote:
' },

            [

                 { 'raw' => '
' },

                 { 'raw' => 'Hello,' },

                 { 'raw' => '
How are you?
' },

                 { 'raw' => '
' }

            ],

            ...

        ]


    Hashes represent a part of the html. The following keys are meaningful

    at the moment:

    *   raw - raw HTML

    *   quoter_raw, quoter - raw and decoded (entities are converted) quoter

        if block is prefixed with quoting characters

  combine_hunks

      my $html = HTML::Quoted->combine_hunks( $arrayref_of_hunks );

    Takes the output of "extract" and turns it back into HTML.

AUTHOR

    Ruslan.Zakirov 

LICENSE

    Under the same terms as perl itself.